跳转到主要内容

调试器

用于控制 Playwright 调试器的 API。调试器允许暂停脚本执行并检查页面。可通过 browser_context.debugger 获取调试器实例。

方法​

next​

新增于: v1.59 debugger.next

恢复脚本执行，并在执行下一个操作前再次暂停。如果调试器未暂停，则抛出异常。

用法

debugger.next()

返回

request_pause​

新增于: v1.59 debugger.request_pause

配置调试器，使其在执行下一个操作前暂停。

如果调试器已处于暂停状态，则抛出异常。在暂停时，可使用 debugger.next() 或 debugger.run_to() 进行单步调试。

请注意，page.pause() 等同于 "debugger" 语句——它会在调用处立即暂停执行。相反，debugger.request_pause() 等同于“在下一条语句处暂停”——它会将调试器配置为在执行下一个操作前暂停。

用法

debugger.request_pause()

返回

resume​

新增于: v1.59 debugger.resume

恢复脚本执行。如果调试器未暂停，则抛出异常。

用法

debugger.resume()

返回

run_to​

新增于: v1.59 debugger.run_to

恢复脚本执行，并在操作源于指定源码位置时暂停。如果调试器未暂停，则抛出异常。

用法

debugger.run_to(location)

参数

  • location Dict#

    • file str

    • line int (可选)

    • column int (可选)

    要暂停的源位置。

返回

属性​

paused_details​

新增于: v1.59 debugger.paused_details

返回有关当前暂停调用的详细信息。如果调试器未暂停，则返回 null。

用法

debugger.paused_details

返回

Events​

on("pausedstatechanged")​

新增于: v1.59 debugger.on("pausedstatechanged")

当调试器暂停或恢复时触发。

用法

debugger.on("pausedstatechanged", handler)