A webpack bundle-loader ripoff with promise interface
Switch branches/tags
Clone or download
Pull request Compare This branch is 2 commits ahead of gaearon:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A fork of promise-loader with needless call to return a promise


Documentation: Using loaders

This is a ripoff of bundle-loader that uses promises instead of callbacks. It only implements so-called lazy bundle-loader mode—that is, require returns a function that, when invoked, returns a promise that resolves to the module.

require: (string) -> Promise<module>

It's up to you to specify your Promise library of choice as a parameter.

// Assuming you use Bluebird
var load = require("then?bluebird!./file.js");

// load is a promise, and is resolved when file.js loaded
load.then(function(file) {


If a promise library is already loaded externally you can specify 'global'.

You can optionally specify a name for your chunk after a comma:

var load = require("then?bluebird,editor!./editor.js");

This can be useful for single-page apps because you can later extract filenames from Webpack-generated stats and pre-load specific bundles if you know user's going to hit them.

The bundle name may include [filename], which will be replaced with the filename, and [name], which omits the extension. This is useful for when you want to configure loaders in Webpack configuration without specifying precise filenames—for example, by a suffix:

  test: /\.i18n\.json$/,
  loader: 'then?global,[name].i18n'