1
0
Fork 0
intro-to-vim/bower_components/headjs/dist/1.0.0/head.load.js

708 lines
22 KiB
JavaScript
Raw Normal View History

///#source 1 1 /src/1.0.0/load.js
/*! head.load - v1.0.3 */
/*
* HeadJS The only script in your <HEAD>
* Author Tero Piirainen (tipiirai)
* Maintainer Robert Hoffmann (itechnology)
* License MIT / http://bit.ly/mit-license
* WebSite http://headjs.com
*/
(function (win, undefined) {
"use strict";
//#region variables
var doc = win.document,
domWaiters = [],
handlers = {}, // user functions waiting for events
assets = {}, // loadable items in various states
isAsync = "async" in doc.createElement("script") || "MozAppearance" in doc.documentElement.style || win.opera,
isDomReady,
/*** public API ***/
headVar = win.head_conf && win.head_conf.head || "head",
api = win[headVar] = (win[headVar] || function () { api.ready.apply(null, arguments); }),
// states
PRELOADING = 1,
PRELOADED = 2,
LOADING = 3,
LOADED = 4;
//#endregion
//#region PRIVATE functions
//#region Helper functions
function noop() {
// does nothing
}
function each(arr, callback) {
if (!arr) {
return;
}
// arguments special type
if (typeof arr === "object") {
arr = [].slice.call(arr);
}
// do the job
for (var i = 0, l = arr.length; i < l; i++) {
callback.call(arr, arr[i], i);
}
}
/* A must read: http://bonsaiden.github.com/JavaScript-Garden
************************************************************/
function is(type, obj) {
var clas = Object.prototype.toString.call(obj).slice(8, -1);
return obj !== undefined && obj !== null && clas === type;
}
function isFunction(item) {
return is("Function", item);
}
function isArray(item) {
return is("Array", item);
}
function toLabel(url) {
///<summary>Converts a url to a file label</summary>
var items = url.split("/"),
name = items[items.length - 1],
i = name.indexOf("?");
return i !== -1 ? name.substring(0, i) : name;
}
// INFO: this look like a "im triggering callbacks all over the place, but only wanna run it one time function" ..should try to make everything work without it if possible
// INFO: Even better. Look into promises/defered's like jQuery is doing
function one(callback) {
///<summary>Execute a callback only once</summary>
callback = callback || noop;
if (callback._done) {
return;
}
callback();
callback._done = 1;
}
//#endregion
function conditional(test, success, failure, callback) {
///<summary>
/// INFO: use cases:
/// head.test(condition, null , "file.NOk" , callback);
/// head.test(condition, "fileOk.js", null , callback);
/// head.test(condition, "fileOk.js", "file.NOk" , callback);
/// head.test(condition, "fileOk.js", ["file.NOk", "file.NOk"], callback);
/// head.test({
/// test : condition,
/// success : [{ label1: "file1Ok.js" }, { label2: "file2Ok.js" }],
/// failure : [{ label1: "file1NOk.js" }, { label2: "file2NOk.js" }],
/// callback: callback
/// );
/// head.test({
/// test : condition,
/// success : ["file1Ok.js" , "file2Ok.js"],
/// failure : ["file1NOk.js", "file2NOk.js"],
/// callback: callback
/// );
///</summary>
var obj = (typeof test === "object") ? test : {
test: test,
success: !!success ? isArray(success) ? success : [success] : false,
failure: !!failure ? isArray(failure) ? failure : [failure] : false,
callback: callback || noop
};
// Test Passed ?
var passed = !!obj.test;
// Do we have a success case
if (passed && !!obj.success) {
obj.success.push(obj.callback);
api.load.apply(null, obj.success);
}
// Do we have a fail case
else if (!passed && !!obj.failure) {
obj.failure.push(obj.callback);
api.load.apply(null, obj.failure);
}
else {
callback();
}
return api;
}
function getAsset(item) {
///<summary>
/// Assets are in the form of
/// {
/// name : label,
/// url : url,
/// state: state
/// }
///</summary>
var asset = {};
if (typeof item === "object") {
for (var label in item) {
if (!!item[label]) {
asset = {
name: label,
url : item[label]
};
}
}
}
else {
asset = {
name: toLabel(item),
url : item
};
}
// is the item already existant
var existing = assets[asset.name];
if (existing && existing.url === asset.url) {
return existing;
}
assets[asset.name] = asset;
return asset;
}
function allLoaded(items) {
items = items || assets;
for (var name in items) {
if (items.hasOwnProperty(name) && items[name].state !== LOADED) {
return false;
}
}
return true;
}
function onPreload(asset) {
asset.state = PRELOADED;
each(asset.onpreload, function (afterPreload) {
afterPreload.call();
});
}
function preLoad(asset, callback) {
if (asset.state === undefined) {
asset.state = PRELOADING;
asset.onpreload = [];
loadAsset({ url: asset.url, type: "cache" }, function () {
onPreload(asset);
});
}
}
function apiLoadHack() {
/// <summary>preload with text/cache hack
///
/// head.load("http://domain.com/file.js","http://domain.com/file.js", callBack)
/// head.load(["http://domain.com/file.js","http://domain.com/file.js"], callBack)
/// head.load({ label1: "http://domain.com/file.js" }, { label2: "http://domain.com/file.js" }, callBack)
/// head.load([{ label1: "http://domain.com/file.js" }, { label2: "http://domain.com/file.js" }], callBack)
/// </summary>
var args = arguments,
callback = args[args.length - 1],
rest = [].slice.call(args, 1),
next = rest[0];
if (!isFunction(callback)) {
callback = null;
}
// if array, repush as args
if (isArray(args[0])) {
args[0].push(callback);
api.load.apply(null, args[0]);
return api;
}
// multiple arguments
if (!!next) {
/* Preload with text/cache hack (not good!)
* http://blog.getify.com/on-script-loaders/
* http://www.nczonline.net/blog/2010/12/21/thoughts-on-script-loaders/
* If caching is not configured correctly on the server, then items could load twice !
*************************************************************************************/
each(rest, function (item) {
// item is not a callback or empty string
if (!isFunction(item) && !!item) {
preLoad(getAsset(item));
}
});
// execute
load(getAsset(args[0]), isFunction(next) ? next : function () {
api.load.apply(null, rest);
});
}
else {
// single item
load(getAsset(args[0]));
}
return api;
}
function apiLoadAsync() {
///<summary>
/// simply load and let browser take care of ordering
///
/// head.load("http://domain.com/file.js","http://domain.com/file.js", callBack)
/// head.load(["http://domain.com/file.js","http://domain.com/file.js"], callBack)
/// head.load({ label1: "http://domain.com/file.js" }, { label2: "http://domain.com/file.js" }, callBack)
/// head.load([{ label1: "http://domain.com/file.js" }, { label2: "http://domain.com/file.js" }], callBack)
///</summary>
var args = arguments,
callback = args[args.length - 1],
items = {};
if (!isFunction(callback)) {
callback = null;
}
// if array, repush as args
if (isArray(args[0])) {
args[0].push(callback);
api.load.apply(null, args[0]);
return api;
}
// JRH 262#issuecomment-26288601
// First populate the items array.
// When allLoaded is called, all items will be populated.
// Issue when lazy loaded, the callback can execute early.
each(args, function (item, i) {
if (item !== callback) {
item = getAsset(item);
items[item.name] = item;
}
});
each(args, function (item, i) {
if (item !== callback) {
item = getAsset(item);
load(item, function () {
if (allLoaded(items)) {
one(callback);
}
});
}
});
return api;
}
function load(asset, callback) {
///<summary>Used with normal loading logic</summary>
callback = callback || noop;
if (asset.state === LOADED) {
callback();
return;
}
// INFO: why would we trigger a ready event when its not really loaded yet ?
if (asset.state === LOADING) {
api.ready(asset.name, callback);
return;
}
if (asset.state === PRELOADING) {
asset.onpreload.push(function () {
load(asset, callback);
});
return;
}
asset.state = LOADING;
loadAsset(asset, function () {
asset.state = LOADED;
callback();
// handlers for this asset
each(handlers[asset.name], function (fn) {
one(fn);
});
// dom is ready & no assets are queued for loading
// INFO: shouldn't we be doing the same test above ?
if (isDomReady && allLoaded()) {
each(handlers.ALL, function (fn) {
one(fn);
});
}
});
}
function getExtension(url) {
url = url || "";
var items = url.split("?")[0].split(".");
return items[items.length-1].toLowerCase();
}
/* Parts inspired from: https://github.com/cujojs/curl
******************************************************/
function loadAsset(asset, callback) {
callback = callback || noop;
function error(event) {
event = event || win.event;
// release event listeners
ele.onload = ele.onreadystatechange = ele.onerror = null;
// do callback
callback();
// need some more detailed error handling here
}
function process(event) {
event = event || win.event;
// IE 7/8 (2 events on 1st load)
// 1) event.type = readystatechange, s.readyState = loading
// 2) event.type = readystatechange, s.readyState = loaded
// IE 7/8 (1 event on reload)
// 1) event.type = readystatechange, s.readyState = complete
// event.type === 'readystatechange' && /loaded|complete/.test(s.readyState)
// IE 9 (3 events on 1st load)
// 1) event.type = readystatechange, s.readyState = loading
// 2) event.type = readystatechange, s.readyState = loaded
// 3) event.type = load , s.readyState = loaded
// IE 9 (2 events on reload)
// 1) event.type = readystatechange, s.readyState = complete
// 2) event.type = load , s.readyState = complete
// event.type === 'load' && /loaded|complete/.test(s.readyState)
// event.type === 'readystatechange' && /loaded|complete/.test(s.readyState)
// IE 10 (3 events on 1st load)
// 1) event.type = readystatechange, s.readyState = loading
// 2) event.type = load , s.readyState = complete
// 3) event.type = readystatechange, s.readyState = loaded
// IE 10 (3 events on reload)
// 1) event.type = readystatechange, s.readyState = loaded
// 2) event.type = load , s.readyState = complete
// 3) event.type = readystatechange, s.readyState = complete
// event.type === 'load' && /loaded|complete/.test(s.readyState)
// event.type === 'readystatechange' && /complete/.test(s.readyState)
// Other Browsers (1 event on 1st load)
// 1) event.type = load, s.readyState = undefined
// Other Browsers (1 event on reload)
// 1) event.type = load, s.readyState = undefined
// event.type == 'load' && s.readyState = undefined
// !doc.documentMode is for IE6/7, IE8+ have documentMode
if (event.type === "load" || (/loaded|complete/.test(ele.readyState) && (!doc.documentMode || doc.documentMode < 9))) {
// remove timeouts
win.clearTimeout(asset.errorTimeout);
win.clearTimeout(asset.cssTimeout);
// release event listeners
ele.onload = ele.onreadystatechange = ele.onerror = null;
// do callback
callback();
}
}
function isCssLoaded() {
// should we test again ? 20 retries = 5secs ..after that, the callback will be triggered by the error handler at 7secs
if (asset.state !== LOADED && asset.cssRetries <= 20) {
// loop through stylesheets
for (var i = 0, l = doc.styleSheets.length; i < l; i++) {
// do we have a match ?
// we need to tests agains ele.href and not asset.url, because a local file will be assigned the full http path on a link element
if (doc.styleSheets[i].href === ele.href) {
process({ "type": "load" });
return;
}
}
// increment & try again
asset.cssRetries++;
asset.cssTimeout = win.setTimeout(isCssLoaded, 250);
}
}
var ele;
var ext = getExtension(asset.url);
if (ext === "css") {
ele = doc.createElement("link");
ele.type = "text/" + (asset.type || "css");
ele.rel = "stylesheet";
ele.href = asset.url;
/* onload supported for CSS on unsupported browsers
* Safari windows 5.1.7, FF < 10
*/
// Set counter to zero
asset.cssRetries = 0;
asset.cssTimeout = win.setTimeout(isCssLoaded, 500);
}
else {
ele = doc.createElement("script");
ele.type = "text/" + (asset.type || "javascript");
ele.src = asset.url;
}
ele.onload = ele.onreadystatechange = process;
ele.onerror = error;
/* Good read, but doesn't give much hope !
* http://blog.getify.com/on-script-loaders/
* http://www.nczonline.net/blog/2010/12/21/thoughts-on-script-loaders/
* https://hacks.mozilla.org/2009/06/defer/
*/
// ASYNC: load in parallel and execute as soon as possible
ele.async = false;
// DEFER: load in parallel but maintain execution order
ele.defer = false;
// timout for asset loading
asset.errorTimeout = win.setTimeout(function () {
error({ type: "timeout" });
}, 7e3);
// use insertBefore to keep IE from throwing Operation Aborted (thx Bryan Forbes!)
var head = doc.head || doc.getElementsByTagName("head")[0];
// but insert at end of head, because otherwise if it is a stylesheet, it will not override values
head.insertBefore(ele, head.lastChild);
}
/* Parts inspired from: https://github.com/jrburke/requirejs
************************************************************/
function init() {
var items = doc.getElementsByTagName("script");
// look for a script with a data-head-init attribute
for (var i = 0, l = items.length; i < l; i++) {
var dataMain = items[i].getAttribute("data-headjs-load");
if (!!dataMain) {
api.load(dataMain);
return;
}
}
}
function ready(key, callback) {
///<summary>
/// INFO: use cases:
/// head.ready(callBack);
/// head.ready(document , callBack);
/// head.ready("file.js", callBack);
/// head.ready("label" , callBack);
/// head.ready(["label1", "label2"], callback);
///</summary>
// DOM ready check: head.ready(document, function() { });
if (key === doc) {
if (isDomReady) {
one(callback);
}
else {
domWaiters.push(callback);
}
return api;
}
// shift arguments
if (isFunction(key)) {
callback = key;
key = "ALL"; // holds all callbacks that where added without labels: ready(callBack)
}
// queue all items from key and return. The callback will be executed if all items from key are already loaded.
if (isArray(key)) {
var items = {};
each(key, function (item) {
items[item] = assets[item];
api.ready(item, function() {
if (allLoaded(items)) {
one(callback);
}
});
});
return api;
}
// make sure arguments are sane
if (typeof key !== "string" || !isFunction(callback)) {
return api;
}
// this can also be called when we trigger events based on filenames & labels
var asset = assets[key];
// item already loaded --> execute and return
if (asset && asset.state === LOADED || key === "ALL" && allLoaded() && isDomReady) {
one(callback);
return api;
}
var arr = handlers[key];
if (!arr) {
arr = handlers[key] = [callback];
}
else {
arr.push(callback);
}
return api;
}
/* Mix of stuff from jQuery & IEContentLoaded
* http://dev.w3.org/html5/spec/the-end.html#the-end
***************************************************/
function domReady() {
// Make sure body exists, at least, in case IE gets a little overzealous (jQuery ticket #5443).
if (!doc.body) {
// let's not get nasty by setting a timeout too small.. (loop mania guaranteed if assets are queued)
win.clearTimeout(api.readyTimeout);
api.readyTimeout = win.setTimeout(domReady, 50);
return;
}
if (!isDomReady) {
isDomReady = true;
init();
each(domWaiters, function (fn) {
one(fn);
});
}
}
function domContentLoaded() {
// W3C
if (doc.addEventListener) {
doc.removeEventListener("DOMContentLoaded", domContentLoaded, false);
domReady();
}
// IE
else if (doc.readyState === "complete") {
// we're here because readyState === "complete" in oldIE
// which is good enough for us to call the dom ready!
doc.detachEvent("onreadystatechange", domContentLoaded);
domReady();
}
}
// Catch cases where ready() is called after the browser event has already occurred.
// we once tried to use readyState "interactive" here, but it caused issues like the one
// discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15
if (doc.readyState === "complete") {
domReady();
}
// W3C
else if (doc.addEventListener) {
doc.addEventListener("DOMContentLoaded", domContentLoaded, false);
// A fallback to window.onload, that will always work
win.addEventListener("load", domReady, false);
}
// IE
else {
// Ensure firing before onload, maybe late but safe also for iframes
doc.attachEvent("onreadystatechange", domContentLoaded);
// A fallback to window.onload, that will always work
win.attachEvent("onload", domReady);
// If IE and not a frame
// continually check to see if the document is ready
var top = false;
try {
top = !win.frameElement && doc.documentElement;
} catch (e) { }
if (top && top.doScroll) {
(function doScrollCheck() {
if (!isDomReady) {
try {
// Use the trick by Diego Perini
// http://javascript.nwbox.com/IEContentLoaded/
top.doScroll("left");
} catch (error) {
// let's not get nasty by setting a timeout too small.. (loop mania guaranteed if assets are queued)
win.clearTimeout(api.readyTimeout);
api.readyTimeout = win.setTimeout(doScrollCheck, 50);
return;
}
// and execute any waiting functions
domReady();
}
}());
}
}
//#endregion
//#region Public Exports
// INFO: determine which method to use for loading
api.load = api.js = isAsync ? apiLoadAsync : apiLoadHack;
api.test = conditional;
api.ready = ready;
//#endregion
//#region INIT
// perform this when DOM is ready
api.ready(doc, function () {
if (allLoaded()) {
each(handlers.ALL, function (callback) {
one(callback);
});
}
if (api.feature) {
api.feature("domloaded", true);
}
});
//#endregion
}(window));