今天收到回饋,說某個頁面的功能突然不能用。打開控制台,看到一條錯誤:object is not a function。
覺得很奇怪——這塊功能最近完全沒動過,上線時主流瀏覽器也都測過了。但問題既然出現,就得解決。
看程式碼時發現,一個 radio 的 name 屬性和某個函數名重名了:
<body>
<input type="radio" name="test" onclick="test();" />
<br/>
<form action="">
<input type="radio" name="test" onclick="test();" />
</form>
</body>
<script type="text/javascript">
function test() {
alert("11");
}
</script>
把函數改名之後,問題確實消失了。但根因還沒找到——這個函數名沿用已久,之前一直正常。於是把 onclick 改寫成:
onclick="alert(test);"
結果彈出 object HTMLInputElement,也就是說瀏覽器把 test 解析成了 DOM 物件。而在 script 標籤中執行 alert(test),得到的仍然是一個 function。
查了 svn 版本記錄才發現,是我在開發另一個功能時,新增了一個 form 標籤把這個 radio 包了進去,於是瀏覽器的解析結果就變了。
這是 HTML 標準中 named access on the window object 的行為:帶有 name 或 id 屬性的元素,會以其 name/id 作為屬性名掛在全域物件上。當 radio 獨立存在於 body 中時,同名的 radio 元素集合與全域函數之間的解析優先級讓函數勝出;一旦被包進 form,元素的參照路徑改變(變成 form.test 這種 RadioNodeList 的形式),全域解析的結果就倒向元素,於是 test() 變成「呼叫一個物件」,也就拋出了 object is not a function。
換句話說,onclick="test()" 中的 test 是透過「元素屬性 → 表單屬性 → 文件 → 全域物件」這條鏈解析的,而 named access 讓 DOM 元素有機會在這條鏈上搶走同名識別符。
handleTestClick),或改用 document.getElementById 顯式取元素,都能徹底避開這個坑。addEventListener 綁定,程式碼就跑在自己的作用域裡,不會被 named access 干擾,也更容易維護。改寫後的版本大致如下:
<input type="radio" name="test" id="test-radio" />
<script>
function handleTestClick() {
alert("11");
}
document.getElementById("test-radio")
.addEventListener("click", handleTestClick);
</script>
很多所謂的「瀏覽器相容性問題」,追到最後往往都是程式碼不夠規範造成的。寫的時候多守一點約定,後面就少一次排查。