跳到主内容

夹具

Playwright Test 基于 测试夹具 (test fixtures) 的概念。测试夹具用于为每个测试建立环境,为测试提供所需的一切,不多也不少。

Playwright Test 检查每个测试声明,分析测试所需的一组夹具,并专门为该测试准备这些夹具。夹具准备的值被合并到一个对象中,该对象作为第一个参数可供 test、钩子 (hooks)、注解 (annotations) 和其他夹具使用。

import { test, expect } from '@playwright/test';

test('basic test', async ({ page }) => {
// ...
});

对于上面的测试,Playwright Test 会在运行测试之前设置 page 夹具,并在测试完成后将其拆除。page 夹具提供一个可供测试使用的 Page 对象。

Playwright Test 内置了下面列出的夹具,你也可以添加自己的夹具。Playwright Test 还提供了选项来配置 fixtures.browserfixtures.contextfixtures.page


属性

browser

添加于: v1.10 fixtures.browser

Browser 实例在同一 worker 中的所有测试之间共享,这提高了测试效率。然而,每个测试都在一个独立的 BrowserContext 中运行,并获得一个全新的环境。

了解如何配置浏览器,并查看可用选项

用法

test.beforeAll(async ({ browser }) => {
const page = await browser.newPage();
// ...
});

类型


browserName

添加于: v1.10 fixtures.browserName

运行测试的浏览器名称。默认为 'chromium'。基于浏览器注解测试时很有用。

用法

test('skip this test in Firefox', async ({ page, browserName }) => {
test.skip(browserName === 'firefox', 'Still working on it');
// ...
});

类型

  • "chromium" | "firefox" | "webkit"

context

添加于: v1.10 fixtures.context

独立的 BrowserContext 实例,为每个测试创建。由于上下文彼此隔离,即使多个测试在单个 Browser 中运行以获得最大效率,每个测试也会获得一个全新的环境。

了解如何配置上下文,并查看可用选项

默认的 fixtures.page 属于此上下文。

用法

test('example test', async ({ page, context }) => {
await context.route('*external.com/*', route => route.abort());
// ...
});

类型


page

添加于: v1.10 fixtures.page

独立的 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();
// ...
});

类型


request

添加于: v1.10 fixtures.request

每个测试独立的 APIRequestContext 实例。

用法

import { test, expect } from '@playwright/test';

test('basic test', async ({ request }) => {
await request.post('/signin', {
data: {
username: 'user',
password: 'password'
}
});
// ...
});

类型