Fixtures
Playwright Test 基于测试装置的概念。测试装置用于为每个测试建立环境,为测试提供它所需的一切,不多不少。
Playwright Test 查看每个测试声明,分析测试所需的一组装置,并专门为测试准备这些装置。装置准备的值会合并到一个单一对象中,该对象作为第一个参数可供 test
、钩子、注解和其他装置使用。
import { test, expect } from '@playwright/test';
test('basic test', async ({ page }) => {
// ...
});
给定上述测试,Playwright Test 将在运行测试之前设置 page
装置,并在测试完成后将其拆除。page
装置提供了一个可供测试使用的 Page 对象。
Playwright Test 附带下面列出的内置装置,您也可以添加自己的装置。Playwright Test 还提供选项来配置 fixtures.browser、fixtures.context 和 fixtures.page。
属性
浏览器
新增于: v1.10Browser 实例在同一工作进程中的所有测试之间共享 - 这使得测试效率很高。但是,每个测试都在独立的 BrowserContext 中运行并获得一个全新的环境。
用法
test.beforeAll(async ({ browser }) => {
const page = await browser.newPage();
// ...
});
类型
浏览器名称
新增于: v1.10运行测试的浏览器名称。默认为 'chromium'
。可用于根据浏览器标注测试。
用法
test('skip this test in Firefox', async ({ page, browserName }) => {
test.skip(browserName === 'firefox', 'Still working on it');
// ...
});
类型
- "chromium" | "firefox" | "webkit"
上下文
新增于: v1.10为每个测试创建的独立 BrowserContext 实例。由于上下文之间相互隔离,因此每个测试都能获得一个全新的环境,即使多个测试在单个 Browser 中运行以实现最大效率。
默认的 fixtures.page 属于此上下文。
用法
test('example test', async ({ page, context }) => {
await context.route('*external.com/*', route => route.abort());
// ...
});
类型
页面
新增于: v1.10为每个测试创建的独立 Page 实例。由于 fixtures.context 的隔离,页面在测试之间是隔离的。
这是测试中最常用的装置。
用法
import { test, expect } from '@playwright/test';
test('basic test', async ({ page }) => {
await page.goto('/signin');
await page.getByLabel('User Name').fill('user');
await page.getByLabel('Password').fill('password');
await page.getByText('Sign in').click();
// ...
});
类型
请求
新增于: v1.10每个测试的独立 APIRequestContext 实例。
用法
import { test, expect } from '@playwright/test';
test('basic test', async ({ request }) => {
await request.post('/signin', {
data: {
username: 'user',
password: 'password'
}
});
// ...
});
类型