You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

59 lines
1.5 KiB

# load-script
Dynamic script loading.
## Installation
via component
```
$ component install eldargab/load-script
```
via npm
```
$ npm install load-script
```
## API
`load-script` appends a `script` node to the `<head>` element in the dom.
`require('load-script')` returns a function of the following interface: `function(url[, opts][, cb]) {}`
### url
Any url that you would like to load. May be absolute or relative.
### [, opts]
A map of options. Here are the currently supported options:
* `async` - A boolean value used for `script.async`. By default this is `true`.
* `attrs` - A map of attributes to set on the `script` node before appending it to the DOM. By default this is empty.
* `charset` - A string value used for `script.charset`. By default this is `utf8`.
* `text` - A string of text to append to the `script` node before it is appended to the DOM. By default this is empty.
* `type` - A string used for `script.type`. By default this is `text/javascript`.
### [, cb]
A callback function of the following interface: `function(err, script) {}` where `err` is an error if any occurred and `script` is the `script` node that was appended to the DOM.
## Example Usage
```javascript
var load = require('load-script')
load('foo.js', function (err, script) {
if (err) {
// print useful message
}
else {
console.log(script.src);// Prints 'foo'.js'
// use script
// note that in IE8 and below loading error wouldn't be reported
}
})
```
## License
MIT