Read more

Unpoly: Loading large libraries on-demand

Henning Koch
April 25, 2018Software engineer at makandra GmbH

When your JavaScript bundle is so massive that you cannot load it all up front, I would recommend to load large libraries from the compilers that need it.

Illustration online protection

Rails Long Term Support

Rails LTS provides security patches for old versions of Ruby on Rails (2.3, 3.2, 4.2 and 5.2)

  • Prevents you from data breaches and liability risks
  • Upgrade at your own pace
  • Works with modern Rubies
Read more Show archive.org snapshot

Compilers are also a good place to track whether the library has been loaded before. Note that including same <script> tag more than once will cause the browser to fetch and execute the script more than once. This can lead to memory leaks or cause duplicate event handlers being registered.

In our work we mostly load all JavaScript up front, since our bundles are small enough. We recently had a case where we had a very large geo map library that we only wanted to load when it is used. The code we used for that looked something like this:

// load_script.js

let scriptsLoaded = {};

function loadScript(url) {

  function createScriptTag(url) {
    let scriptTag = document.createElement("script")
    scriptTag.src = url
    return scriptTag
  }

  let cachedPromise = scriptsLoaded[url]
  if (cachedPromise) {
    return cachedPromise
  } else {
    let promise = new Promise((resolve, reject) => {
      let scriptTag = createScriptTag(url)
      scriptTag.addEventListener('load', resolve)
      scriptTag.addEventListener('error', reject)
      document.body.appendChild(scriptTag)
    })
    scriptsLoaded[url] = promise
    return promise
  }
}

// map.js

up.compiler('.map', function(map) {
  await loadScript('/huge-lib.js')
  HugeLibrary.init(map)
})

Note how the library will only get loaded once even after compiling multiple <div class="map"> elements.

Webpacker

See Webpacker: Loading code on demand for extracting code into a separate file.

In the code above you may delete the loadScript() function and instead use Webpack's import() function:

up.compiler('.map', async function(map) {
  await import('/huge-lib.js')
  HugeLibrary.init(map)
})

Rails asset pipeline

As in newer Rails all assets are precompiled and the path above /huge-lib.js will at least not exist in production. Here is our preferred way to solve this:

1. Copy the large library to your vendor folder e.g. vendor/asset-libs/huge-lib/huge-lib.js

2. Create a new file e.g. app/assets/javascripts/huge-lib.js with the following content:

//= require huge-lib.js

3. Allow this file to be precompiled by adding the following line to your config/application.rb

config.assets.precompile += ['huge-lib.js']

4. Finally change the compiler from e.g. map.js to map.js.erb and use the asset_path helper:

loadScript('<%= asset_path('huge-lib', type: :javascript) %>')
Henning Koch
April 25, 2018Software engineer at makandra GmbH
Posted by Henning Koch to makandra dev (2018-04-25 10:25)