A simple CSS and JS resource loader
JavaScript HTML
Latest commit f7fe8c0 May 26, 2016 @pyrsmk Update homepage


toast 2.1.1

Toast is a tiny resource loader for JS and CSS files.


You can pick the minified library or install it with :

npm install pyrsmk-toast
bower install toast
jam install pyrsmk-toast

Changes from v1

Be careful! The loading state detector has been redesigned and additional loading verification callbacks have been dropped.


There's a big thing to have in mind: resources are loaded asynchronous until a callback is encountered. That said, let's dig in it. The library accept as many parameters as you want of the following types: a string (a resource's URL), an array (a resource's URL and a loading validation callback) or a function (an arbitrary callback).

But some examples are better to understand the whole thing:

// Load one css file for mobiles

// Load several resources for desktops
if(screen.width > 800) {

// Launch a callback when the CSS has been downloaded, and another when scripts have been downloaded too
    function() {
        log('screens.css downloaded');
    function() {
        log('modernizr & classie downloaded');

If you need to ensure that a script is fully loaded before another one (per example if you want to load a jQuery plugin, the plugin will throw an error if jQuery is not loaded yet), just put a callback between them.

    function() {},
    function() {
        // Use jQuery and its plugin

Define resource type explicitly

Toast is guessing your resource type by its extension. But sometimes, like with Google Fonts, there's no extension at the end of the URL. Then we'll need to set the resource type to help toast to load the resource as expected :



Licensed under the MIT license.