1000多個專案中的十大JavaScript錯誤以及如何避免

77rou發表於2018-03-05

通過統計資料庫中的1000多個專案,我們發現在 JavaScript 中最常出現的錯誤有10個。下面會向大家介紹這些錯誤發生的原因以及如何防止。

對於這些錯誤發生的次數,我們是通過收集的資料統計得出的。Rollbar 會收集每個專案中的所有錯誤,並總結每個錯誤發生的次數,然後通過各個錯誤的特徵進行分組。

下圖是發生次數最多的10大 JavaScript 錯誤:

139239-20180305112911127-90800111

下面開始深入探討每個錯誤發生的情況,以便確定導致錯誤發生的原因以及如何避免。

1. Uncaught TypeError: Cannot Read Property

這是 JavaScript 開發人員最常遇到的錯誤。當你讀取一個屬性或呼叫一個未定義物件的方法時,Chrome 中就會報出這樣的錯誤。

139239-20180305112936360-1519750950

導致這個錯誤發生的原因有很多,常見的一種情況是在渲染 UI 元件時,不正確地初始化狀態。我們來看一個真實的應用程式中發生這種情況的例子。

以上程式碼有兩個重要方面:

  1. 一是元件的狀態(例如 this.state),在開始生命週期之前是 undefined 狀態。
  2. 二是當通過非同步的方式獲取資料時,無論是在建構函式中 componentWillMount 中,還是在建構函式中提取 componentDidMount,元件在資料載入之前至少會渲染一次。當檢測首次渲染時,會發現 this.state.items 是未定義的。此時就會出現一個錯誤 -“Uncaught TypeError: Cannot read property ‘map’ of undefined” in the consol”。

解決的方法很簡單:在建構函式中使用合理的預設值進行狀態初始化。

2. TypeError: ‘undefined’ Is Not an Object (evaluating…)

這是在 Safari 中讀取屬性或呼叫未定義物件上的方法時發生的錯誤,這與 Chrome 的上述錯誤基本相同,只是 Safari 使用不同的錯誤訊息。

139239-20180305113406063-25512495

3. TypeError: Null Is Not an Object (evaluating…)

這是在 Safari 中讀取屬性或呼叫空物件上的方法時發生的錯誤。

139239-20180305113432275-2133802434

有趣的是,在 JavaScript 中,null 和 undefined 是兩種不同的型別,這就是為什麼會出現兩個不同的錯誤訊息。未定義通常是一個尚未分配的變數,而 null 則表示該值為空。要驗證它們不相等,請使用嚴格的相等運算子:

139239-20180305114800917-2042707250

在實際情況中,導致這種錯誤的原因之一是:在元素載入之前,就嘗試在 JavaScript 中使用 DOM 元素。這是因為 DOM API 對於空白的物件引用返回 null。

任何執行和處理 DOM 元素的 JS 程式碼,都應該在建立 DOM 元素之後執行。JS 程式碼按照 HTML 中的規定自上而下進行解釋。因此,如果在 DOM 元素之前存在標籤,則指令碼標籤內的 JS 程式碼就會在瀏覽器分析 HTML 頁面時執行。如果在載入指令碼之前尚未建立 DOM 元素,就會出現這樣的錯誤。

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

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 檔案,幷包含以下內容:

Nginx

將 add_header 指令新增到提供 JavaScript 檔案的 location block 中:

HAProxy

將以下內容新增到提供 JavaScript 檔案的靜態資源配置後端:

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 中會發生這樣的錯誤。

139239-20180305114934878-2140937551

這相當於 Chrome 中的 “undefined’ is not a function” 錯誤。對於相同的邏輯錯誤,不同的瀏覽器可能會有不同的錯誤訊息。

這是在 IE 的 Web 應用程式中使用 JavaScript 名稱空間出現的一個常見問題。出現這種情況的絕大部分原因是IE無法將當前名稱空間內的方法繫結到this關鍵字。例如,如果你有 JS Rollbar 方法的名稱空間 isAwesome。通常,如果位於 Rollbar 名稱空間內,則可以使用以下語法呼叫該 isAwesome 方法:

Chrome、Firefox 和 Opera 接受這種語法,IE則不接受。因此,使用 JS 名稱空間時最安全的做法是:始終以實際名稱空間作為字首。

6. TypeError: ‘undefined’ Is Not a Function

當呼叫未定義的函式時,Chrome 中就會發生這樣的錯誤。

139239-20180305114121019-1786879068

隨著 JavaScript 編碼技術和設計模式在過去幾年中變得越來越複雜,回撥和閉包中的自引用範圍也相應增加,這是造成這種混亂現象的主要來源。

正如下面的示例程式碼片段:

執行上面的程式碼會導致以下錯誤:“Uncaught TypeError: undefined is not a function。” 發生以上錯誤的原因是,當你呼叫 setTimeout( ) 時,實際上是在呼叫 window.setTimeout( ),傳遞給 setTimeout( ) 的匿名函式是在視窗物件的上下文中定義的,而該視窗物件沒有 clearBoard( ) 方法。

符合舊版瀏覽器的解決方案是以變數的方式簡單地將引用儲存在 this 中,然後通過閉包繼承。例如:

或者,在較新的瀏覽器中,使用 bind( ) 方法傳遞引用:

7. Uncaught RangeError: Maximum Call Stack

這是在很多種情況,Chrome 中發生的錯誤,一種情況是當你呼叫一個不會終止的遞迴函式時。

139239-20180305114223474-350895701

如果將值傳遞給超出範圍的函式,也可能會發生這種情況。許多函式只接受特定範圍內的數字輸入值。例如,Number.toExponential( digits ) 與 Number.toFixed( digits) 接受的引數範圍為從0到20,而 Number.toPrecision( digits ) 接受的數字範圍為從1至21。

8. TypeError: Cannot Read Property ‘length’

這是 Chrome 中發生的錯誤,因為讀取了未定義長度屬性的變數。

139239-20180305114321432-957965417

通常在陣列中能夠找到定義的長度,但是如果陣列未初始化或變數名在另一個上下文中隱藏,則可能會出現這種錯誤。讓我們用下面的例子來解釋這種錯誤。

當用引數宣告一個函式時,這些引數會成為本地引數。這意味著即使你有名稱變數 testArray,函式中具有相同名稱的引數仍會被視為本地引數

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

1. 刪除函式宣告語句中的引數:

2. 呼叫傳遞給我們宣告的陣列函式:

9. Uncaught TypeError: Cannot Set Property

當嘗試訪問未定義的變數時,總會返回 undefined。我們也無法獲取或設定 undefined 的任何屬性。在這種情況下,應用程式將丟擲“Uncaught TypeError cannot set property of undefined”。

例如,在 Chrome 瀏覽器中,如果 test 物件不存在,就會出現這種錯誤:

139239-20180305114515043-527100630

所以就需要在訪問變數之前,對變數進行定義。

10. ReferenceError: Event Is Not Defined

嘗試訪問未定義的變數或當前範圍之外的變數時會引發此錯誤。

139239-20180305114541655-638309720

如果在使用事件處理系統時遇到此錯誤,請確保使用傳入的事件物件作為引數。IE 這樣的瀏覽器提供了全域性變數事件,Chrome 會自動將事件變數附加到處理程式中,Firefox 則不會自動新增事件變數。

結論

事實證明很多這些 null 或 undefined 的錯誤是普遍存在的。 一個類似於 Typescript 這樣的好的靜態型別檢查系統,當設定為嚴格的編譯選項時,能夠幫助開發者避免這些錯誤。

最後也希望通過本文,可以幫助開發者更好避免或是應對以上的10種錯誤。

相關文章