Include.js

What's Include.js ?

Include.js is a tiny (800b minified and gziped) Javascript loader. It can load normal javascript files but is more efficient with web modules.

When it's possible, it will use async loading to speed up you page and will ensure the good executions of your script. It support nested dependencies, a useful feature to create clean and flexible javascript application.

Include.js was tested on :

• Chrome √
• Opera √
• Safari √
• IE √ (IE 7+)

How to use

Create a module

To create a module, create a new javascript file and use include() as a wrapper :

include(function(){
  return {
    name : "Mars Curiosity"
  }
})

Naming a module

You can name your module with the first argument of include(). Name are like PHP namespace : Dir/FileName.js -> Dir.FileName

include('App.Planet', function(){
  return {
    name      : "Mars",
    gravity   : 0.376,
    saletties : 2
  }
})

Load dependencies

Modules can use dependencies to work, as an array on second argument of include() :

include('App.Nasa', ['App/Rover.js', 'App.Planet'], function(Rover, Planet){
  return {
    rover   : Rover.name,
    planet  : Planet.name,
    success : true 
  }
});

Already using a script loader ?

If you already use a script loader you can replace it with Include.js without problemes and without rewriting code. define() and require() are supported by Include.js. Let's be light !

Tests

Unit test are made with Jasmine and can be run by launching Tests/SpecRunner.html on any browser.

Licence

Include.js is distributed under the MIT license.