コンソールでエラーを確認する

JavaScriptが動かないときは、開発者ツールのコンソールを見ると、エラーの内容と発生した場所が分かります。

まずこれだけ

コンソールには赤色でエラーが表示されます。メッセージの種類と、右側に出るファイル名と行番号から原因を探します。

コンソールはエラーが表示される場所

JavaScriptは、途中でエラーが起きると、それ以降の処理が実行されないことがあります。しかし、ページの見た目には何も表示されないため、どこで止まったのかは画面からは分かりません。

開発者ツールのコンソールには、JavaScriptのエラーや警告、プログラムから出力したメッセージが表示されます。動作がおかしいときは、まずここを確認します。

簡単にいうと

JavaScriptが動かないときは、コンソールに出ているエラーを最初に確認します。

コンソールを開いて再読み込みする

開発者ツールを開き、コンソールのタブを選びます。要素の画面など別のタブを使っているときにEscキーを押すと、下側にコンソールを重ねて表示できます。

開発者ツールを開く前に起きたエラーは、表示されないことがあります。コンソールを開いた状態でページを再読み込みし、問題の操作をもう一度行うと、エラーを確実に確認できます。

エラーと警告を見分ける

コンソールのメッセージは、重要度によって色分けされています。赤色で表示されるのがエラーで、処理が止まる原因になっているものです。黄色で表示されるのは警告で、すぐに動作が止まるわけではありませんが、注意が必要な内容です。

メッセージが多いときは、コンソール上部の絞り込み機能で、エラーだけを表示させると見やすくなります。

エラーメッセージの読み方

エラーメッセージは、先頭にエラーの種類、その後に内容が書かれています。英語で表示されますが、よく出るものは限られています。

ReferenceError
定義されていない変数や関数を使っている
TypeError
値の種類に合わない使い方をしている。要素が取得できず空の値になっている場合が多い
SyntaxError
かっこや記号の抜けなど、書き方の誤りがある

メッセージの右側には、エラーが起きたファイル名と行番号が表示されます。クリックすると、ソースの画面で該当する行を確認できます。

エラーの原因を絞り込む

要素が取得できないというエラーは、よくあるものの一つです。指定したidやclass名がHTMLと一致していないか、要素が読み込まれる前にJavaScriptが実行されている可能性があります。

定義されていないというエラーでは、変数名や関数名の綴り、大文字と小文字の違いを確認します。必要なファイルが読み込めていない場合は、ファイルの読み込みに失敗したことを示すメッセージも表示されるため、ファイルの場所や名前を見直します。

エラーが複数出ている場合は、一番上のものから確認します。最初のエラーで処理が止まり、その影響で後のエラーが起きていることがあるためです。

console.logで値を確かめる

エラーは出ないのに期待どおりに動かないときは、処理の途中で値を出力して確認します。コードの中に console.log(変数名) と書くと、その時点の値がコンソールに表示されます。

値が想定と違う場所を見つければ、原因の範囲を絞り込めます。確認が終わったら、出力用の記述は削除しておきます。

コンソールの入力欄に式を直接入力して実行し、結果を確かめることもできます。たとえば要素を取得する記述を入力すれば、指定した要素が本当に見つかるかをその場で確認できます。

自分に関係のないメッセージもある

コンソールには、ブラウザの拡張機能や、広告、外部サービスのスクリプトが出したメッセージも表示されます。すべてを直す必要はありません。

ファイル名を見て、自分が書いたコードや、使っているテーマ、プラグインのファイルに関係するものから確認します。

まとめ

JavaScriptが動かないときは、コンソールを開いた状態で再読み込みし、赤色のエラーを確認します。エラーの種類と、ファイル名、行番号から原因の場所を探します。エラーが出ない不具合は、console.logで途中の値を確かめます。