讀 jQuery 原始碼時,jQuery.fn.init 是最容易被繞暈的一段。它其實就是 jQuery 這個「函式」的實作主體,而 $() 之所以無限神奇,關鍵都在這裡如何解析傳入的 selector。
很多人第一次看會疑惑:為什麼 F 和 jQuery.fn.init 要分成兩處?其實兩者指向同一個函式,功能與 jQuery 完全等價,只是 jQuery 把建構函式放在入口、原型設定緊接在後(init 是原型上的初始化方法)。這樣寫整體結構清晰——先入口建構函式,再原型區塊——但第一眼確實不好理解。
init: function (selector, context, rootjQuery) {
var match, elem, ret, doc;
// ...
}
四個區域變數宣告得很精簡,其中 match 是後續所有判斷的核心——它是一個用來「區分參數型別」的暫存陣列。
// Handle HTML strings
if (typeof selector === "string") {
// Are we dealing with HTML string or an ID?
if (selector.charAt(0) === "<" &&
selector.charAt(selector.length - 1) === ">" &&
selector.length >= 3) {
// Assume that strings that start and end with <> are HTML
match = [null, selector, null];
} else {
match = quickExpr.exec(selector);
}
}
這段邏輯先做一個便宜快速的字元檢查:開頭是 <、結尾是 >、長度至少 3,就假設它是 HTML 片段,跳過正則比對,直接把 match 組裝成 [null, selector, null]。
注意原始碼用的字是 "Assume"——這只是假設。像 $('<sdfadfadf>') 這種亂寫的內容也會走進這個分支,後續建立元素時才會出問題。
// A simple way to check for HTML strings or ID strings
// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
quickExpr = /^(?:[^#<]*(<[wW]+>)[^>]*$|#([w-]*)$)/,
第二行註解很重要:為了避免透過 location.hash 發動的 XSS 攻擊,正則特意讓 #id 優先於 <tag> 被匹配。這個判斷對應 jQuery bug tracker 編號 #9521,在官方網站上可以查到完整討論。
這個正則有兩個捕獲組:(<[wW]+>)[^>]* 抓標籤,([w-]*) 抓 id 值。執行結果是一個陣列,第 0 項是整體匹配,後面依序是各組捕獲的內容,最終交給 match。
實測幾種輸入可以看清規律。單標籤 $('<div>') 走的是上面的快速分支:
[null, "<div>", null]
帶屬性的標籤 $('<div id="x">') 也走同一分支,因為它開頭是 <、結尾是 >。
ID 選擇器 $('#div') 則由正則處理:
["#div", undefined, "div", index: 0, input: "#div"]
比較特殊的 $('<div>123')(結尾不是 >,所以進了正則):
["<div>", "<div>", undefined, index: 0, input: "<div>123"]
規律很清楚:標籤值在 index 1,id 值在 index 2。最後這種情況在後續處理時與純標籤沒有差別,因為建立元素時不會去理會標籤後面的文字。
if (match && (match[1] || !context)) {
// ...
} else if (!context || context.jquery) {
// ...
} else {
// ...
}
第一個條件看起來沒提到 id,但結合前面對 match 的分析就通了:如果 match[1](標籤)沒值,那就一定是 id 選擇器的結果,而 id 在文件中是唯一的,不需要上下文——即使寫了上下文,jQuery 也會改走 Sizzle 而不在這裡處理。所以走進第一分支的情況是:
$('<div>')、$('<div>123')$('#div')第一分支內部再細分:
// HANDLE: $(html) -> $(array)
if (match[1]) {
// ...
} else {
// HANDLE: $("#id")
}
context = context instanceof jQuery ? context[0] : context;
doc = (context ? context.ownerDocument || context : document);
// If a single string is passed in and it's a single tag,
// just do a createElement and skip the rest
ret = rsingleTag.exec(selector);
if (ret) {
if (jQuery.isPlainObject(context)) {
selector = [document.createElement(ret[1])];
jQuery.fn.attr.call(selector, context, true);
} else {
selector = [doc.createElement(ret[1])];
}
} else {
ret = jQuery.buildFragment([match[1]], [doc]);
selector = (ret.cacheable ? jQuery.clone(ret.fragment) : ret.fragment).childNodes;
}
return jQuery.merge(this, selector);
開頭先把 context 正規化:若是 jQuery 物件就取下標拿原生節點;接著決定 doc——沒有 context 就用 document,有 context 且有 ownerDocument(代表是 DOM 節點)就用它的 ownerDocument,否則把該物件本身視為 doc。
然後用另一個正則判斷是否為單標籤:
// Match a standalone tag
rsingleTag = /^<(w+)s*/?>(?:</1>)?$/,
匹配到就走最快的路徑——直接 createElement。這裡有個有趣的細節:如果 context 是普通物件,jQuery 會呼叫 jQuery.fn.attr.call(selector, context, true),第三個參數是內部用的旗標。這也解釋了為什麼 $('<img>', { src: "test.jpg", alt: "Test Image" }) 這種寫法能成立——它與對外 API $("img").attr({...}) 共用同一個方法,只是多了一個內部介面。
若不是單標籤(如 $('<div><span>231</span></div>')),原生方法搞不定,就必須交給 jQuery.buildFragment 建立文件片段,再取出 childNodes。
最後 jQuery.merge(this, selector) 把建立好的節點合併進 jQuery 物件,變成 { 0: div, length: 1, ... } 的形式。這裡與其他分支不同,回傳的是 merge 的結果而非 this。
elem = document.getElementById(match[2]);
// Check parentNode to catch when Blackberry 4.6 returns
// nodes that are no longer in the document #6963
if (elem && elem.parentNode) {
// Handle the case where IE and Opera return items
// by name instead of ID
if (elem.id !== match[2]) {
return rootjQuery.find(selector);
}
this.length = 1;
this[0] = elem;
}
this.context = document;
this.selector = selector;
return this;
直接呼叫原生 getElementById,但補了兩層防護。第一層檢查 elem.parentNode:註解提到某些系統(Blackberry 4.6,issue #6963)會回傳已經不在文件中的節點,而已脫離文件的元素自然沒有父節點。第二層檢查 elem.id !== match[2]:IE 與 Opera 在某些情況下會用 name 屬性而非 id 來匹配,若真的遇到這種情況,就放棄原生方法、改用 rootjQuery.find(selector)(也就是走 Sizzle 引擎)。
} else if (!context || context.jquery) {
return (context || rootjQuery).find(selector);
}
沒有上下文,或上下文是 jQuery 物件時,直接呼叫 find。rootjQuery 就是 $(document),作為預設的搜尋根。
return this.constructor(context).find(selector);
剩下的情况(例如傳入了 DOM 節點或非 jQuery 物件作為 context),先用 this.constructor(即 jQuery 本身)把 context 包成 jQuery 物件,再呼叫 find。
這段程式之所以難讀,是因為它把「型別判斷」壓縮進一個 match 陣列,用 index 位置隱含語意,並在每個分支裡針對舊瀏覽器 bug 做補丁。理解它的關鍵順序是:先搞清 match 三種形態的意義,再看三路分支的條件,最後才是各分支內部的細節。掌握之後回頭看 $() 的各種神奇用法,就會發現每一種都有明確的對應路徑。