Skip to main content

夹具

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

🌐 Playwright Test is based on the concept of the test fixtures. Test fixtures are used to establish environment for each test, giving the test everything it needs and nothing else.

Playwright 测试会查看每个测试声明，分析测试所需的一组预置条件，并专门为该测试准备这些预置条件。由预置条件准备的值会合并到一个单一对象中，该对象可作为第一个参数提供给 test、钩子、注解和其他预置条件使用。

🌐 Playwright Test looks at each test declaration, analyses the set of fixtures the test needs and prepares those fixtures specifically for the test. Values prepared by the fixtures are merged into a single object that is available to the test, hooks, annotations and other fixtures as a first parameter.

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

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

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

🌐 Given the test above, Playwright Test will set up the page fixture before running the test, and tear it down after the test has finished. page fixture provides a Page object that is available to the test.

Playwright 测试自带了如下列出的内置夹具，你也可以添加自己的夹具。Playwright 测试还可以 提供选项 配置 fixtures.browser、fixtures.context 和 fixtures.page。

🌐 Playwright Test comes with builtin fixtures listed below, and you can add your own fixtures as well. Playwright Test also provides options to configure fixtures.browser, fixtures.context and fixtures.page.

属性​

🌐 Properties

browser​

Added in: v1.10 fixtures.browser

[浏览器] 实例在 相同的 worker 中的所有测试之间共享——这使得测试更高效。然而，每个测试都在一个独立的 [浏览器上下文] 中运行，并获得一个全新的环境。

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

🌐 Learn how to configure browser and see available options.

用法

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

类型

browserName​

Added in: v1.10 fixtures.browserName

运行测试的浏览器名称。默认为 'chromium'。可用于基于浏览器标注测试。

🌐 Name of the browser that runs tests. Defaults to 'chromium'. Useful to annotate tests based on the browser.

用法

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

类型

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

context​

Added in: v1.10 fixtures.context

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

🌐 Isolated BrowserContext instance, created for each test. Since contexts are isolated between each other, every test gets a fresh environment, even when multiple tests run in a single Browser for maximum efficiency.

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

🌐 Learn how to configure context and see available options.

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

🌐 Default fixtures.page belongs to this context.

用法

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

类型

page​

Added in: v1.10 fixtures.page

隔离的 Page 实例，为每个测试创建。由于 fixtures.context 的隔离，测试之间的页面是隔离的。

🌐 Isolated Page instance, created for each test. Pages are isolated between tests due to fixtures.context isolation.

这是测试中最常用的夹具。

🌐 This is the most common fixture used in a test.

用法

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​

Added in: v1.10 fixtures.request

为每个测试隔离的 APIRequestContext 实例。

🌐 Isolated APIRequestContext instance for each test.

用法

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

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

类型