3.1 基本操作

Console Panel Basics

Consoleパネルは、JavaScriptの実行、ログの確認、エラーのデバッグに使用する。Web開発で最も頻繁に使用するパネルの一つ。

Consoleを開く

方法 説明
Ctrl+Shift+J Consoleパネルを直接開く
F12 → Consoleタブ DevToolsを開いてConsoleに切り替え
Esc 他のパネルの下部にConsole Drawerを表示
Console Drawerの活用 Elementsパネルで要素を選択しながら、EscでConsoleを表示すると、選択要素に対してJavaScriptを実行できる。$0で選択中の要素を参照可能。

JavaScriptの実行

Consoleの入力欄(>マークの横)にJavaScriptを入力し、Enterで実行。現在のページのコンテキストで実行される。

基本的な使い方

// 計算
2 + 3
// → 5

// 変数の定義
let message = 'Hello, World!'
message
// → 'Hello, World!'

// DOMの操作
document.title
// → ページタイトル

document.querySelector('h1').textContent
// → h1要素のテキスト

複数行の入力

Shift+Enterで改行し、複数行のコードを入力できる。

// 関数の定義(Shift+Enterで改行)
function greet(name) {
    return `Hello, ${name}!`;
}

greet('Developer')
// → 'Hello, Developer!'

コマンド履歴

キーで過去に実行したコマンドを呼び出せる。

貼り付けができない場合 セキュリティ対策として、初回のペースト時にブロックされることがある。入力欄に allow pasting と入力してEnterを押すと、貼り付けが許可される。

ログレベル

Consoleに出力されるメッセージは、種類(ログレベル)によって色分けされる。

メソッド レベル 表示 用途
console.log() Info 標準(白/グレー) 一般的なログ出力
console.info() Info 青アイコン 情報メッセージ
console.warn() Warning 黄色背景 警告メッセージ
console.error() Error 赤色背景 エラーメッセージ
console.debug() Verbose グレー(デフォルト非表示) 詳細なデバッグ情報
console.log('通常のログ');
console.info('情報');
console.warn('警告: 非推奨の機能を使用しています');
console.error('エラー: ファイルが見つかりません');

ログレベルでフィルタリング

Console上部のフィルタボタンでログレベルを絞り込める。エラーのみを表示したい場合は「Errors」を選択。

ログのフィルタリング

テキストフィルタ

Console上部のフィルタ入力欄にテキストを入力すると、そのテキストを含むログのみ表示される。

正規表現フィルタ

/pattern/形式で正規表現によるフィルタリングが可能。

// 数字を含むログのみ表示
/\d+/

// "error"または"warning"を含むログ
/error|warning/i

URLフィルタ

特定のソースからのログのみ表示。

// 特定ドメインからのログ
url:example.com

// 特定ファイルからのログ
url:script.js

除外フィルタ

-(マイナス)を前に付けると除外。

// "debug"を含まないログのみ表示
-debug

エラーの読み方

JavaScriptエラーはConsoleに赤色で表示される。エラーメッセージの読み方を理解することがデバッグの第一歩。

エラーの構成要素

Uncaught TypeError: Cannot read properties of null (reading 'textContent')
    at getTitle (script.js:15:23)
    at main (script.js:42:5)
    at script.js:50:1
要素 説明
Uncaught try-catchでキャッチされなかったエラー
TypeError エラーの種類(型エラー)
Cannot read properties of null nullのプロパティを読み取ろうとした
script.js:15:23 ファイル名:行番号:列番号
スタックトレース エラーに至るまでの関数呼び出し順序

よくあるエラータイプ

エラー 原因
ReferenceError 存在しない変数を参照
TypeError 型が不正(null/undefinedのプロパティアクセス等)
SyntaxError 構文エラー(括弧の閉じ忘れ等)
RangeError 値が許容範囲外
NetworkError ネットワーク通信の失敗
ソースへのジャンプ エラーメッセージ右側のファイル名(script.js:15)をクリックすると、Sourcesパネルでエラー発生箇所が開く。

Consoleのクリア

方法 説明
Ctrl+L キーボードショートカット
clear() Console内でコマンド実行
🚫 アイコン Console左上のクリアボタン
右クリック → Clear console コンテキストメニューから

ログの保持設定

Console設定(歯車アイコン)で「Preserve log」にチェックを入れると、ページ遷移やリロードでもログが消えなくなる。複数ページにまたがるデバッグに便利。

実行コンテキスト

ConsoleでのJavaScript実行は、特定のコンテキスト(実行環境)で行われる。

コンテキストの切り替え

Console上部のドロップダウン(通常は「top」と表示)から、実行コンテキストを切り替えられる。

  • top: メインページ
  • iframe名: ページ内のiframe
  • 拡張機能名: Chrome拡張機能のコンテキスト
  • Service Worker: 登録されているService Worker
Chrome拡張機能のデバッグ 拡張機能のContent Scriptのログは、そのページのConsoleに出力される。Service Workerのログは、chrome://extensionsから「Service Worker」リンクをクリックして開くDevToolsで確認する。

Console設定

Console右上の歯車アイコンから設定を変更できる。

設定 説明
Hide network 404等のネットワークエラーを非表示
Preserve log ページ遷移でもログを保持
Selected context only 選択したコンテキストのログのみ表示
Group similar 同じログをグループ化
Log XMLHttpRequests XHRリクエストをログに出力
Eager evaluation 入力中に結果をプレビュー表示
Autocomplete from history 履歴からオートコンプリート
参考文献
[1] Console overview - Chrome DevTools. developer.chrome.com
[2] Log messages in the Console - Chrome DevTools. developer.chrome.com