跳至主要内容

Playwright 库

Playwright 模块提供了一种启动浏览器实例的方法。以下是使用 Playwright 进行自动化驱动的典型示例

const { chromium, firefox, webkit } = require('playwright');

(async () => {
const browser = await chromium.launch(); // Or 'firefox' or 'webkit'.
const page = await browser.newPage();
await page.goto('http://example.com');
// other actions...
await browser.close();
})();

属性

chromium

在 v1.9 之前添加 playwright.chromium

此对象可用于启动或连接到 Chromium,返回 Browser 的实例。

用法

playwright.chromium

类型


devices

在 v1.9 之前添加 playwright.devices

返回要与 browser.newContext()browser.newPage() 一起使用的设备字典。

const { webkit, devices } = require('playwright');
const iPhone = devices['iPhone 6'];

(async () => {
const browser = await webkit.launch();
const context = await browser.newContext({
...iPhone
});
const page = await context.newPage();
await page.goto('http://example.com');
// other actions...
await browser.close();
})();

用法

playwright.devices

类型


errors

在 v1.9 之前添加 playwright.errors

如果 Playwright 方法无法满足请求,则可能会抛出错误。例如,如果选择器在给定的时间范围内没有匹配任何节点,则 locator.waitFor() 可能会失败。

对于某些类型的错误,Playwright 使用特定的错误类。这些类可通过 playwright.errors 获得。

处理超时错误的示例

try {
await page.locator('.foo').waitFor();
} catch (e) {
if (e instanceof playwright.errors.TimeoutError) {
// Do something if this is a timeout.
}
}

用法

playwright.errors

类型


firefox

在 v1.9 之前添加 playwright.firefox

此对象可用于启动或连接到 Firefox,返回 Browser 的实例。

用法

playwright.firefox

类型


request

在以下版本中添加:v1.16 playwright.request

公开可用于 Web API 测试的 API。

用法

playwright.request

类型


selectors

在 v1.9 之前添加 playwright.selectors

选择器可用于安装自定义选择器引擎。有关更多信息,请参阅 扩展性

用法

playwright.selectors

类型


webkit

在 v1.9 之前添加 playwright.webkit

此对象可用于启动或连接到 WebKit,返回 Browser 的实例。

用法

playwright.webkit

类型