1000多個項目中的十大JavaScript錯誤以及如何避免
通過統計數據庫中的1000多個項目，我們發現在 JavaScript 中最常出現的錯誤有10個。下面會向大家介紹這些錯誤發生的原因以及如何防止。
對於這些錯誤發生的次數，我們是通過收集的數據統計得出的。Rollbar 會收集每個項目中的所有錯誤，並總結每個錯誤發生的次數，然後通過各個錯誤的特征進行分組。
下圖是發生次數最多的10大 JavaScript 錯誤：
下面開始深入探討每個錯誤發生的情況，以便確定導致錯誤發生的原因以及如何避免。
1. Uncaught TypeError: Cannot Read Property
這是 JavaScript 開發人員最常遇到的錯誤。當你讀取一個屬性或調用一個未定義對象的方法時，Chrome 中就會報出這樣的錯誤。
導致這個錯誤發生的原因有很多，常見的一種情況是在渲染 UI 組件時，不正確地初始化狀態。我們來看一個真實的應用程序中發生這種情況的例子。
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>
);
}
}
以上代碼有兩個重要方面：
- 一是組件的狀態（例如 this.state），在開始生命周期之前是 undefined 狀態。
- 二是當通過異步的方式獲取數據時，無論是在構造函數中 componentWillMount 中，還是在構造函數中提取 componentDidMount，組件在數據加載之前至少會渲染一次。當檢測首次渲染時，會發現 this.state.items 是未定義的。此時就會出現一個錯誤 -“Uncaught TypeError: Cannot read property ‘map’ of undefined" in the consol”。
解決的方法很簡單：在構造函數中使用合理的默認值進行狀態初始化。
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 (evaluating...)
這是在 Safari 中讀取屬性或調用未定義對象上的方法時發生的錯誤，這與 Chrome 的上述錯誤基本相同，只是 Safari 使用不同的錯誤消息。
3. TypeError: Null Is Not an Object (evaluating...)
這是在 Safari 中讀取屬性或調用空對象上的方法時發生的錯誤。
有趣的是，在 JavaScript 中，null 和 undefined 是兩種不同的類型，這就是為什麽會出現兩個不同的錯誤消息。未定義通常是一個尚未分配的變量，而 null 則表示該值為空。要驗證它們不相等，請使用嚴格的相等運算符：
在實際情況中，導致這種錯誤的原因之一是：在元素加載之前，就嘗試在 JavaScript 中使用 DOM 元素。這是因為 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 錯誤違背跨邊界原則時，就會發生腳本錯誤。例如，如果將 JavaScript 代碼托管在 CDN 上，則任何未被捕獲的錯誤（通過 window.onerror 處理程序發出的錯誤，而不是 try-catch 中捕獲到的錯誤）將僅報告為“腳本錯誤”。這是瀏覽器的一種安全措施，主要用於防止跨域傳遞數據的情況出現。
要獲取真實的錯誤消息，需要執行以下操作：
1. Access-Control-Allow-Origin
將 Access-Control-Allow-Origin 設置為 *， 表示可以從任何域正確訪問資源。* 如有必要，也可以用自己的域名進行替換，例如：
Access-Control-Allow-Origin: www.example.com。
以下是在各種環境中設置的一些示例：
Apache
在 JavaScript 文件夾中，創建一個 .htaccess 文件，並包含以下內容：
Header add Access-Control-Allow-Origin "*"
Nginx
將 add_header 指令添加到提供 JavaScript 文件的 location block 中：
location ~ ^/assets/ {
add_header Access-Control-Allow-Origin *;
}
HAProxy
將以下內容添加到提供 JavaScript 文件的靜態資源配置後端：
rspadd Access-Control-Allow-Origin:\ *
2. 在腳本標簽上設置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 中會發生這樣的錯誤。
這相當於 Chrome 中的 “undefined’ is not a function” 錯誤。對於相同的邏輯錯誤，不同的瀏覽器可能會有不同的錯誤消息。
這是在 IE 的 Web 應用程序中使用 JavaScript 命名空間出現的一個常見問題。出現這種情況的絕大部分原因是IE無法將當前名稱空間內的方法綁定到this關鍵字。例如，如果你有 JS Rollbar 方法的命名空間 isAwesome。通常，如果位於 Rollbar 命名空間內，則可以使用以下語法調用該 isAwesome 方法：
this.isAwesome();
Chrome、Firefox 和 Opera 接受這種語法，IE則不接受。因此，使用 JS 命名空間時最安全的做法是：始終以實際名稱空間作為前綴。
Rollbar.isAwesome();
6. TypeError: ‘undefined’ Is Not a Function
當調用未定義的函數時，Chrome 中就會發生這樣的錯誤。
隨著 JavaScript 編碼技術和設計模式在過去幾年中變得越來越復雜，回調和閉包中的自引用範圍也相應增加，這是造成這種混亂現象的主要來源。
正如下面的示例代碼片段：
function testFunction() {
this.clearLocalStorage();
this.timer = setTimeout(function() {
this.clearBoard(); // what is "this"?
}, 0);
};
執行上面的代碼會導致以下錯誤：“Uncaught TypeError: undefined is not a function。” 發生以上錯誤的原因是，當你調用 setTimeout( ) 時，實際上是在調用 window.setTimeout( )，傳遞給 setTimeout( ) 的匿名函數是在窗口對象的上下文中定義的，而該窗口對象沒有 clearBoard( ) 方法。
符合舊版瀏覽器的解決方案是以變量的方式簡單地將引用保存在 this 中，然後通過閉包繼承。例如：
function testFunction () {
this.clearLocalStorage();
var self = this; // save reference to ‘this‘, while it‘s still this!
this.timer = setTimeout(function(){
self.clearBoard();
}, 0);
};
或者，在較新的瀏覽器中，使用 bind( ) 方法傳遞引用：
function testFunction () {
this.clearLocalStorage();
this.timer = setTimeout(this.reset.bind(this), 0); // bind to ‘this‘
};
function testFunction(){
this.clearBoard(); //back in the context of the right ‘this‘!
};
7. Uncaught RangeError: Maximum Call Stack
這是在很多種情況，Chrome 中發生的錯誤，一種情況是當你調用一個不會終止的遞歸函數時。
如果將值傳遞給超出範圍的函數，也可能會發生這種情況。許多函數只接受特定範圍內的數字輸入值。例如，Number.toExponential( digits ) 與 Number.toFixed( digits) 接受的參數範圍為從0到20，而 Number.toPrecision( digits ) 接受的數字範圍為從1至21。
var a = new Array(4294967295); //OK var b = new Array(-1); //range error var num = 2.555555; document.writeln(num.toExponential(4)); //OK document.writeln(num.toExponential(-2)); //range error! num = 2.9999; document.writeln(num.toFixed(2)); //OK document.writeln(num.toFixed(25)); //range error! num = 2.3456; document.writeln(num.toPrecision(1)); //OK document.writeln(num.toPrecision(22)); //range error!
8. TypeError: Cannot Read Property ‘length’
這是 Chrome 中發生的錯誤，因為讀取了未定義長度屬性的變量。
通常在數組中能夠找到定義的長度，但是如果數組未初始化或變量名在另一個上下文中隱藏，則可能會出現這種錯誤。讓我們用下面的例子來解釋這種錯誤。
var testArray= ["Test"];
function testFunction(testArray) {
for (var i = 0; i < testArray.length; i++) {
console.log(testArray[i]);
}
}
testFunction();
當用參數聲明一個函數時，這些參數會成為本地參數。這意味著即使你有名稱變量 testArray，函數中具有相同名稱的參數仍會被視為本地參數。
有兩種方法可以解決這個問題：
1. 刪除函數聲明語句中的參數：
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();
2. 調用傳遞給我們聲明的數組函數：
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。我們也無法獲取或設置 undefined 的任何屬性。在這種情況下，應用程序將拋出“Uncaught TypeError cannot set property of undefined”。
例如，在 Chrome 瀏覽器中，如果 test 對象不存在，就會出現這種錯誤：
所以就需要在訪問變量之前，對變量進行定義。
10. ReferenceError: Event Is Not Defined
嘗試訪問未定義的變量或當前範圍之外的變量時會引發此錯誤。
如果在使用事件處理系統時遇到此錯誤，請確保使用傳入的事件對象作為參數。IE 這樣的瀏覽器提供了全局變量事件，Chrome 會自動將事件變量附加到處理程序中，Firefox 則不會自動添加事件變量。
document.addEventListener("mousemove", function (event) {
console.log(event);
})
結論
事實證明很多這些 null 或 undefined 的錯誤是普遍存在的。 一個類似於 Typescript 這樣的好的靜態類型檢查系統，當設置為嚴格的編譯選項時，能夠幫助開發者避免這些錯誤。
最後也希望通過本文，可以幫助開發者更好避免或是應對以上的10種錯誤。
原文鏈接：https://dzone.com/articles/top-10-javascript-errors-from-1000-projects-and-ho-1
1000多個項目中的十大JavaScript錯誤以及如何避免