调试器

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

---

方法

next

新增于: v1.59 debugger.next

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

用法

await debugger.next();

返回

• Promise<void>#

---

pausedDetails

新增于: v1.59 debugger.pausedDetails

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

用法

debugger.pausedDetails();

返回

• null | Object#

  • location Object

    • file string

    • line number (可选)

    • column number (可选)

  • title string

---

requestPause

新增于: v1.59 debugger.requestPause

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

如果调试器已暂停，则抛出异常。在暂停状态下使用 debugger.next() 或 debugger.runTo() 进行单步执行。

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

用法

await debugger.requestPause();

返回

• Promise<void>#

---

resume

新增于: v1.59 debugger.resume

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

用法

await debugger.resume();

返回

• Promise<void>#

---

runTo

新增于: v1.59 debugger.runTo

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

用法

await debugger.runTo(location);

参数

• location Object#

  • file string

  • line number (可选)

  • column number (可选)

  要暂停的源位置。

返回

• Promise<void>#

---

事件

on('pausedstatechanged')

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

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

用法

debugger.on('pausedstatechanged', data => {});