DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない)
要点
赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
表示の種類
| 表示 | 意味 | 扱い |
|---|---|---|
| 赤(Error) | JSのエラー、読み込み失敗、CORS、Mixed Content のブロック | 機能が動かない原因の候補。最初に出たものから見る |
| 黄(Warning) | 非推奨の書き方、Cookieの警告など | 多くは表示・動作に影響しない。気になる動作と関係あるものだけ見る |
| 青・灰(Info / Log) | 開発者が出したメッセージ | 参考 |
右端の「ファイル名:行番号」をクリックすると、どのファイルのどこで起きたか分かる。
よくあるエラー
| エラー | 主な原因 |
|---|---|
Uncaught ReferenceError: $ is not defined / jQuery is not defined | jQuery より先にそれを使うJSが読み込まれた(defer・読み込み順の変更 → CSS・JavaScriptの読み込み最適化(defer/async・レンダリングブロック・不要ファイル・minify・外部スクリプト)) |
Uncaught TypeError: Cannot read properties of null | JSが探す要素がページにない(クラス名・IDの変更、別ページで同じJSが動いている) |
Failed to load resource: 404 | ファイルのURL違い・削除(Network で確認 → DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ)) |
blocked by CORS policy | 別オリジンのAPIの許可がない(CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題)) |
Mixed Content | https ページで http の画像・JS(SSL/HTTPSの基本と「保護されていない通信」・Mixed Contentの直し方(証明書・Let's Encrypt・自動更新・http→https)) |
Refused to ... Content Security Policy | サイトのCSP設定で外部scriptが許可されていない |
| 外部サービスの script のエラー | 広告・チャット・計測タグ・SNS埋め込み。自サイトの機能と関係なければ急がない。関係あれば外部サービス側の障害・仕様変更を確認 |
フォーム・ボタン・イベントが動かないとき
- Console を開いたまま操作し、そのときに出るエラーを見る。
- フォーム送信で別ページに移る場合は、Console の設定で「Preserve log」をONにする(移動するとログが消える)。
- エラーがなければ、クリック自体が届いていない可能性(上に要素が重なっている → リンク・ボタンがクリックできない(見えない要素の重なり・pointer-events・z-index))。
- 送信はされているか Network の Fetch/XHR で確認。
AIにエラーを渡すとき
- エラー文はそのままコピーして渡すと正確(言い換えない)。
- ただし、URLのクエリに含まれるトークン・メールアドレス・注文番号・個人情報が入っていないか確認して伏せる(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。
- 渡し方は AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる)。