DIV CSS 佈局教程網

控制台報 "object is not a function" 的排查記錄
編輯:JavaScript基礎知識     

今天收到回饋,說某個頁面的功能突然不能用。打開控制台,看到一條錯誤:object is not a function。

覺得很奇怪——這塊功能最近完全沒動過,上線時主流瀏覽器也都測過了。但問題既然出現,就得解決。

線索:radio 的 name 與函數名撞了

看程式碼時發現,一個 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 元素有機會在這條鏈上搶走同名識別符。

三點總結

  1. 沒改動的程式碼不代表沒問題。這次的觸發點是別處新增的 form 標籤,改動 A 卻讓 B 壞掉,這類隱性耦合在缺乏測試的 legacy 程式碼裡尤其常見。
  2. 別讓 DOM 的 name/id 與全域函數名重名。把函數命名得更具體(例如 handleTestClick),或改用 document.getElementById 顯式取元素,都能徹底避開這個坑。
  3. 事件不要用內聯屬性寫。改成 addEventListener 綁定,程式碼就跑在自己的作用域裡,不會被 named access 干擾,也更容易維護。

改寫後的版本大致如下:

<input type="radio" name="test" id="test-radio" />

<script>
  function handleTestClick() {
    alert("11");
  }

  document.getElementById("test-radio")
          .addEventListener("click", handleTestClick);
</script>

很多所謂的「瀏覽器相容性問題」,追到最後往往都是程式碼不夠規範造成的。寫的時候多守一點約定,後面就少一次排查。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved