【譯】10 種 JavaScript 最常見的錯誤

原文：rollbar.com/blog/top-10…
宣告：對原文稍作了修改，便於閱讀

前言

看了數千個專案後，發現了 10 個最常見的 JavaScript 錯誤。我們會告訴你什麼原因導致了這些錯誤，以及如何防止這些錯誤發生。如果你能夠避免落入這些 “陷阱”，你將會成為一個更好的開發者。

JavaScript 常見錯誤 Top 10：

為了便於閱讀，我們將每個錯誤描述都縮短了。接下來，讓我們深入到每一個錯誤，來確定什麼會導致它，以及如何避免建立它。

1、Uncaught TypeError: Cannot read property

如果你是一個 JavaScript 開發人員，可能你看到這個錯誤的次數比你敢承認的要多。當你讀取一個未定義的物件的屬性或呼叫其方法時，這個錯誤會在 Chrome 中出現。 您可以很容易的在 Chrome 開發者控制檯中進行測試。

發生這種情況的原因很多，但常見的一種是在渲染 UI 元件時對於狀態的初始化操作不當。

我們來看一個在真實應用程式中發生的例子：我們選擇 React，但該情況也同樣適用於 Angular、Vue 或任何其他框架。

class Quiz extends Component {
  componentWillMount() {
    axios.get('/thedata').then(res => {
      this.setState({items: res.data});
    });
  }
  render() {
    return (
      <ul>
        {this.state.items.map(item =>
          <li key={item.id}>{item.name}</li>
        )}
      </ul>
    );
  }
}
複製程式碼

兩個重要的流程：

1. 元件的狀態（例如 this.state）開始於 undefined。
2. 當非同步獲取資料時，不管它是在建構函式 componentWillMount 還是 componentDidMount 中獲取的，元件在資料載入之前至少會呈現一次，當 Quiz 第一次呈現時，this.state.items 是 undefined。

這很容易解決。最簡單的方法：在建構函式中初始化 state。

class Quiz extends Component {
  // Added this:
  constructor(props) {
    super(props);
    // Assign state itself, and a default value for items
    this.state = {
      items: []
    };
  }
  componentWillMount() {
    axios.get('/thedata').then(res => {
      this.setState({items: res.data});
    });
  }
  render() {
    return (
      <ul>
        {this.state.items.map(item =>
          <li key={item.id}>{item.name}</li>
        )}
      </ul>
    );
  }
}
複製程式碼

在你的應用程式中的具體程式碼可能是不同的，但我們希望我們已經給你足夠的線索，以解決或避免在你的應用程式中出現的這個問題。如果還沒有，請繼續閱讀，因為我們將在下面覆蓋更多相關錯誤的示例。

2、 TypeError: ‘undefined’ is not an object

這是在 Safari 中讀取屬性或呼叫未定義物件上的方法時發生的錯誤。您可以在 Safari Developer Console 中輕鬆測試。這與第一點中提到的 Chrome 的錯誤基本相同，但 Safari 使用了不同的錯誤訊息提示語。

3、 TypeError: null is not an object

這是在 Safari 中讀取屬性或呼叫空物件上的方法時發生的錯誤。 您可以在 Safari Developer Console 中輕鬆測試。

有趣的是，在 JavaScript 中，null 和 undefined 是並不同，這就是為什麼我們看到的是兩個不同的錯誤資訊。

undefined 通常是一個尚未分配的變數，而 null 表示該值為空。 要驗證它們不相等，請嘗試使用嚴格的相等運算子 ===

在我們工作中，這種錯誤可能發生的一種場景是：如果在載入元素之前嘗試在 JavaScript 中使用元素。 因為 DOM API 對於空白的物件引用返回值為 null。

任何執行和處理 DOM 元素的 JS 程式碼都應該在建立 DOM 元素之後執行。

JS 程式碼按照 HTML 中的規定從上到下進行解釋。 所以，如果 DOM 元素之前有一個標籤，指令碼標籤內的 JS 程式碼將在瀏覽器解析 HTML 頁面時執行。 如果在載入指令碼之前尚未建立 DOM 元素，則會出現此錯誤。

在這個例子中，我們可以通過新增一個事件監聽器來解決這個問題，這個監聽器會在頁面準備好的時候通知我們。 一旦 addEventListener 被觸發，init() 方法就可以使用 DOM 元素。

<script>
  function init() {
    var myButton = document.getElementById("myButton");
    var myTextfield = document.getElementById("myTextfield");
    myButton.onclick = function() {
      var userName = myTextfield.value;
    }
  }
  document.addEventListener('readystatechange', function() {
    if (document.readyState === "complete") {
      init();
    }
  });
</script>
<form>
  <input type="text" id="myTextfield" placeholder="Type your name" />
  <input type="button" id="myButton" value="Go" />
</form>
複製程式碼

4、 (unknown): Script error

當未捕獲的 JavaScript 錯誤（通過 window.onerror 處理程式引發的錯誤，而不是捕獲在 try-catch 中）被瀏覽器的跨域策略限制時，會產生這類的指令碼錯誤。 例如，如果您將您的 JavaScript 程式碼託管在 CDN 上，則任何未被捕獲的錯誤將被報告為“指令碼錯誤” 而不是包含有用的堆疊資訊。這是一種瀏覽器安全措施，旨在防止跨域傳遞資料，否則將不允許進行通訊。

要獲得真正的錯誤訊息，請執行以下操作：

1. 設定 ‘Access-Control-Allow-Origin’ 頭部

將 Access-Control-Allow-Origin 標頭設定為 * 表示可以從任何域正確訪問資源。

在 Nginx 中設定如下：

將 add_header 指令新增到提供 JavaScript 檔案的位置塊中：

location ~ ^/assets/ {
    add_header Access-Control-Allow-Origin *;
}
複製程式碼

2. 在 <script> 中設定 crossorigin="anonymous"

在您的 HTML 程式碼中，對於您設定了 Access-Control-Allow-Origin 的每個指令碼，在 script 標籤上設定 crossorigin =“anonymous”。在指令碼標記中新增 crossorigin 屬性之前，請確保驗證上述 header 正確傳送。

在 Firefox 中，如果存在crossorigin屬性，但Access-Control-Allow-Origin頭不存在，則指令碼將不會執行。

5、 TypeError: Object doesn’t support property

這是您在呼叫未定義的方法時發生在 IE 中的錯誤。 您可以在 IE 開發者控制檯中進行測試。

這相當於 Chrome 中的 “TypeError：”undefined“ is not a function” 錯誤。

是的，對於相同的邏輯錯誤，不同的瀏覽器可能具有不同的錯誤訊息。

對於使用 JavaScript 名稱空間的 Web 應用程式，這是一個 IE 瀏覽器的常見的問題。 在這種情況下，99.9％ 的原因是 IE 無法將當前名稱空間內的方法繫結到 this 關鍵字。

例如：如果你 JS 中有一個名稱空間 Rollbar 以及方法 isAwesome。 通常，如果您在 Rollbar 名稱空間內，則可以使用以下語法呼叫 isAwesome 方法：

this.isAwesome();
複製程式碼

Chrome，Firefox 和 Opera 會欣然接受這個語法。 但是 IE 卻不會。 因此，使用 JS 名稱空間時最安全的選擇是始終以實際名稱空間作為字首。

Rollbar.isAwesome();
複製程式碼

6、 TypeError: ‘undefined’ is not a function

當您呼叫未定義的函式時，這是 Chrome 中產生的錯誤。 您可以在 Chrome 開發人員控制檯和 Mozilla Firefox 開發人員控制檯中進行測試。

function clearBoard(){
  alert("Cleared");
}

document.addEventListener("click", function(){
  this.clearBoard(); // what is “this” ?
});
複製程式碼

執行上面的程式碼會導致以下錯誤：

“Uncaught TypeError：this.clearBoard is not a function”。

原因應該是清楚的，即執行上下文不理解導致的指向錯誤。

7、 Uncaught RangeError

當你呼叫一個不終止的遞迴函式就會發生這種錯誤。您可以在 Chrome 開發者控制檯中進行測試。

此外，如果您將值傳遞給超出範圍的函式，也可能會發生這種情況。

許多函式只接受其輸入值的特定範圍的數字。 例如：

1. toExponential(digits) 和 toFixed(digits) 接受 0 到 100
2. toPrecision(digits) 接受 1 到 100

var num = 2.555555;
console.log(num.toExponential(4));  //OK
console.log(num.toExponential(-2)); //range error!

console.log(num.toFixed(2));   //OK
console.log(num.toFixed(105));  //range error!

console.log(num.toPrecision(1));   //OK
console.log(num.toPrecision(0));  //range error!
複製程式碼

8、 TypeError: Cannot read property ‘length’

這是 Chrome 中發生的錯誤，因為讀取未定義變數的長度屬性。 您可以在 Chrome 開發者控制檯中進行測試。

您通常會在陣列中找到定義的長度，但是如果陣列未初始化或者變數在另一個上下文中，則可能會遇到此錯誤。讓我們用下面的例子來理解這個錯誤。

var testArray = ["Test"];
function testFunction(testArray) {
    for (var i = 0; i < testArray.length; i++) {
        console.log(testArray[i]);
    }
}
testFunction();
複製程式碼

執行以上程式碼會報錯：

Cannot read property 'length' of undefined

有兩種方法可以解決這個問題：

var testArray = ["Test"];
/* Precondition: defined testArray outside of a function */
function testFunction(/* No params */) {
    for (var i = 0; i < testArray.length; i++) {
      console.log(testArray[i]);
    }
}
testFunction();
複製程式碼

或

var testArray = ["Test"];
function testFunction(testArray) {
   for (var i = 0; i < testArray.length; i++) {
      console.log(testArray[i]);
    }
}
testFunction(testArray);
複製程式碼

9、 Uncaught TypeError: Cannot set property

當我們嘗試訪問一個未定義的變數時，它總是返回 undefined，我們不能獲取或設定任何未定義的屬性。 在這種情況下會將丟擲 “Uncaught TypeError: Cannot set property”。

10. ReferenceError: event is not defined

當您嘗試訪問未定義的變數或超出當前作用域的變數時，會引發此錯誤。 您可以在 Chrome 瀏覽器中測試。

如果在使用 event 時遇到此錯誤，請確保使用傳入的事件物件作為引數。像 IE 這樣的舊瀏覽器提供了一個全域性變數事件，但並不是所有瀏覽器都支援。

document.addEventListener("mousemove", function (event) {
  console.log(event);
})
複製程式碼

總結

我們看到上面的 10 個最常見的錯誤，其實所涉及的知識點並不難。當你認真讀過《你不知道的 JavaScript》上卷後，這些錯誤基本就不會再出現了。

歸根結底是對 JavaScript 基礎知識掌握的不紮實。

Vue 相關文章輸出計劃

最近總有朋友問我 Vue 相關的問題，因此接下來我會輸出 10 篇 Vue 相關的文章，希望對大家有一定的幫助。我會保持在 7 到 10 天更新一篇。

1. Vuex 注入 Vue 生命週期的過程（完成）
2. 學習 Vue 原始碼的必要知識儲備（完成）
3. 淺析 Vue 響應式原理（完成）
4. 新老 VNode 進行 patch 的過程
5. 如何開發功能元件並上傳 npm
6. 從這幾個方面優化你的 Vue 專案
7. 從 Vue-Router 設計講前端路由發展
8. 在專案中如何正確的使用 Webpack
9. Vue 服務端渲染
10. Axios 與 Fetch 該如何選擇

建議你關注我的公眾號，第一時間就可以接收最新的文章。

如果你想加群交流，可以掃碼自動拉你入群：