For AI agents: the complete documentation index is available at /tc39-atlas/llms.txt, the full documentation bundle is available at /tc39-atlas/llms-full.txt, and this page is available as Markdown at /tc39-atlas/proposals/year/pending/proposal-standardized-debug.md.
  • 简体中文
  • Standardized Debug S1

    中文标题:标准化调试

    提案概览
    提案速览

    该提案通过引入两个元属性函数 debugger.log 和 debugger.break,标准化了 ECMAScript 实现中的调试设施,它们是恒等函数,并且仅在调用表达式形式中有效。

    Note

    以下 README 来自上游仓库,其中的阶段或状态标注可能滞后;当前信息以提案概览为准。

    标准化调试

    该提案处于 TC39 流程 的第 1 阶段。

    动机

    不同的环境暴露了不同的 API 用于与调试器设施交互。有些环境根本不暴露任何此类 API。本提案旨在为所有 ECMAScript 实现提供标准化的调试设施。此外,这些 API 被限制为恒等函数——即它们返回传递给它们的值。

    本提案建议向 ES 添加以下元属性函数:

    • debugger.log ( v )
    • debugger.break ( [ v ] )

    请注意,与 import() 一样,它们仅在调用表达式形式中有效。例如,x().then(debugger.break) 将是无效的。您必须编写 x().then((v) => debugger.break(v))。此限制是为了确保这些方法(特别是 break)仅从 ECMAScript 代码中调用。