出了什麼問題?JavaScript 疑難排解

正在翻譯中。

當你在練習撰寫上一節的"猜數字"遊戲時,你可能會發現它無法運作。不用擔心,本文將會把你從快被拔光的頭髮中拯救出來,並且給你一些小提示,讓你知道怎麼找出及修正 Javascript 的程式運行錯誤。

先備: 基本電腦能力,基本html及css理解以及了解JavaScript是什麼
目標: 獲得開始解決簡單編碼問題的能力及信心

錯誤類型

一般來說,當你的編碼有錯誤時,主要有兩種類型

  • 語法錯誤: 在編碼中有一些拼字錯誤導致程序完全或部分沒有正常運作。在這個狀況下,通常你會獲得一些錯誤訊息。只要對工具熟悉以及了解錯誤訊息的意思,這種錯誤通常很好修正!
  • 邏輯錯誤: 這種錯誤代表程式碼的語法正確,但程式完成的部分不是開發者想做的?,意即程式碼執行成功,但返回錯誤的結果。這種錯誤通常比語法錯誤還要難修正,因為並沒有錯誤訊息讓我們可以很直接地知道程式碼的問題。

好的,但事情並沒有那麼單純——當你越深入,就會發現更多不同的因素。但上述的分類已經足夠應付初期的工程師職涯了。接著,我們將更深入來討論這兩個類型。

一個錯誤範例

讓我們從剛剛的猜數字遊戲開始 — 在這個版本中,我們將故意引入一些錯誤以便從中學習。前往 Github 下載一份 number-game-errors.html (或運行線上版 running live here).

  1. 首先,在編輯器與瀏覽器分別開啟你剛下載檔案。
  2. 試著玩遊戲——你會注意到當你按下按鈕「Submit guess」時,它沒有任何反應!

Note: 你也許是想修復你自己寫的遊戲中的錯誤!這是件好事,但我們還是建議你在學習這篇文章時先使用我們的版本,這樣你才可以學到我們接下來要教的技巧。在這之後再回去修正你自己的遊戲也不遲!

現在,先讓我們來看看開發者主控台有沒有提示我們任何錯誤,然後試著修正他們。你會在接下來的段落中學到如何修正這些錯誤。

修復語法錯誤

在前篇文章中我們讓你在 開發者工具 JavaScript console 中輸入了一些JavaScript 指令(如果你不記得怎麼打開這個東西,點選前面的連結複習一下)。更重要的是,主控台在瀏覽器的 JavaScript引擎讀取到有語法錯誤的 JavaScript 時會提示一些錯誤訊息。現在讓我們來看看:

  1. 切換到你開啟了 number-game-errors.html 的分頁,然後打開你的 JavaScript 主控台。你應該會看到如下的幾行錯誤訊息:
  2. 這是一個非常容易追尋的錯誤,而且瀏覽器還給你了不少有用的資訊來幫助你(這張截圖是 Firefox 的,但其他瀏覽器也會提示相似的錯誤訊息)。從左到右,我們可以看到:
    • 一個紅色的 "X" 代表這是一個錯誤訊息。
    • 一條錯誤訊息提示你什麼東西出錯了:"TypeError: guessSubmit.addeventListener is not a function(TypeError: guessSubmit.addeventListener 並不是一個函式)"
    • 一個 "Learn More" 連結連向一個解釋這個錯誤並包含大量詳細資訊的 MDN 頁面。
    • 出錯的 JavaScript 檔案名稱,連結連向開發者工具的除錯器。點下這個連結,你就能看到出錯的那行程式被高亮顯示出來。
    • 在該 JavaScript 檔案中錯誤的行號,還有錯誤發生在該行第幾個字元。在這個例子中,是第 86 行的第 3 個字元。
  3. 如果我們在編輯器中檢視第 86 行,我們會看到:
    guessSubmit.addeventListener('click', checkGuess);
  4. 主控台提示的錯誤訊息寫著 "guessSubmit.addeventListener is not a function(guessSubmit.addeventListener 並不是一個函式)",所以我們大概是哪裡拼錯字了。如果你並不確定一個函式的正確名稱如何拼寫,打開 MDN 確認看看是個不錯的選擇。最佳做法是在你喜歡的搜尋引擎搜尋 "mdn 關鍵字"。為了節省時間,這裡提供你一個捷徑:addEventListener()
  5. 回來看看這個頁面,我們明顯是把函式名稱給拼錯了!記住,JavaScript 是會區分大小寫的,所以任何些微的拼寫錯誤甚至是大小寫錯誤都會造成錯誤發生。把addeventListener 改成addEventListener 問題就解決了。現在將你的程式碼修正吧。

