seznam/simple-load-script

Very simple promise based script loader and JSONP

simple-load-script

Very simple promise based script loader and JSONP

• Promise based (use polyfill if you need)
• uses addEventListener (IE9+)

Installation

npm install --save simple-load-script

Import

// es5 CommonJS
const loadScript = require('simple-load-script');

// es6
const loadScript = require('simple-load-script/es6/simpleLoadScript');

// es5-umd
const loadScript = require('simple-load-script/es5-umd/simpleLoadScript');

Usage

import loadScript from 'simple-load-script';

loadScript('//code.jquery.com/jquery-2.2.3.js')
  .then(function (scriptRef) {
    console.log('success', scriptRef);
  })
  .catch(function (err) {
    console.log(err);
  });

import loadScript from 'simple-load-script';

try {
  /* const scriptRef = */ loadScript('//code.jquery.com/jquery-2.2.3.js');
} catch (err) {
  console.log(err);
}

import loadScript from 'simple-load-script';

loadScript('//code.jquery.com/jquery-2.2.3.js', {
  inBody: true,
})
  .then(function (scriptRef) {
    console.log('success', scriptRef); // 'success', script ref.
  })
  .catch(function (err) {
    console.log(err);
  });

import loadScript from 'simple-load-script';

loadScript({
  url: '//code.jquery.com/jquery-2.2.3.js',
  attrs: { id: 'one', charset: 'UTF-8' },
})
  .then(function (scriptRef) {
    console.log('success', scriptRef); // 'success', script ref.
  })
  .catch(function (err) {
    console.log(err);
  });

Google Maps API

import loadScript from 'simple-load-script';

loadScript({
  url: '//maps.googleapis.com/maps/api/js?&callback=gmapiready',
  callBackName: 'gmapiready',
})
  .then(function (scriptRef) {
    console.log('success', scriptRef); // 'success', undefined
  })
  .catch(function (err) {
    console.log(err);
  });

JSONP

var loadScript = require('simple-load-script');

loadScripts('//api.ipinfodb.com/v3/ip-city/?format=json&callback=elo', {
  callBackName: 'elo',
  removeScript: true,
})
  .then(function (scriptRef) {
    console.log('success', scriptRef); // 'success', res
  })
  .catch(function (err) {
    console.log(err);
  });

Load more scripts (Promise.all) - urls

import loadScript from 'simple-load-script';

loadScripts(
  '//example.com/test1.js',
  '//example.com/test2.js',
  '//example.com/test3.js',
)
  .then(function (scriptRef) {
    console.log('success', scriptRef); // 'success', res
  })
  .catch(function (err) {
    console.log(err);
  });

Load more scripts (Promise.all) - objects and urls, callBackNames must be unique names

import loadScript from 'simple-load-script';

loadScripts(
  {
    url: '//maps.googleapis.com/maps/api/js?&callback=gmapiready',
    callBackName: 'gmapiready',
  },
  {
    url: '//api.ipinfodb.com/v3/ip-city/?format=json&callback=elo',
    callBackName: 'elo',
    removeScript: true,
  },
  [
    'https://api.twitter.com/1/statuses/oembed.json?id=507185938620219395&callback=elo2',
    { callBackName: 'elo2' },
  ],
  '//code.jquery.com/jquery-2.2.3.js',
)
  .then(function (scriptRef) {
    console.log('success', scriptRef); // 'success', array
  })
  .catch(function (err) {
    console.log(err);
  });

Arguments

• url (optional) - file to append to body
• options (required) - options in object

Options

• url (string) - file to append to body
• inBody (boolean) - append to document.body instead of document.head
• attrs (object) - with attributes to append to script tag (charset, type, id, …)
• callBackName (string) - callback to add to window object; promise is resolved after callback is fired; callback is removed after that; multiple callbacks must have unique names
• dontRemoveCallBack (boolean) - from window after load; no real use - let me know
• removeScript (boolean) - after load (for JSONP, other reasons); it's always removed on error
• insertInto (string) - CSS selector (an ID, class name, element name, etc.) to insert the script into. Overrides inBody value.

Returned values

• then: resource (JSONP - options.callBackName) script reference in DOM or undefined (options.callBackName, options.removeScript)
• catch: error message

Changelog

View on github.