時隔差不多兩個月,積累了許多改進,升級到v22。主要改進點如下:
- 進行瘦身,移除本地儲存
- IE6789的HTML5新標簽支持列表,添加一個 m標簽
- loadJS內容方法,在動態插入script節點,發現最新的firefox Nightly做了些改動,如果head還沒有解析完就插入節點,那么新script會觸發onerror事件。補救措施,針對firefox使用html.insertBefore(node, head)。chrome不支持head.insertBefore(node, null),第二參數必須是節點,因此firefox外瀏覽器統一使用 head.insertBefore(node, head.firstChild)。
- getCurrentScript方法進行增強,現在支持對chrome取正在解析的節點,詳見源碼。如此一來,除safari外,都能立即確認模塊ID與script節點的對應關系。
- 修正parseURL轉"mass.draggable"為url出錯的BUG。
- 升級$.log,讓它支持更古老的opera。
- 升級$.error,對異常進行包裝,防止中文亂碼。
現在詳解一下getCurrentScript引入的新hack,利用e.stack截取正在解析的節點的src,從而得到節點。首先隨便搞個錯誤,比如a.b.c()。在opera12的控制台下,我們通過try catch截獲的輸出如下:
getCurrentScript([arguments not available])@http://113.93.50.63/mass.js:424 <anonymous function: $.define>([arguments not available])@http://113.93.50.63/mass.js:606 @http://113.93.50.63/data.js:4
chrome為:
ReferenceError: a is not defined
at getCurrentScript (http://113.93.50.63/mass.js:403:13)
at window.define.$.define (http://113.93.50.63/mass.js:585:60)
at http://113.93.50.63/data.js:4:1
firefox為
getCurrentScript@http://113.93.50.63/mass.js:403 $.define@http://113.93.50.63/mass.js:585 @http://113.93.50.63/query.js:4
IE10為
ReferenceError: “a”未定義 at getCurrentScript (http://113.93.50.63/mass.js:403:13) at define (http://113.93.50.63/mass.js:585:9) at Global code (http://113.93.50.63/data.js:4:1)
因此,我們只要截取最后一個@或at ,與表示行號的數字前的冒號之間的URL就是正在解析的節點的src了。具體實現看文章最后的源碼。
有關我框架的介紹與用法可參看這里(翻牆,github)
加載器的使用可見v19的介紹,純正的AMD用法,沒有什么不同。
require("ready",function(){
/*待到domReady完成,執行回調*/
$.log("將日志打印到頁面上",true)
})
源碼
!
function(global, DOC) {// by 司徒正美
var $$ = global.$ //保存已有同名變量
var rmakeid = /(#.+|\W)/g; //用於處理掉href中的hash與所有特殊符號,生成長命名空間
var NsKey = DOC.URL.replace(rmakeid, ""); //長命名空間(字符串)
var NsVal = global[NsKey]; //長命名空間(mass對象)
var W3C = DOC.dispatchEvent //IE9開始支持W3C的事件模型與getComputedStyle取樣式值
var html = DOC.documentElement; //HTML元素
var head = DOC.head || DOC.getElementsByTagName("head")[0]; //HEAD元素
var loadings = []; //正在加載中的模塊列表
var parsings = []; //儲存需要綁定ID與factory對應關系的模塊(標准瀏覽器下,先parse的script節點會先onload)
var mass = 1; //當前框架的版本號
var postfix = ""; //用於強制別名
var cbi = 1e5; //用於生成回調函數的名字
var all = "lang_fix,lang,class,interact,data,support,query,support,node_fix,node,attr_fix,attr,css_fix,css,event_fix,event,ajax,fx"
var moduleClass = "mass" + (new Date - 0);
var class2type = {
"[object HTMLDocument]": "Document",
"[object HTMLCollection]": "NodeList",
"[object StaticNodeList]": "NodeList",
"[object IXMLDOMNodeList]": "NodeList",
"[object DOMWindow]": "Window",
"[object global]": "Window",
"null": "Null",
"NaN": "NaN",
"undefined": "Undefined"
}
var toString = class2type.toString,
basepath
/**
* 命名空間
* @namespace 可變的短命名空間
* @param {String|Function} expr CSS表達式或函數
* @param {Node|NodeList|Array|Mass} context ? 上下文對象
* @return {Mass}
*/
function $(expr, context) { //新版本的基石
if($.type(expr, "Function")) { //注意在safari下,typeof nodeList的類型為function,因此必須使用$.type
return $.require(all + ",ready", expr);
} else {
if(!$.fn) $.error("必須加載node模塊");
return new $.fn.init(expr, context);
}
}
//多版本共存
if(typeof NsVal !== "function") {
NsVal = $; //公用命名空間對象
NsVal.uuid = 1;
}
if(NsVal.mass !== mass) {
NsVal[mass] = $; //保存當前版本的命名空間對象到公用命名空間對象上
if(NsVal.mass || ($$ && $$.mass == null)) {
postfix = (mass + "").replace(/\D/g, ""); //是否強制使用多庫共存
}
} else {
return;
}
/**
* 糅雜,為一個對象添加更多成員
* @param {Object} receiver 接受者
* @param {Object} supplier 提供者
* @return {Object} 目標對象
* @api public
*/
var has = Object.prototype.hasOwnProperty
function mix(receiver, supplier) {
var args = Array.apply([], arguments),
i = 1,
key, //如果最后參數是布爾,判定是否覆寫同名屬性
ride = typeof args[args.length - 1] == "boolean" ? args.pop() : true;
if(args.length === 1) { //處理$.mix(hash)的情形
receiver = !this.window ? this : {};
i = 0;
}
while((supplier = args[i++])) {
for(key in supplier) { //允許對象糅雜,用戶保證都是對象
if(has.call(supplier, key) && (ride || !(key in receiver))) {
receiver[key] = supplier[key];
}
}
}
return receiver;
}
//為此版本的命名空間對象添加成員
mix($, {
html: html,
head: head,
mix: mix,
rword: /[^, ]+/g,
rmapper: /(\w+)_(\w+)/g,
mass: mass,
//大家都愛用類庫的名字儲存版本號,我也跟風了
"@bind": W3C ? "addEventListener" : "attachEvent",
/**
* 將內部對象掛到window下,此時可重命名,實現多庫共存
* @param {String} name
* @return {Mass}
* @api public
*/
exports: function(name) {
$$ && (global.$ = $$); //多庫共存
name = name || $.config.nick; //取得當前簡短的命名空間
$.config.nick = name;
global[NsKey] = NsVal;
return global[name] = this;
},
/**
* 數組化
* @param {ArrayLike} nodes 要處理的類數組對象
* @param {Number} start 可選。要抽取的片斷的起始下標。如果是負數,從后面取起
* @param {Number} end 可選。規定從何處結束選取
* @return {Array}
* @api public
*/
slice: W3C ?
function(nodes, start, end) {
return parsings.slice.call(nodes, start, end);
} : function(nodes, start, end) {
var ret = [],
n = nodes.length;
if(end === void 0 || typeof end == "number" && isFinite(end)) {
start = parseInt(start, 10) || 0;
end = end == void 0 ? n : parseInt(end, 10);
if(start < 0) {
start += n;
}
if(end > n) {
end = n;
}
if(end < 0) {
end += n;
}
for(var i = start; i < end; ++i) {
ret[i - start] = nodes[i];
}
}
return ret;
},
/**
* 用於建立一個從元素到數據的關聯,應用於事件綁定,元素去重
* @param {Any} obj
* @return {Number} 一個UUID
*/
getUid: W3C ?
function(obj) { //IE9+,標准瀏覽器
return obj.uniqueNumber || (obj.uniqueNumber = NsVal.uuid++);
} : function(obj) {
if(obj.nodeType !== 1) { //如果是普通對象,文檔對象,window對象
return obj.uniqueNumber || (obj.uniqueNumber = NsVal.uuid++);
} //注:舊式IE的XML元素不能通過el.xxx = yyy 設置自定義屬性
var uid = obj.getAttribute("uniqueNumber");
if(!uid) {
uid = NsVal.uuid++;
obj.setAttribute("uniqueNumber", uid);
}
return +uid; //確保返回數字
},
/**
* 綁定事件(簡化版)
* @param {Node|Document|window} el 觸發者
* @param {String} type 事件類型
* @param {Function} fn 回調
* @param {Boolean} phase ? 是否捕獲,默認false
* @return {Function} fn 剛才綁定的回調
*/
bind: W3C ?
function(el, type, fn, phase) {
el.addEventListener(type, fn, !! phase);
return fn;
} : function(el, type, fn) {
el.attachEvent && el.attachEvent("on" + type, fn);
return fn;
},
/**
* 卸載事件(簡化版)
* @param {Node|Document|window} el 觸發者
* @param {String} type 事件類型
* @param {Function} fn 回調
* @param {Boolean} phase ? 是否捕獲,默認false
*/
unbind: W3C ?
function(el, type, fn, phase) {
el.removeEventListener(type, fn || $.noop, !! phase);
} : function(el, type, fn) {
if(el.detachEvent) {
el.detachEvent("on" + type, fn || $.noop);
}
},
/**
* 用於取得數據的類型(一個參數的情況下)或判定數據的類型(兩個參數的情況下)
* @param {Any} obj 要檢測的東西
* @param {String} str ? 要比較的類型
* @return {String|Boolean}
* @api public
*/
type: function(obj, str) {
var result = class2type[(obj == null || obj !== obj) ? obj : toString.call(obj)] || obj.nodeName || "#";
if(result.charAt(0) === "#") { //兼容舊式瀏覽器與處理個別情況,如window.opera
//利用IE678 window == document為true,document == window竟然為false的神奇特性
if(obj == obj.document && obj.document != obj) {
result = "Window"; //返回構造器名字
} else if(obj.nodeType === 9) {
result = "Document"; //返回構造器名字
} else if(obj.callee) {
result = "Arguments"; //返回構造器名字
} else if(isFinite(obj.length) && obj.item) {
result = "NodeList"; //處理節點集合
} else {
result = toString.call(obj).slice(8, -1);
}
}
if(str) {
return str === result;
}
return result;
},
/**
* 將調試信息打印到控制台或頁面
* $.log(str, page, level )
* @param {Any} str 用於打印的信息,不是字符串將轉換為字符串
* @param {Boolean} page ? 是否打印到頁面
* @param {Number} level ? 通過它來過濾顯示到控制台的日志數量。
* 0為最少,只顯示最致命的錯誤;7,則連普通的調試消息也打印出來。
* 顯示算法為 level <= $.config.level。
* 這個$.config.level默認為9。下面是level各代表的含義。
* 0 EMERGENCY 致命錯誤,框架崩潰
* 1 ALERT 需要立即采取措施進行修復
* 2 CRITICAL 危急錯誤
* 3 ERROR 異常
* 4 WARNING 警告
* 5 NOTICE 通知用戶已經進行到方法
* 6 INFO 更一般化的通知
* 7 DEBUG 調試消息
* @return {String}
* @api public
*/
log: function(str, page, level) {
for(var i = 1, show = true; i < arguments.length; i++) {
level = arguments[i]
if(typeof level == "number") {
show = level <= $.config.level
} else if(level === true) {
page = true;
}
}
if(show) {
if(page === true) {
$.require("ready", function() {
var div = DOC.createElement("pre");
div.className = "mass_sys_log";
div.innerHTML = str + ""; //確保為字符串
DOC.body.appendChild(div);
});
} else if(global.console) {
global.console.log(str);
}
}
return str;
},
/**
* 生成鍵值統一的對象,用於高速化判定
* @param {Array|String} array 如果是字符串,請用","或空格分開
* @param {Number} val ? 默認為1
* @return {Object}
*/
oneObject: function(array, val) {
if(typeof array == "string") {
array = array.match($.rword) || [];
}
var result = {},
value = val !== void 0 ? val : 1;
for(var i = 0, n = array.length; i < n; i++) {
result[array[i]] = value;
}
return result;
},
/**
* 配置框架
* @param {Object} settings 配置對象
* @return {Mass}
*/
config: function(settings) {
var kernel = $.config;
for(var p in settings) {
if(!settings.hasOwnProperty(p)) continue;
var prev = kernel[p];
var curr = settings[p];
if(prev && p === "alias") {
for(var c in curr) {
if(curr.hasOwnProperty(c)) {
var prevValue = prev[c];
var currValue = curr[c];
if(prevValue && prev !== curr) {
$.error(c + "不能重命名");
}
prev[c] = currValue;
}
}
} else {
kernel[p] = curr;
}
}
return this
},
//一個空函數
noop: function() {},
/**
* 拋出錯誤,方便調試
* @param {String} str
* @param {Error} e ? 具體的錯誤對象構造器
* EvalError: 錯誤發生在eval()中
* SyntaxError: 語法錯誤,錯誤發生在eval()中,因為其它點發生SyntaxError會無法通過解釋器
* RangeError: 數值超出范圍
* ReferenceError: 引用不可用
* TypeError: 變量類型不是預期的
* URIError: 錯誤發生在encodeURI()或decodeURI()中
*/
error: function(str, e) {
throw new(e || Error)(str);
}
});
(function(scripts) {
var cur = scripts[scripts.length - 1],
url = (cur.hasAttribute ? cur.src : cur.getAttribute("src", 4)).replace(/[?#].*/, ""),
kernel = $.config;
basepath = kernel.base = url.substr(0, url.lastIndexOf("/")) + "/";
kernel.nick = cur.getAttribute("nick") || "$";
kernel.alias = {};
kernel.level = 9;
})(DOC.getElementsByTagName("script"));
"Boolean,Number,String,Function,Array,Date,RegExp,Window,Document,Arguments,NodeList,Error".replace($.rword, function(name) {
class2type["[object " + name + "]"] = name;
});
/**
* 將模塊標識轉換為URL
* @param {String} url 模塊標識
* @param {String} parent 父路徑
* @return {Array} ret [url, type]
* @api private
*/
function parseURL(url, parent, ret) {
//[]里面,不是開頭的-要轉義,因此要用/^[-a-z0-9_$]{2,}$/i而不是/^[a-z0-9_-$]{2,}
//別名至少兩個字符;不用漢字是避開字符集的問題
if(/^(mass|ready)$/.test(url)) { //特別處理ready標識符
return [url, "js"];
}
if(/^[-a-z0-9_$]{2,}$/i.test(url) && $.config.alias[url]) {
ret = $.config.alias[url];
} else {
parent = parent.substr(0, parent.lastIndexOf('/'))
if(/^(\w+)(\d)?:.*/.test(url)) { //如果用戶路徑包含協議
ret = url
} else {
var tmp = url.charAt(0);
if(tmp !== "." && tmp != "/") { //相對於根路徑
ret = basepath + url;
} else if(url.slice(0, 2) == "./") { //相對於兄弟路徑
ret = parent + url.substr(1);
} else if(url.slice(0, 2) == "..") { //相對於父路徑
var arr = parent.replace(/\/$/, "").split("/");
tmp = url.replace(/\.\.\//g, function() {
arr.pop();
return "";
});
ret = arr.join("/") + "/" + tmp;
} else if(tmp == "/") {
ret = parent + url
} else {
$.error("不符合模塊標識規則: " + url);
}
}
}
var ext = "js";
tmp = ret.replace(/[?#].*/, "");
if(/\.(css|js)$/.test(tmp)) { // 處理"http://113.93.55.202/mass.draggable"的情況
ext = RegExp.$1;
}
if(ext != "css" && tmp == ret && !/\.js$/.test(ret)) { //如果沒有后綴名會補上.js
ret += ".js";
}
return [ret, ext];
}
//============================加載系統===========================
var modules = $.modules = {
ready: {
exports: $
},
mass: {
state: 2,
exports: $
}
};
function getCurrentScript() {
//取得正在解析的script節點
if(DOC.currentScript) { //firefox 4+
return DOC.currentScript.src;
}
// 參考 https://github.com/samyk/jiagra/blob/master/jiagra.js
var stack, e, i, node;
try {
a.b.c(); //強制報錯,以便捕獲e.stack
} catch(e) {//safari的錯誤對象只有line,sourceId,sourceURL
stack = e.stack;
if(!stack && window.opera){
//opera 9沒有e.stack,但有e.Backtrace,但不能直接取得,需要對e對象轉字符串進行抽取
stack = (String(e).match(/of linked script \S+/g) || []).join(" ");
}
}
if(stack) {
stack = stack.split( /[@ ]/g).pop();//取得最后一行,最后一個空格或@之后的部分
stack = stack[0] == "(" ? stack.slice(1,-1) : stack;
return stack.replace(/(:\d+)?:\d+$/i, "");//去掉行號與或許存在的出錯字符起始位置
}
var nodes = head.getElementsByTagName("script"); //只在head標簽中尋找
for(i = 0; node = nodes[i++];) {
if(node.className == moduleClass && node.readyState === "interactive") {
return node.className = node.src;
}
}
}
function checkCycle(deps, nick) {
//檢測是否存在循環依賴
for(var id in deps) {
if(deps[id] == "司徒正美" && modules[id].state != 2 && (id == nick || checkCycle(modules[id].deps, nick))) {
return true;
}
}
}
function checkDeps() {
//檢測此JS模塊的依賴是否都已安裝完畢,是則安裝自身
loop: for(var i = loadings.length, id; id = loadings[--i];) {
var obj = modules[id],
deps = obj.deps;
for(var key in deps) {
if(deps.hasOwnProperty(key) && modules[key].state != 2) {
continue loop;
}
}
//如果deps是空對象或者其依賴的模塊的狀態都是2
if(obj.state != 2) {
loadings.splice(i, 1); //必須先移除再安裝,防止在IE下DOM樹建完后手動刷新頁面,會多次執行它
fireFactory(obj.id, obj.args, obj.factory);
checkDeps();
}
}
}
function checkFail(node, error) {
//檢測是否死鏈
var id = node.src;
node.onload = node.onreadystatechange = node.onerror = null;
if(error || !modules[id].state) {
setTimeout(function() {
head.removeChild(node);
});
$.log("加載 " + id + " 失敗" + error + " " + (!modules[id].state), 7);
} else {
return true;
}
}
function loadJS(url) {
//通過script節點加載目標模塊
var node = DOC.createElement("script");
node.className = moduleClass; //讓getCurrentScript只處理類名為moduleClass的script節點
node[W3C ? "onload" : "onreadystatechange"] = function() {
if(W3C || /loaded|complete/i.test(node.readyState)) {
//mass Framework會在_checkFail把它上面的回調清掉,盡可能釋放回存,盡管DOM0事件寫法在IE6下GC無望
var factory = parsings.pop();
factory && factory.delay(node.src)
if(checkFail(node)) {
$.log("已成功加載 " + node.src, 7);
}
}
}
node.onerror = function() {
checkFail(node, true)
}
node.src = url; //插入到head的第一個節點前,防止IE6下head標簽沒閉合前使用appendChild拋錯
if(window.netscape) { //這也避開了IE6下的自閉合base標簽引起的BUG
html.insertBefore(node, head); //在最新的firefox下,如果父節點還沒有完成不能插入新節點
} else {
head.insertBefore(node, head.firstChild); //chrome下第二個參數不能為null
}
$.log("正准備加載 " + node.src, 7) //更重要的是IE6下可以收窄getCurrentScript的尋找范圍
}
function loadCSS(url) {
//通過link節點加載模塊需要的CSS文件
var id = url.replace(rmakeid, "");
if(!DOC.getElementById(id)) {
var node = DOC.createElement("link");
node.rel = "stylesheet";
node.href = url;
node.id = id;
head.insertBefore(node, head.firstChild);
}
}
/**
* 請求模塊
* @param {String|Array} list 依賴列表
* @param {Function} factory 模塊工廠
* @param {String} parent ? 父路徑,沒有使用種子模塊的根路徑或配置項
* @api public
*/
window.require = $.require = function(list, factory, parent) {
// 用於檢測它的依賴是否都為2
var deps = {},
// 用於依賴列表中的模塊的返回值
args = [],
// 需要安裝的模塊數
dn = 0,
// 已安裝完的模塊數
cn = 0,
id = parent || "cb" + (cbi++).toString(32);
parent = parent || basepath
String(list).replace($.rword, function(el) {
var array = parseURL(el, parent),
url = array[0];
if(array[1] == "js") {
dn++;
if(!modules[url]) {
modules[url] = {
id: url,
parent: parent,
exports: {}
};
loadJS(url);
} else if(modules[url].state === 2) {
cn++;
}
if(!deps[url]) {
args.push(url);
deps[url] = "司徒正美"; //去重
}
} else if(array[1] === "css") {
loadCSS(url);
}
});
//創建或更新模塊的狀態
modules[id] = {
id: id,
factory: factory,
deps: deps,
args: args,
state: 1
}
if(dn === cn) { //如果需要安裝的等於已安裝好的
fireFactory(id, args, factory); //裝配到框架中
return checkDeps();
}
//在正常情況下模塊只能通過_checkDeps執行
loadings.unshift(id);
}
/**
* 請求模塊
* @param {String} id ? 模塊ID
* @param {Array} deps ? 依賴列表
* @param {Function} factory 模塊工廠
* @api public
*/
window.define = $.define = function(id, deps, factory) { //模塊名,依賴列表,模塊本身
var args = $.slice(arguments);
if(typeof id == "string") {
var _id = args.shift();
}
if(typeof args[0] === "boolean") { //用於文件合並, 在標准瀏覽器中跳過補丁模塊
if(args[0]) {
return;
}
args.shift();
}
if(typeof args[0] == "function") {
args.unshift([]);
} //上線合並后能直接得到模塊ID,否則尋找當前正在解析中的script節點的src作為模塊ID
//但getCurrentScript方法只對IE6-10,FF4+有效,其他使用onload+delay閉包組合
id = modules[id] && modules[id].state == 2 ? _id : getCurrentScript();
factory = args[1];
factory.id = _id; //用於調試
factory.delay = function(id) {
args.push(id);
if(checkCycle(modules[id].deps, id)) {
$.error(id + "模塊與之前的某些模塊存在循環依賴");
}
delete factory.delay; //釋放內存
require.apply(null, args); //0,1,2 --> 1,2,0
}
if(id) {
factory.delay(id, args);
} else { //先進先出
parsings.push(factory);
}
}
$.require.amd = modules;
/**
* 請求模塊從modules對象取得依賴列表中的各模塊的返回值,執行factory, 完成模塊的安裝
* @param {String} id 模塊ID
* @param {Array} deps 依賴列表
* @param {Function} factory 模塊工廠
* @api private
*/
function fireFactory(id, deps, factory) {
for(var i = 0, array = [], d; d = deps[i++];) {
array.push(modules[d].exports);
}
var module = Object(modules[id]),
ret = factory.apply(global, array);
module.state = 2;
if(ret !== void 0) {
modules[id].exports = ret;
}
return ret;
}
all.replace($.rword, function(a) {
$.config.alias["$" + a] = basepath + a + ".js";
});
//============================domReady機制===========================
var readyFn, ready = W3C ? "DOMContentLoaded" : "readystatechange";
function fireReady() {
modules.ready.state = 2;
checkDeps();
if(readyFn) {
$.unbind(DOC, ready, readyFn);
}
fireReady = $.noop; //隋性函數,防止IE9二次調用_checkDeps
}
function doScrollCheck() {
try { //IE下通過doScrollCheck檢測DOM樹是否建完
html.doScroll("left");
fireReady();
} catch(e) {
setTimeout(doScrollCheck);
}
};
//在firefox3.6之前,不存在readyState屬性
//http://www.cnblogs.com/rubylouvre/archive/2012/12/18/2822912.html
if(DOC.readyState == null) {
var readyState = DOC.readyState = "loading";
}
if(DOC.readyState === "complete") {
fireReady(); //如果在domReady之外加載
} else {
$.bind(DOC, ready, readyFn = function() {
if(W3C || DOC.readyState === "complete") {
fireReady();
if(readyState) { //IE下不能改寫DOC.readyState
DOC.readyState = "complete";
}
}
});
if(html.doScroll && self.eval === parent.eval) doScrollCheck();
}
//============================HTML5新標簽支持===========================
//IE6789必須以硬編碼形式把mass.js寫在頁面才生效
global.VBArray && ("abbr,article,aside,audio,bdi,canvas,data,datalist,details,figcaption,figure,footer," + "header,hgroup,m,mark,meter,nav,output,progress,section,summary,time,video").replace($.rword, function(tag) {
DOC.createElement(tag);
});
//============================HTML5無縫刷新頁面支持======================
//https://developer.mozilla.org/en/DOM/window.onpopstate
$.bind(global, "popstate", function() {
NsKey = DOC.URL.replace(rmakeid, "");
$.exports();
});
$.exports($.config.nick + postfix); //防止不同版本的命名空間沖突
//============================合並核心模塊支持===========================
/*combine modules*/
}(self, self.document); //為了方便在VS系列實現智能提示,把這里的this改成self或window