Note: 看看這個 TypeError: "x" is not a function 連結來了解更多有關這類錯誤的資訊。

語法錯誤:第二回合

  1. 將你的頁面存檔並重整,你現在應該會看到剛剛的錯誤消失了。
  2. 現在試著輸入一個猜測並按下 Submit guess 按鈕,你會發現... 另一個錯誤!
  3. 這次的錯誤是 "TypeError: lowOrHi is null(TypeError: lowOrHi 為 null)",在第 78 行的位置。
    Note: Null 是一個特別的值,代表著「空」、「什麼都沒有」。lowOrHi 被宣告為一個變數,但並沒有被賦予任何有意義的值 — 他既沒有變數型態,也沒有值。
    Note: 這個錯誤並沒有在頁面載入完成後就發生,因為這個錯誤發生在一個函式中(在 checkGuess() { ... } 區塊中)。在之後詳細介紹函式的文章中,你會學到在函式中的程式碼與在函式外的程式碼其實是執行在不同範疇中的。在我們的這個情況裡,有錯誤的程式碼在 checkGuess() 在 86 行被執行前都並沒有執行,也因此錯誤並沒有在頁面一載入就發生。
  4. 看看第 78 行,你會看到:
    lowOrHi.textContent = 'Last guess was too high!';
  5. 這行試著將 lowOrHi 的 textContent 屬性設為一個字串。但是這行沒有執行成功,因為 lowOrHi 並沒有存著它應該要存著的值。讓我們來看看為什麼 — 試試在程式碼中搜尋其他 lowOrHi 有出現的地方。在第 48 行你會看到:
    var lowOrHi = document.querySelector('lowOrHi');
  6. 這行程式碼試著將一個 HTML 元素的參照存起來。讓我們檢查一下在這行程式碼執行後,變數中的值是否為 null。在第 49 行加上:
    console.log(lowOrHi);

    Note: console.log() 是一個非常好用的除錯功能,它能夠將值印出至主控台中。所以這行程式碼會在第 48 行賦值給 lowOrHi 後,將它的值印出至主控台中。

  7. 存檔並重整,你應該會在主控台中看到 console.log() 輸出的結果。在這個時間點,lowOrHi 的值是 null。所以很明顯的,第 48 行一定出了什麼問題。
  8. 讓我們思考一下發生了什麼問題。第 48 行呼叫了 document.querySelector() 方法來透過 CSS 選擇器取得一個 HTML 元素參照。打開我們的網頁看看我們想要取得的段落元素:
    <p class="lowOrHi"></p>
  9. 所以我們需要的是一個開頭是小數點 (.) 的 class 選擇器,但傳進第48 行 querySelector() 方法的選擇器並沒有開頭的小數點。這也許就是問題所在了!試著將第 48 行的 lowOrHi 改成 .lowOrHi
  10. 再次存檔並重整,你的 console.log() 現在應該會輸出我們想要的 <p> 元素了。呼!又修好了另一個錯誤!你現在可以把你的 console.log() 那行移除了,或是你想要留著之後查看 — 取決於你。

Note: 看看這個 TypeError: "x" is (not) "y" 連結來了解更多有關這類錯誤的資訊。

語法錯誤:第三回合

  1. 現在如果你試著再次玩這個遊戲應該會相當順利,直到該讓遊戲結束的時機點才會發生錯誤:無論是猜對還是10次用完。
  2. 此時console提供錯誤訊息跟一開始一樣: "TypeError: resetButton.addeventListener is not a function"! 然而此次錯誤來自第94行。查看第94行後,我們可以輕易發現依舊是屬性大小寫問題,一樣把addeventListener 改成 .addEventListener就沒問題了。

邏輯錯誤

到這邊為止遊戲應該可以進行得很順利,然而玩幾次下來無疑地你會發現「隨機」數字總是0或1,這可不是我們想要的!

  1. 搜尋位於44行的變數randomNumber,其內容是設定遊戲一開始的隨機數字:
    var randomNumber = Math.floor(Math.random()) + 1;
  2. 另一個開始新回合時產生隨機數字的變數則在113行左右:
    randomNumber = Math.floor(Math.random()) + 1;
  3. 為了測試問題是否出在這兩段程式碼,我們需要再次邀請console.log() 好朋友,將之分別放到44、113行的程式碼下一行:
    console.log(randomNumber);
  4. 儲存程式碼並更新頁面,然後再試玩幾次,你會看到randomNumber 在console中總是等於1,這就是問題所在。

