通過統計資料庫中的1000多個項目,我們發現在 JavaScript 中最常出現的錯誤有10個。本文會向大家介紹這些錯誤發生的原因以及如何防止。 ...
通過統計資料庫中的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
轉載請註明出自:葡萄城控制項
相關閱讀:
2017年 JavaScript 框架回顧 -- React生態系統