steal.loader.import

Use

steal.loader.import is used to dynamically import a module. This is counter to the syntaxes which are statically parsed and dependencies loaded prior to running the code. In the following example we are importing the "lodash" module and assigning it's value to the _ variable in the Promise callback function.

steal.loader.import("lodash").then(function(_) {
  // Use lodash
  _.isString("hello world"); // -> true
});

When to use

Typically you won't need to use steal.loader.import very often in your application. There are two primary cases when you might want to use it:

1. Load a module whose moduleName is determined at runtime. If you need to concat a string in order to determine which module to load, steal.loader.import is a good candidate:

    steal.loader.import("browser-hacks/" + browserId).then(function() {
      // Browser workaround code loaded.
    });
   

2. For use with progressive loading. If you use bundle in your application to determine bundles that will be progressively loaded, you use steal.loader.import to load a particular bundle. For example, if one of your bundles is checkout you would load that dynamically with steal.loader.import("checkout").