修正小錯誤

為了修正這個錯誤,我們得先了解它是怎麼運作的。首先,我們呼叫Math.random()以產生一個介於0到1的隨機小數,例如: 0.5675493843

Math.random()

接著,我們將Math.random() 產生的隨機小數傳進Math.floor(),函式會回傳小於等於所給數字的最大整數,然後為這個整數值加1:

Math.floor(Math.random()) + 1

由於Math.floor是無條件捨去取整數(地板值),所以一個介於0到1的隨機小數永遠只會得到0,幫這個小數加1的話又會永遠只得到1。所以進位前我們先幫隨機小數乘上100 ,如此一來我們就能得到介於0到99的隨機數字了:

Math.floor(Math.random()*100);

別忘了還要加上1,數字範圍才能成功介於1到100:

Math.floor(Math.random()*100) + 1;

試著自己動手更新這兩行程式碼吧,儲存並更新頁面後你應該能看到遊戲如預期般進行!

其他常見錯誤

還有些初學者非常容易忽略的小問題,這小節讓我們來概覽一下:

語法錯誤:語句缺少「 ; 」
(SyntaxError: missing ; before statement)

這個錯誤是指每行程式碼結束時必須加上英文輸入法的分號;(請注意不要打成中文輸入法),分號被遺忘的錯誤有時不太容易發現,此外另舉一例:如果我們改動下方變數checkGuess() 中的程式碼:

var userGuess = Number(guessField.value);

改成

var userGuess === Number(guessField.value);

此時程式碼會回報錯誤,因為瀏覽器會認為你想設定不同的東西;我們需要確保自己沒有誤用、混用指派運算子(=):用於賦予變數值跟嚴格比較運算子(===):用於比較兩個值是否完全相等,並回覆true/false布林值。

Note: 更多細節請參考右方關於缺少分號的語法錯誤文章頁面: SyntaxError: missing ; before statement 。

無論輸入什麼,程序總是顯示「你贏了」

還有另一種混用指派運算子(=)與嚴格比較運算子(===)的狀況,舉例如果我們將變數 checkGuess()中的嚴格比較運算子(===)

if (userGuess === randomNumber) {

改成指派運算子(=)

if (userGuess = randomNumber) {

這個檢查就失效了,程式會永遠回傳 true而勝利並結束遊戲。請小心!

語法錯誤:參數列表後面缺少「)」 
(SyntaxError: missing ) after argument list)

給完函數或方法參數時別忘了放上)右括號(請注意不要打成中文輸入法)。

Note: 更多細節請參考右方關於缺少右括號的語法錯誤文章頁面:SyntaxError: missing ) after argument list 。

語法錯誤:屬性ID後缺少「:」
SyntaxError: missing : after property id

This error usually relates to an incorrectly formed JavaScript object, but in this case we managed to get it by changing

function checkGuess() {

to

function checkGuess( {

This has caused the browser to think that we are trying to pass the contents of the function into the function as an argument. Be careful with those parentheses!

語法錯誤:「}」缺少SyntaxError: missing } after function body

This is easy — it generally means that you've missed one of your curly braces from a function or conditional structure. We got this error by deleting one of the closing curly braces near the bottom of the checkGuess() function.

SyntaxError: expected expression, got 'string' or SyntaxError: unterminated string literal

These errors generally mean that you've missed off a string value's opening or closing quote mark. In the first error above, string would be replaced with the unexpected character(s) that the browser found instead of a quote mark at the start of a string. The second error means that the string has not been ended with a quote mark.

For all of these errors, think about how we tackled the examples we looked at in the walkthrough. When an error arises, look at the line number you are given, go to that line and see if you can spot what's wrong. Bear in mind that the error is not necessarily going to be on that line, and also that the error might not be caused by the exact same problem we cited above!

Note: See our SyntaxError: Unexpected token and SyntaxError: unterminated string literal reference pages for more details about these errors.

小結

So there we have it, the basics of figuring out errors in simple JavaScript programs. It won't always be that simple to work out what's wrong in your code, but at least this will save you a few hours of sleep and allow you to progress a bit faster when things don't turn out right earlier on in your learning journey.

See also

  • There are many other types of errors that aren't listed here; we are compiling a reference that explains what they mean in detail — see the JavaScript error reference.
  • If you come across any errors in your code that you aren't sure how to fix after reading this article, you can get help! Ask on the Learning Area Discourse thread, or in the #mdn IRC channel on Mozilla IRC. Tell us what your error is, and we'll try to help you. A listing of your code would be useful as well.

在這個學習模組中