调试器

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

---

方法

NextAsync

新增于: v1.59 debugger.NextAsync

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

用法

await Debugger.NextAsync();

返回

• void#

---

PausedDetails

新增于: v1.59 debugger.PausedDetails

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

用法

Debugger.PausedDetails

返回

• PausedDetails?#

  • location Location

    • file string

    • line int? (可选)

    • column int? (可选)

  • title string

---

RequestPauseAsync

新增于: v1.59 debugger.RequestPauseAsync

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

如果调试器已经处于暂停状态，则抛出异常。在暂停时，使用 Debugger.NextAsync() 或 Debugger.RunToAsync() 进行单步执行。

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

用法

await Debugger.RequestPauseAsync();

返回

• void#

---

ResumeAsync

新增于: v1.59 debugger.ResumeAsync

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

用法

await Debugger.ResumeAsync();

返回

• void#

---

RunToAsync

新增于: v1.59 debugger.RunToAsync

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

用法

await Debugger.RunToAsync(location);

参数

• location Location#

  • File string

  • Line int? (可选)

  • Column int? (可选)

  要暂停的源位置。

返回

• void#

---

Events

event PausedStateChanged

新增于: v1.59 debugger.event PausedStateChanged

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

用法

Debugger.PausedStateChanged += async (_, void) => {};