z-image-preloader

3.0.1 • Public • Published

z-image-preloader

npm version

Creates a promise object which is resolved when all images are loaded.

Note: The module depends on the global Promise object to be available.

Since it's a CommonJS module, you must use a build tool to use it, like Browserify, or webpack.

Example, explanation

const preloader = require("z-image-preloader");
 
// load single image
preloader
    .load("http://some-url/some-image.png")
    .then(img => {
        // done loading
    })
    .catch(e => {
        // failed to load
    });
 
// The `batchLoad` method accepts an array of url strings. (Or a single url.)
// The returned promise will be resolved, when all images are loaded (or failed to load)
preloader
    .batchLoad([
        "http://some-url/some-image.png",
        "http://some-other-url/some-other-image.jpg",
        "non-existent-image"
    ])
    .then((img1, img2, err) => {
        // Do something when preloading is done.
        // The arguments here will contain the loaded image objects created by `document.createElement('img')` and possible Error objects.
        // The above call for example will return with two `HTMLImageElement` and an `Error`.
    });

LICENSE

MIT

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 3.0.1
    5
    • latest

Version History

  • Version
    Downloads (Last 7 Days)
    • Published
  • 3.0.1
    5
  • 3.0.0
    0
  • 2.0.0
    112
  • 1.0.0
    0
  • 0.1.0
    0

Package Sidebar

Install

npm i z-image-preloader

Weekly Downloads

117

Version

3.0.1

License

MIT

Unpacked Size

6.29 kB

Total Files

7

Last publish

Collaborators

  • zeecoder