调试器

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

---

方法

next

新增于: v1.59 debugger.next

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

用法

Debugger.next();

返回

• void#

---

pausedDetails

新增于: v1.59 debugger.pausedDetails

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

用法

Debugger.pausedDetails();

返回

• null | PausedDetails#

  • location Location

    • file String

    • line int (可选)

    • column int (可选)

  • title String

---

requestPause

新增于: v1.59 debugger.requestPause

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

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

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

用法

Debugger.requestPause();

返回

• void#

---

resume

新增于: v1.59 debugger.resume

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

用法

Debugger.resume();

返回

• void#

---

runTo

新增于: v1.59 debugger.runTo

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

用法

Debugger.runTo(location);

参数

• location Location#

  • setFile String

  • setLine int (可选)

  • setColumn int (可选)

  要暂停的源位置。

返回

• void#

---

Events

onPausedStateChanged(handler)

新增于: v1.59 debugger.onPausedStateChanged(handler)

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

用法

Debugger.onPausedStateChanged(handler)