lazyload-script 😴 · 
Promise based method for adding a script to the page if it has not already been added.
Install
yarn add lazyload-scriptbower install lazyload-scriptWeight In
Imported Weight
When used with require() you'll notice very little weight is added to your bundle.
const lazyLoadScript = ;VanillaJS Weight
| Script | Disk Size | GZIP |
|---|---|---|
lazyload-script.0.0.4.js |
4.82kB |
1.48kB |
lazyload-script.0.0.4.min.js |
1.64kB |
773b |
The UMD module wrapper weighs more than the lazyLoadScript() method itself.
If you want to go rogue, you can load directly from source.
Usage
lazyLoadScript accepts two parameters. The path to the script to load and either an id or configuration object.
The id parameter is optional. It is used to ensure that subsequent requests to load a script with that same id immediately resolve. If you omit the id parameter, the DOM will first be queried for a <script> with the same src attribute, before making a new request by appending a new <script> tag.
lazyLoadScript uses this id to ensure scripts with the same id are only loaded once. This allows web components to request dependencies with lazyLoadScript and rest assured the script will always be ready but only be requested as needed.
lazyLoadScript is packaged as a UMD module so it can be included in several ways.
The UMD pattern typically attempts to offer compatibility with the most popular script loaders of the day (e.g RequireJS amongst others). In many cases it uses AMD as a base, with special-casing added to handle CommonJS compatibility.
— umd
With require()
const lazyLoadScript = ;; With VanillaJS
;Multiple scripts can asynchronously be loaded by passing an Array of lazyLoadScript promises to Promise.all().
Promiseall ;Configuration
lazyLoadScript accepts two parameters. The path to the script to load and either an id or configuration object.
| Option | Default | Description |
|---|---|---|
async |
undefined |
If true adds an async attribute |
defer |
undefined |
If true adds a defer attribute |
integrity |
undefined |
If set adds an integrity attribute |
type |
undefined |
If set adds a type attribute |
text |
undefined |
If set adds an text attribute |
charset |
undefined |
If set adds an charset attribute |
crossorigin |
undefined |
If set adds an crossorigin attribute |
force |
false |
If true forces an asset to be loaded even if another with the same id or href are found |
CDN Fallbacks
Loading common libraries and frameworks from CDNs can be great for leveraging the browser cache, but to keep your experience functional in the event the CDN is reachable, it is recommended to load a local fallback.
For example:
const promises = // try to load React from a CDN, fallback to a local copy // try to load React DOM from a CDN, fallback to a local copy // try to load Redux from a CDN, fallback to a local copy // try to load React Redux from a CDN, fallback to a local copy ; Promiseallpromises;See Also
✅ Getting Started
We're going to use yarn so make sure that is installed.
npm install yarn -gNow clone the repo and run the tests.
git clone -b master git://github.com/jpdevries/lazyload-script.gitcd lazyload-scriptyarnyarn test