console 对象提供一组方法,帮助您输出日志、警告和调试代码。
Workers 中的 console 对象包含所有标准 console API 方法 ↗。
不过,部分方法为 no-op(空操作)——可以调用且不会抛出错误,但不会产生任何效果。这确保了与可能使用这些 API 的库的兼容性。
下表列出了每种方法及其在 Workers 中的支持程度。
所有标注为「✅ 已支持」的方法具有以下行为:
- 在本地开发(
npx wrangler@latest dev)中会写入控制台 - 在实时日志中可见,可在仪表板中 tail 日志或运行
wrangler tail - 会在 Tail Worker 事件和 Workers Trace Events 的
logs字段中创建条目,可通过 Logpush 推送到您选择的目标
所有标注为「🟡 部分支持」的方法具有以下行为:
- 在生产环境和本地开发中均可安全调用,但不会产生任何效果(no-op)
- 在 Workers Playground ↗、Workers 仪表板中的 Quick Editor 以及远程预览模式(
wrangler dev --remote)中,调用该方法会按预期工作,输出到控制台等
有关调试和为 Workers 添加日志的更多信息,请参阅 从 Workers 记录日志。
| Method | Behavior |
|---|---|
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 和远程预览中可用 |