這是新浪的同事 xiaoniu 發現的案例。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
</head>
<body>
<div id="02E503E2A1C011CFC85B7B701A0677EC0900000000000001"></div>
<script>
var str = '02E503E2A1C011CFC85B7B701A0677EC0900000000000001';
function bySelector(id) { return document.querySelector('#' + id); }
function byId(id) { return document.getElementById(id); }
alert(bySelector(str));
alert(byId(str));
</script>
</body>
</html>
頁面上有一個 id 為 02E503E2A1C011CFC85B7B701A0677EC0900000000000001 的元素。兩個函式分別用 querySelector 與 getElementById 取得它。
所有支援 querySelector 的瀏覽器中,bySelector 都取不到(拋錯),但 getElementById 可以正常取得。
一開始懷疑是 id 字串太長導致 querySelector 抓不到。真正原因完全不同:querySelector 依 CSS 規範實作,而 CSS 識別符不能以數字開頭。
In CSS, identifiers (including element names, classes, and IDs in selectors) can contain only the characters [a-zA-Z0-9] and ISO 10646 characters U+00A0 and higher, plus the hyphen (-) and the underscore (_); they cannot start with a digit, two hyphens, or a hyphen followed by a digit. Identifiers can also contain escaped characters and any ISO 10646 character as a numeric code. For instance, the identifier "B&W?" may be written as "B\&W\?" or "B\26 W\3F".
因為它們是兩套完全獨立的機制:
getElementById 是 DOM API,它做的是直接查表——在文件的 id 對映表中找完全相符的字串。id 值是什麼字元組合它都不在乎,甚至不要求唯一(會回傳第一個)。querySelector 是 Selectors API,它做的是解析 CSS 選擇器並在 DOM 上執行匹配。 #02E503E2... 這串東西會先被當成 CSS 選擇器解析,而 CSS 的語法中 # 後面必須接合法識別符,以數字開頭直接就是語法錯誤。所以這不是瀏覽器的 bug,是兩者契約不同造成的必然結果。
如果一定要用 querySelector,就跳脫它。CSS 提供了跳脫語法,用反斜線避開數字開頭:
// 方法一:跳脫首字元
document.querySelector('#\30 2E503E2A1C011CFC85B7B701A0677EC0900000000000001');
// 方法二:改用屬性選擇器,完全繞開識別符規則(最推薦)
document.querySelector('[id="02E503E2A1C011CFC85B7B701A0677EC0900000000000001"]');
屬性選擇器的值是字串字面值,不受識別符規則約束,寫法也最不容易出錯。
HTML5 放寬了 id 的規則,允許任何非空字元且不含空白,所以 id="02E5..." 在 HTML 層面是合法的。但這只是HTML 允許,不代表整個生態系都能安全使用它——CSS 選擇器、jQuery 選擇器、querySelector、甚至一些自動化測試工具的定位語法,都會因此出問題。
實務上的結論很明確:id 以字母開頭。若 id 是系統產生的(如本例的 GUID 或序號),加上一個前綴即可,例如 id="row-02E503E2..."。這一行前綴的成本是零,卻能省下無數類似本文的排查時間。
而若只是要按 id 取元素,getElementById 至今仍是最快、最直接、語意最清楚的方式,沒有理由為了統一風格而改用 querySelector。