console 对象提供一组方法,帮助您输出日志、警告和调试代码。
Workers 中的 console 对象包含所有标准 console API 方法 ↗。
不过,部分方法为 no-op(空操作)——可以调用且不会抛出错误,但不会产生任何效果。这确保了与可能使用这些 API 的库的兼容性。
下表列出了每种方法及其在 Workers 中的支持程度。
所有标注为「✅ 已支持」的方法具有以下行为:
- 在本地开发(
npx wrangler@latest dev)中会写入控制台 - 在控制面板中跟踪日志或运行
wrangler tail时,它们会出现在实时日志中。 - 它们会在 Tail Worker 事件和 Workers 跟踪事件的
logs字段中创建条目。您可以使用 Logpush 将 Workers 跟踪事件日志发送到受支持的目标位置。
所有标注为「🟡 部分支持」的方法具有以下行为:
- 在生产环境和本地开发中均可安全调用,但不会产生任何效果(no-op)
- 在 Workers Playground ↗、Workers 仪表板中的 Quick Editor 以及远程预览模式(
wrangler dev --remote)中,调用该方法会按预期工作,输出到控制台等
有关调试 Workers 和添加日志的更多信息,请参阅日志。
| 方法 | 行为 |
|---|---|
console.debug() ↗ |
✅ 已支持 |
console.error() ↗ |
✅ 已支持 |
console.info() ↗ |
✅ 已支持 |
console.log() ↗ |
✅ 已支持 |
console.warn() ↗ |
✅ 已支持 |
console.clear() ↗ |
🟡 部分支持 |
console.count() ↗ |
🟡 部分支持 |
console.group() ↗ |
🟡 部分支持 |
console.table() ↗ |
🟡 部分支持 |
console.trace() ↗ |
🟡 部分支持 |
console.assert() ↗ |
⚪ 无操作 |
console.countReset() ↗ |
⚪ 无操作 |
console.dir() ↗ |
⚪ 无操作 |
console.dirxml() ↗ |
⚪ 无操作 |
console.groupCollapsed() ↗ |
⚪ 无操作 |
console.groupEnd ↗ |
⚪ 无操作 |
console.profile() ↗ |
⚪ 无操作 |
console.profileEnd() ↗ |
⚪ 无操作 |
console.time() ↗ |
⚪ 无操作 |
console.timeEnd() ↗ |
⚪ 无操作 |
console.timeLog() ↗ |
⚪ 无操作 |
console.timeStamp() ↗ |
⚪ 无操作 |
console.createTask() ↗ |
🔴 在生产环境中会抛出异常,但在本地开发、Quick Editor 和远程预览中可用 |