Webデザイン

【JavaScript】【jQuery】これってエラー?コードが動かない時にまず確認すべきこと3つ【随時更新】

あれ?jsファイルが全然反映されない。
参考書の見本通りに書いてるつもりなんだけど……
なんで?

プログラミングを勉強していると、こんなことありますよね?
私もちょうど昨日、問題にハマってしまい、解決するのに4時間かかりました。(-_-;)

でも、こうした経験のおかげで、コードが思うように動かない時に注目すべき視点をやしなっていくことができました。

今回は、JavaScript(特に、jQuery使用時)で問題にハマった時に、まず最初に確認すべき点3つを順に紹介していきます。

まだまだ勉強中の私なので、もちろんこれが全てではありませんが、
これから話す順番で一つ一つ確認していけば、エラー解決の糸口をつかめるかもしれません。

ぜひご参考下さい!

【結論】この順番で確認しよう

コードが動かない時にまず確認すること
  1. ファイルパスを確認する:正しいファイルを開いてますか?
  2. 入力ミスを疑う:打ち間違え、文法ミス、全角入力、パスが違うetc…ないですか?
  3. 検証ツールを利用する:表示されているエラーについて、ピンポイントで対処していく。

まずは以上3つを、1から順番に確認していきましょう。必ず順番にですよ!

一生懸命あれこれとコードを変更したのに、結局「問題の原因はタイプミスでした~」ってなったら、時間と労力の無駄ですからね。(泣)

「widthが足りないのかな?」
「ここのdivは不要だったかな?」
「関数に問題があるのかな?」

こんなふうに試行錯誤する前に、まずは基本的なところで間違えていないかチェックしていきましょう。
下手にコードをいじくり回すと、余計に問題が複雑化してしまいます!

ファイルパスを確認する

  • そもそも開いているファイルは正しいですか?
  • 別プロジェクトの同名ファイルを開いていませんか?

プログラミングの時に編集するファイルって、同じような名前を付けますよね。
“index”とか“script”とか。

一度に複数のファイルを開いている時なんかは、間違えて別プロジェクトの同名ファイルを見ていたということも十分ありえます。

「どんだけおっちょこちょいなんだよ!」
「そんなミスするわけないじゃん!」

こんなふうに思う方もいるかもしれませんが、一度自分を疑って、まずはファイルパスを確認することから始めましょう。

入力ミスを疑う

【スペルミス】たとえば…
  • クラス名
  • id名
  • 変数名
  • 関数名

【つけ忘れミス】たとえば…
  • のつけ忘れ
  • “”のつけ忘れ
  • ()のつけ忘れ
  • {}のつけ忘れ
  • ;のつけ忘れ

【その他】たとえば…
  • “”‘’ を間違える
  • パスを間違える(【例】〇 image/aaa.jpg ✖ ../image/aaa.jpg) 
  • パスを最後まで書いていない(拡張子を忘れている)
  • 拡張子を間違えている(【例】“.jpeg”なのに“.jpg”と入力)
  • 全角入力している(全角スペースは特に注意して確認!)

※【例】は、あくまで例です!必ず自分のフォルダ階層やファイル拡張子を確認して対応してください。

正しくタイプしていたつもりでも、うっかりタイプミスをしていることがあります。
自動変換で違うクラスやid名を書いていたということもありえますよね。

一度書いたコードを見直すのは面倒な作業ですが、このようなミスをしていないか、落ち着いて確認してみましょう。

【随時更新】検証ツールを利用する

ファイルパスとタイプミスを確認してきましたが、これで解決しない場合は検証ツールを確認しましょう。

この時点で、「検証ツール」って何?と思う方がいるかもしれませんので、まずは検証ツールの開き方からお話していきます。

検証ツールが分かるという方は読み飛ばしてくださいね。

① 検証したいファイル(htmlがおすすめ)をブラウザで開く。

② サイト画面上適当なところで【右クリック】+【検証】をクリック。(【F12】キーを押すだけでも表示できます)

③サイト右側に、コードが沢山書かれた枠が現れる。

 ⇒この枠(↓画像赤枠)が【検証ツール】です!

【エラー】Uncaught ReferenceError: $ is not defined

「.jsファイル(今回は“script.js”)でjQuery関数を実行したいけれど、jQueryを参照できないよ!」という場合に現れるエラーです。

もっと分かりやすく言うと、
jQueryを読み込む前に、jQuery関数を呼んでいる時、このエラーメッセージが現れます。

だから、このエラーが出た時には、以下2点を確認しましょう。

  1. jQueryを正しく読み込めているか?:パスは間違っていないか?、スペルミスは無いか?、拡張子まで入力しているか?
  2. 別のjsファイルよりも、jQueryが先に読み込まれているか?:コードは上の行から順に実行されていきます。だから、ライブラリを先に書かないと、別ファイルがライブラリを参照できず、関数が動きません。

①については分かると思いますが、②については具体的に想像しにくいかもしれませんので、以下、画像も交えて説明しますね。

「jQueryが先に読み込まれていない」というのは、例えば↑画像のような状況です。
js/jquery-2.1.4.min.js“が、”js/script.js”よりも後に読み込まれていますね。

コードは上から順に実行されていきますので、このままだと、
“js/script.js”  “js/jquery-2.1.4.min.js”
の順にファイルが読み込まれていきます。

すると、”js/script.js”でjQuery関数が呼ばれた時、

script.js

え、「jQuery」て何? 知らないんだけど……

という事態になります。
だって“js/script.js”が読み込まれている時、まだ”js/jquery-2.1.4.min.js”は読み込まれていないから

だから、以下のように書き換えて、ファイルを読み込ませる順番を変えてあげましょう。

すると
“js/jquery-2.1.4.min.js” → ”js/script.js”
の順にファイルが読み込まれるので、

“js/script.js”でjQuery関数が呼ばれた時……

script.js

あー、さっき読み込んだライブラリに定義されている関数のことだね!

こんな感じに、先に読み込んだjQueryを見に行って、関数を実行してくれるようになります。

関連記事