console オブジェクトは、ログ、警告、デバッグ用のメソッドを提供します。
Workers の console オブジェクトには、標準の console API のメソッド ↗ がすべてあります。
ただし、一部のメソッドは no op です。呼び出せてエラーにはなりませんが、何もしません。これらの API を使うライブラリとの互換性を保つためです。
次の表は、各メソッドと、Workers での対応範囲です。
「✅ 対応」と記したメソッドの動作は次のとおりです。
- ローカル開発(
npx wrangler@latest dev)ではコンソールに出力されます - ダッシュボードでログを追跡しているとき、または
wrangler tailを実行しているときは、リアルタイムログに表示されます - Tail Worker イベントと Workers Trace Events の
logsフィールドにエントリが作られます。Logpush で Workers Trace Event Logs を対応先へ送れます。
「🟡 部分対応」と記したメソッドの動作は次のとおりです。
- 本番とローカル開発のどちらでも安全に呼び出せますが、何もしません(no op)
- Workers Playground ↗、Workers ダッシュボードの Quick Editor、remote preview モード(
wrangler dev --remote)では、期待どおりに動き、コンソールへ出力されます。
Workers のデバッグとログ追加について詳しくは Logs を参照してください。
| メソッド | 動作 |
|---|---|
console.debug() ↗ |
✅ 対応 |
console.error() ↗ |
✅ 対応 |
console.info() ↗ |
✅ 対応 |
console.log() ↗ |
✅ 対応 |
console.warn() ↗ |
✅ 対応 |
console.clear() ↗ |
🟡 部分対応 |
console.count() ↗ |
🟡 部分対応 |
console.group() ↗ |
🟡 部分対応 |
console.table() ↗ |
🟡 部分対応 |
console.trace() ↗ |
🟡 部分対応 |
console.assert() ↗ |
⚪ no op |
console.countReset() ↗ |
⚪ no op |
console.dir() ↗ |
⚪ no op |
console.dirxml() ↗ |
⚪ no op |
console.groupCollapsed() ↗ |
⚪ no op |
console.groupEnd ↗ |
⚪ no op |
console.profile() ↗ |
⚪ no op |
console.profileEnd() ↗ |
⚪ no op |
console.time() ↗ |
⚪ no op |
console.timeEnd() ↗ |
⚪ no op |
console.timeLog() ↗ |
⚪ no op |
console.timeStamp() ↗ |
⚪ no op |
console.createTask() ↗ |
🔴 本番では例外を投げます。ローカル開発、Quick Editor、remote preview では動作します |