Missed the action at the 2018 Chrome Dev Summit? Catch up with our playlist on the Google Chrome Developers channel on YouTube. Watch now.

コンソール API リファレンス

コンソール API を使用して、コンソールに情報を書き込んだり、JavaScript プロファイルを作成したり、デバッグ セッションを開始したりできます。

console.assert(expression, object)

評価された式が false の場合に、エラーをコンソールに書き込みます。

function greaterThan(a,b) {
  console.assert(a > b, {"message":"a is not greater than b","a":a,"b":b});
}
greaterThan(5,6);

console.assert() の例

console.clear()

コンソールをクリアします。

console.clear();

[Preserve log] チェックボックスがオンの場合、console.clear() は無効になります。 ただし、コンソールがフォーカスされている状態で [clear console] ボタン([clear console] ボタン)を押したり、ショートカット Ctrl+L を入力したりすることはできます。

詳細は、コンソールのクリア をご覧ください。

console.count(label)

count() が同じ行で同じラベルを使用して呼び出された回数を書き込みます。

function login(name) {
  console.count(name + ' logged in');
}

console.count() の例

他の例については、文の実行回数のカウントを参照してください。

console.debug(object [, object, ...])

console.log() と同じです。

console.dir(object)

指定されたオブジェクトの JavaScript 表現を出力します。記録されているオブジェクトが HTML 要素の場合は、次のように、その DOM 表現のプロパティが出力されます。

console.dir(document.body);

klzzwxh:0018 の例

機能的に同じオブジェクト フォーマッタ(%O)などについては、文字列の置換とフォーマット を参照してください。

console.dirxml(object)

可能な場合は object の子孫要素の XML 表現を出力し、不可能な場合は JavaScript 表現を出力します。 HTML 要素や XML 要素に対して console.dirxml() を呼び出すことは、console.log() を呼び出すことと同じです。

console.dirxml(document);

console.dirxml() の例

console.error(object [, object, ...])

console.log() と同様のメッセージを出力したり、メッセージをエラーのようにスタイル設定したり、メソッドが呼び出された場所からのスタックトレースを含めたりします。

console.error('error: name is undefined');

console.error() の例

console.group(object[, object, ...])

オプションのタイトルを指定して新しいロググループを作成します。console.group() の後から console.groupEnd() の前までに行われたすべてのコンソール出力が視覚的にグループ化されます。

function name(obj) {
  console.group('name');
  console.log('first: ', obj.first);
  console.log('middle: ', obj.middle);
  console.log('last: ', obj.last);
  console.groupEnd();
}

name({"first":"Wile","middle":"E","last":"Coyote"});

console.group() の例

グループをネストすることもできます。

function name(obj) {
  console.group('name');
  console.log('first: ', obj.first);
  console.log('middle: ', obj.middle);
  console.log('last: ', obj.last);
  console.groupEnd();
}

function doStuff() {
  console.group('doStuff()');
  name({"first":"Wile","middle":"E","last":"coyote"});
  console.groupEnd();
}

doStuff();

ネストされた console.group() の例

console.groupCollapsed(object[, object, ...])

新しいロググループを作成します。グループは最初、折りたたまれた状態です。

console.groupCollapsed('status');
console.log("peekaboo, you can't see me");
console.groupEnd();

console.groupEnd()

ロググループを閉じます。例については、console.group を参照してください。

console.info(object [, object, ...])

console.log() と同様にメッセージを出力しますが、出力の横にアイコン(青い円に白字の「i」)も表示します。

console.log(object [, object, ...])

コンソールにメッセージを表示します。このメソッドには、1 つ以上のオブジェクトを渡します。各オブジェクトが評価され、スペースで区切られた文字列に連結されます。

console.log('Hello, Logs!');

フォーマット指定子

第一引数に 1 つ以上の フォーマット指定子 を含めることができます。フォーマット指定子は、パーセント記号(%)とその後に続く文字(適用するフォーマットを示す)で構成されます。

関連ガイド:

console.profile([label])

オプションのラベルを指定して JavaScript CPU プロファイルを開始します。プロファイルを完了するには、console.profileEnd() を呼び出します。 各プロファイルは [Profiles] パネルに追加されます。

function processPixels() {
  console.profile("processPixels()");
  // later, after processing pixels
  console.profileEnd();
}

console.profileEnd()

現在の JavaScript CPU プロファイリング セッション(実行中の場合)を停止し、レポートを [Profiles] パネルに出力します。

例については、console.profile() を参照してください。

console.time(label)

ラベルを関連付けて新しいタイマーを開始します。同じラベルを指定して console.timeEnd() を呼び出すと、タイマーは停止し、コンソールに経過時間が表示されます。 タイマー値の精度はミリ秒単位です。time()timeEnd() に渡す文字列は一致している必要があり、一致していない場合、timer は終了しません。

console.time("Array initialize");
var array = new Array(1000000);
for (var i = array.length - 1; i >= 0; i--) {
  array[i] = new Object();
}
console.timeEnd("Array initialize");

console.time() の例

console.timeEnd(label)

現在のタイマー(実行中の場合)を停止し、コンソールにタイマーラベルと経過時間を出力します。

例については、console.time() を参照してください。

console.timeStamp([label])

記録セッション中にイベントを [Timeline] に追加します。

console.timeStamp('check out this custom timestamp thanks to console.timeStamp()!');

console.timeStamp() の例

関連ガイド:

console.trace(object)

メソッドが呼び出された時点からのスタックトレースを出力します。

console.trace();

console.trace() の例

console.warn(object [, object, ...])

console.log() と同様にメッセージを出力しますが、ログ メッセージの横に黄色の警告アイコンも表示します。

console.warn('user limit reached!');

console.warn() の例