Перейти к основному содержимому

TestOptions

Playwright Test предоставляет множество опций для настройки тестовой среды, Browser, BrowserContext и других.

Эти опции обычно указываются в файле конфигурации через testConfig.use и testProject.use.

playwright.config.ts
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
headless: false,
viewport: { width: 1280, height: 720 },
ignoreHTTPSErrors: true,
video: 'on-first-retry',
},
});

Кроме того, с помощью test.use() вы можете переопределить некоторые опции для файла.

example.spec.ts
import { test, expect } from '@playwright/test';

// Запуск тестов в этом файле с портретным видом.
test.use({ viewport: { width: 600, height: 900 } });

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

Свойства​

acceptDownloads​

Добавлено в: v1.10 testOptions.acceptDownloads

Автоматически загружать все вложения. По умолчанию true, что означает, что все загрузки принимаются.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
acceptDownloads: false,
},
});

Тип


actionTimeout​

Добавлено в: v1.10 testOptions.actionTimeout

Тайм-аут по умолчанию для каждого действия Playwright в миллисекундах, по умолчанию 0 (без тайм-аута).

Это тайм-аут по умолчанию для всех действий Playwright, такой же, как настроен через page.setDefaultTimeout().

Использование

import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
use: {
/* Максимальное время, которое может занять каждое действие, такое как `click()`. По умолчанию 0 (без ограничений). */
actionTimeout: 0,
},
});

Узнайте больше о различных тайм-аутах.

Тип


baseURL​

Добавлено в: v1.10 testOptions.baseURL

При использовании page.goto(), page.route(), page.waitForURL(), page.waitForRequest() или page.waitForResponse() учитывается базовый URL, используя конструктор URL() для построения соответствующего URL. По умолчанию не установлен. Примеры:

  • baseURL: http://localhost:3000 и переход на /bar.html приводит к http://localhost:3000/bar.html
  • baseURL: http://localhost:3000/foo/ и переход на ./bar.html приводит к http://localhost:3000/foo/bar.html
  • baseURL: http://localhost:3000/foo (без завершающего слэша) и переход на ./bar.html приводит к http://localhost:3000/bar.html

Использование

import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
use: {
/* Базовый URL для использования в действиях, таких как `await page.goto('/')`. */
baseURL: 'http://localhost:3000',
},
});

Тип


browserName​

Добавлено в: v1.10 testOptions.browserName

Имя браузера, в котором выполняются тесты. По умолчанию 'chromium'. В большинстве случаев следует устанавливать browserName в вашем TestConfig:

Использование

playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
use: {
browserName: 'firefox',
},
});

Тип

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

bypassCSP​

Добавлено в: v1.10 testOptions.bypassCSP

Переключает обход политики безопасности содержимого страницы. По умолчанию false.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
bypassCSP: true,
}
});

Тип


channel​

Добавлено в: v1.10 testOptions.channel

Канал распространения браузера.

Используйте "chromium", чтобы включить новый режим без заголовка.

Используйте "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev" или "msedge-canary", чтобы использовать брендированные Google Chrome и Microsoft Edge.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
projects: [
{
name: 'Microsoft Edge',
use: {
...devices['Desktop Edge'],
channel: 'msedge'
},
},
]
});

Тип


clientCertificates​

Добавлено в: v1.46 testOptions.clientCertificates

Аутентификация клиента TLS позволяет серверу запросить клиентский сертификат и проверить его.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
clientCertificates: [{
origin: 'https://example.com',
certPath: './cert.pem',
keyPath: './key.pem',
passphrase: 'mysecretpassword',
}],
},
});

Тип

  • Array<Object>
    • origin string

      Точный источник, для которого сертификат действителен. Источник включает протокол https, имя хоста и, возможно, порт.

    • certPath string (опционально)

      Путь к файлу с сертификатом в формате PEM.

    • cert Buffer (опционально)

      Прямое значение сертификата в формате PEM.

    • keyPath string (опционально)

      Путь к файлу с закрытым ключом в формате PEM.

    • key Buffer (опционально)

      Прямое значение закрытого ключа в формате PEM.

    • pfxPath string (опционально)

      Путь к PFX или PKCS12 закодированному закрытому ключу и цепочке сертификатов.

    • pfx Buffer (опционально)

      Прямое значение PFX или PKCS12 закодированного закрытого ключа и цепочки сертификатов.

    • passphrase string (опционально)

      Пароль для закрытого ключа (PEM или PFX).

Детали

Массив клиентских сертификатов для использования. Каждый объект сертификата должен иметь либо оба certPath и keyPath, либо один pfxPath, или их соответствующие прямые значения (cert и key, или pfx). При необходимости, свойство passphrase должно быть предоставлено, если сертификат зашифрован. Свойство origin должно быть предоставлено с точным совпадением с источником запроса, для которого сертификат действителен.

Аутентификация по клиентскому сертификату активна только если предоставлен хотя бы один клиентский сертификат. Если вы хотите отклонять все клиентские сертификаты, отправляемые сервером, нужно предоставить клиентский сертификат с origin, который не совпадает ни с одним из доменов, которые вы планируете посещать.

примечание

При использовании WebKit на macOS доступ к localhost не будет использовать клиентские сертификаты. Вы можете сделать это, заменив localhost на local.playwright.


colorScheme​

Добавлено в: v1.10 testOptions.colorScheme

Эмулирует медиа-функцию prefers-colors-scheme, поддерживаемые значения: 'light' и 'dark'. Подробнее см. page.emulateMedia(). Передача null сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию 'light'.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
colorScheme: 'dark',
},
});

Тип

  • null | "light" | "dark" | "no-preference"

connectOptions​

Добавлено в: v1.10 testOptions.connectOptions

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
connectOptions: {
wsEndpoint: 'ws://localhost:5678',
},
},
});

Если указаны параметры подключения, стандартные фикстуры fixtures.browser, fixtures.context и fixtures.page используют удалённый браузер вместо запуска браузера локально.

Тип

  • void | Object
    • wsEndpoint string

      Веб-сокетный конечный пункт браузера для подключения.

    • headers void | Object<string, string> (опционально)

      Дополнительные HTTP-заголовки для отправки с запросом на подключение веб-сокета. Необязательно.

    • timeout number (опционально)

      Тайм-аут в миллисекундах для установления соединения. Необязательно, по умолчанию без тайм-аута.

    • exposeNetwork string (опционально)

      Опция для предоставления сети, доступной на подключающемся клиенте, браузеру, к которому подключаются. Подробнее см. browserType.connect().


contextOptions​

Добавлено в: v1.10 testOptions.contextOptions

Опции, используемые для создания контекста, как передано в browser.newContext(). Конкретные опции, такие как testOptions.viewport, имеют приоритет над этим.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
contextOptions: {
reducedMotion: 'reduce',
},
},
});

Тип


contrast​

Добавлено в: v1.50 testOptions.contrast

Эмулирует медиафункцию 'prefers-contrast'. Поддерживаются 'no-preference' и 'more'. Подробнее см. page.emulateMedia(). Значение null возвращает системные настройки. По умолчанию 'no-preference'.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
contrast: 'more',
},
});

Тип

  • null | "no-preference" | "more"

deviceScaleFactor​

Добавлено в: v1.10 testOptions.deviceScaleFactor

Укажите коэффициент масштабирования устройства (можно рассматривать как dpr). По умолчанию 1. Узнайте больше о эмуляции устройств с коэффициентом масштабирования устройства.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
viewport: { width: 2560, height: 1440 },
deviceScaleFactor: 2,
},
});

Тип


extraHTTPHeaders​

Добавлено в: v1.10 testOptions.extraHTTPHeaders

Объект, содержащий дополнительные HTTP-заголовки для отправки с каждым запросом. По умолчанию нет.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
extraHTTPHeaders: {
'X-My-Header': 'value',
},
},
});

Тип


forcedColors​

Добавлено в: v1.50 testOptions.forcedColors

Эмулирует медиафункцию 'forced-colors'. Поддерживаются 'active' и 'none'. Подробнее см. page.emulateMedia(). Значение null возвращает системные настройки. По умолчанию 'none'.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
forcedColors: 'active',
},
});

Тип

  • null | "active" | "none"

geolocation​

Добавлено в: v1.10 testOptions.geolocation

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
geolocation: { longitude: 12.492507, latitude: 41.889938 },
},
});

Узнайте больше о геолокации.

Тип

  • Object
    • latitude number

      Широта между -90 и 90.

    • longitude number

      Долгота между -180 и 180.

    • accuracy number (опционально)

      Неотрицательное значение точности. По умолчанию 0.


hasTouch​

Добавлено в: v1.10 testOptions.hasTouch

Указывает, поддерживает ли видовая область сенсорные события. По умолчанию false. Узнайте больше о мобильной эмуляции.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
hasTouch: true
},
});

Тип


headless​

Добавлено в: v1.10 testOptions.headless

Определяет, запускать ли браузер в режиме без графического интерфейса (headless). Подробнее для Chromium и Firefox. Значение по умолчанию — true.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
headless: false
},
});

Тип


httpCredentials​

Добавлено в: v1.10 testOptions.httpCredentials

Учетные данные для HTTP-аутентификации. Если источник не указан, имя пользователя и пароль отправляются на любые серверы при неавторизованных ответах.

Передайте массив, чтобы использовать разные учётные данные для разных источников (origin). Используется первая запись, соответствующая источнику запроса, а записи без указанного источника соответствуют любому запросу.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
httpCredentials: {
username: 'user',
password: 'pass',
},
},
});

При передаче массива учётных данных в test.use() оберните его в дополнительный массив, см. параметры фикстур.

example.spec.ts
test.use({
httpCredentials: [[
{ username: 'alice', password: 'alice-pass', origin: 'https://a.example.com' },
{ username: 'bob', password: 'bob-pass', origin: 'https://b.example.com' },
], { scope: 'test' }],
});

Тип

  • Object | Array<Object>
    • username string

    • password string

    • origin string (опционально)

      Ограничить отправку http-учетных данных на конкретный источник (scheme://host:port).

    • send "unauthorized" | "always" (опционально)

      Эта опция применяется только к запросам, отправленным из соответствующего APIRequestContext, и не влияет на запросы, отправленные из браузера. 'always' - заголовок Authorization с учетными данными базовой аутентификации будет отправлен с каждым API-запросом. 'unauthorized - учетные данные отправляются только при получении ответа 401 (Unauthorized) с заголовком WWW-Authenticate. По умолчанию 'unauthorized'.


ignoreHTTPSErrors​

Добавлено в: v1.10 testOptions.ignoreHTTPSErrors

Игнорировать ли ошибки HTTPS при отправке сетевых запросов. По умолчанию false.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
ignoreHTTPSErrors: true,
},
});

Тип


isMobile​

Добавлено в: v1.10 testOptions.isMobile

Определяет, учитывается ли тег meta viewport и включены ли сенсорные события. Параметр isMobile входит в настройки устройства, поэтому его не нужно задавать вручную. По умолчанию — false. Подробнее см. в разделе эмуляция мобильных устройств.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
isMobile: false,
},
});

Тип


javaScriptEnabled​

Добавлено в: v1.10 testOptions.javaScriptEnabled

Включать ли JavaScript в контексте. По умолчанию true. Узнайте больше о отключении JavaScript.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
javaScriptEnabled: false,
},
});

Тип


launchOptions​

Добавлено в: v1.10 testOptions.launchOptions

Опции, используемые для запуска браузера, как передано в browserType.launch(). Конкретные опции testOptions.headless и testOptions.channel имеют приоритет над этим.

warning

Используйте пользовательские аргументы браузера на свой страх и риск, так как некоторые из них могут нарушить функциональность Playwright.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
projects: [
{
name: 'chromium',
use: {
...devices['Desktop Chrome'],
launchOptions: {
args: ['--start-maximized']
}
}
}
]
});

Тип


locale​

Добавлено в: v1.10 testOptions.locale

Укажите локаль пользователя, например en-GB, de-DE и т.д. Локаль повлияет на значение navigator.language, значение заголовка запроса Accept-Language, а также на правила форматирования чисел и дат. По умолчанию en-US. Узнайте больше об эмуляции в нашем руководстве по эмуляции.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
locale: 'it-IT',
},
});

Тип


navigationTimeout​

Добавлено в: v1.10 testOptions.navigationTimeout

Тайм-аут для каждого действия навигации в миллисекундах. По умолчанию 0 (без тайм-аута).

Это тайм-аут навигации по умолчанию, такой же, как настроен через page.setDefaultNavigationTimeout().

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
navigationTimeout: 3000,
},
});

Узнайте больше о различных тайм-аутах.

Тип


offline​

Добавлено в: v1.10 testOptions.offline

Эмулировать ли отключение сети. По умолчанию false. Узнайте больше о эмуляции сети.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
offline: true
},
});

Тип


permissions​

Добавлено в: v1.10 testOptions.permissions

Список разрешений, которые нужно предоставить всем страницам в этом контексте. Подробнее см. browserContext.grantPermissions(). По умолчанию нет.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
permissions: ['notifications'],
},
});

Тип


proxy​

Добавлено в: v1.10 testOptions.proxy

Настройки сетевого прокси.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
proxy: {
server: 'http://myproxy.com:3128',
bypass: 'localhost',
},
},
});

Тип

  • Object
    • server string

      Прокси для использования для всех запросов. Поддерживаются HTTP и SOCKS прокси, например http://myproxy.com:3128 или socks5://myproxy.com:3128. Краткая форма myproxy.com:3128 считается HTTP прокси.

    • bypass string (опционально)

      Необязательные домены, разделенные запятыми, для обхода прокси, например ".com, chromium.org, .domain.com".

    • username string (опционально)

      Необязательное имя пользователя для использования, если HTTP прокси требует аутентификации.

    • password string (опционально)

      Необязательный пароль для использования, если HTTP прокси требует аутентификации.


reducedMotion​

Добавлено в: v1.50 testOptions.reducedMotion

Эмулирует медиафункцию 'prefers-reduced-motion'. Поддерживаются 'reduce' и 'no-preference'. Подробнее см. page.emulateMedia(). Значение null возвращает системные настройки. По умолчанию 'no-preference'.

Usage

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
reducedMotion: 'reduce',
},
});

Type

  • null | "reduce" | "no-preference"

screen​

Добавлено в: v1.64 testOptions.screen

Эмулирует размер экрана, доступный странице через window.screen. Используется только при заданном testOptions.viewport.

Usage

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
viewport: { width: 390, height: 664 },
screen: { width: 390, height: 844 },
},
});

Type

  • Object
    • width number

      Ширина страницы в пикселях.

    • height number

      Высота страницы в пикселях.


screenshot​

Добавлено в: v1.10 testOptions.screenshot

Автоматически ли захватывать скриншот после каждого теста. По умолчанию 'off'.

  • 'off': Не захватывать скриншоты.
  • 'on': Захватывать скриншот после каждого теста.
  • 'only-on-failure': Захватывать скриншот после каждого сбоя теста.
  • 'on-first-failure': Захватывать скриншот после первого сбоя каждого теста.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
screenshot: 'only-on-failure',
},
});

Узнайте больше о автоматических скриншотах.

Тип

  • Object | "off" | "on" | "only-on-failure" | "on-first-failure"
    • mode "off" | "on" | "only-on-failure" | "on-first-failure"

      Режим автоматического захвата скриншотов.

    • fullPage boolean (опционально)

      Если true, делает скриншот всей прокручиваемой страницы, а не только видимой области. По умолчанию false.

    • omitBackground boolean (опционально)

      Скрывает белый фон по умолчанию и позволяет захватывать скриншоты с прозрачностью. Не применимо к изображениям jpeg. По умолчанию false.


serviceWorkers​

Добавлено в: v1.10 testOptions.serviceWorkers

Разрешать ли сайтам регистрировать сервис-воркеры. По умолчанию 'allow'.

  • 'allow': Сервис-воркеры могут быть зарегистрированы.
  • 'block': Playwright будет блокировать всю регистрацию сервис-воркеров.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
serviceWorkers: 'allow'
},
});

Тип

  • "allow" | "block"

storageState​

Добавлено в: v1.10 testOptions.storageState

Узнайте больше о состоянии хранилища и аутентификации.

Заполняет контекст заданным состоянием хранилища. Эта опция может быть использована для инициализации контекста с информацией о входе, полученной через browserContext.storageState().

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
storageState: 'storage-state.json',
},
});

Тип

  • string | Object
    • cookies Array<Object>

      • name string

      • value string

      • domain string

        Домен и путь обязательны. Чтобы cookie применялись ко всем поддоменам, добавьте точку перед доменом, например: ".example.com"

      • path string

        Домен и путь обязательны

      • expires number

        Время Unix в секундах.

      • httpOnly boolean

      • secure boolean

      • sameSite "Strict" | "Lax" | "None"

        флаг sameSite

      Cookies для установки в контексте

    • origins Array<Object>

Детали

Когда состояние хранилища настроено в конфигурации, возможно сбросить состояние хранилища для файла:

not-signed-in.spec.ts
import { test } from '@playwright/test';

// Сброс состояния хранилища для этого файла, чтобы избежать аутентификации
test.use({ storageState: { cookies: [], origins: [] } });

test('not signed in test', async ({ page }) => {
// ...
});

testIdAttribute​

Добавлено в: v1.27 testOptions.testIdAttribute

Пользовательский атрибут, используемый в page.getByTestId(). По умолчанию используется data-testid. Чтобы находить элементы по любому из нескольких атрибутов, передайте их в виде списка, разделённого запятыми.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
testIdAttribute: 'pw-test-id',
},
});

Несколько атрибутов:

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
testIdAttribute: 'data-pw,data-ti',
},
});

timezoneId​

Добавлено в: v1.10 testOptions.timezoneId

Изменяет часовой пояс контекста. См. ICU's metaZones.txt для списка поддерживаемых идентификаторов часовых поясов. По умолчанию используется системный часовой пояс.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
timezoneId: 'Europe/Rome',
},
});

Тип


trace​

Добавлено в: v1.10 testOptions.trace

Определяет, следует ли записывать трассировку для каждого теста. По умолчанию — 'off'. Первоначальный запуск теста называется «первым запуском»; последующие запуски, вызванные повторными попытками, называются «повторными попытками».

  • 'off': Не записывать трассировку.
  • 'on': Записывать и сохранять трассировку для каждого запуска.
  • 'on-first-retry': Записывать и сохранять трассировку только для первой повторной попытки теста.
  • 'on-all-retries': Записывать и сохранять трассировку для каждой повторной попытки.
  • 'retain-on-failure': Записывать трассировку для каждого запуска, но сохранять её только для запусков, завершившихся с ошибкой. Трассировка запуска, завершившегося с ошибкой, сохраняется, даже если последующая повторная попытка завершилась успешно.
  • 'retain-on-first-failure': Записывать трассировку только для первого запуска теста (не для повторных попыток) и сохранять её только в том случае, если этот запуск завершился с ошибкой.
  • 'retain-on-failure-and-retries': Записывать трассировку для каждого запуска и сохранять её для любого запуска, который завершился с ошибкой или является повторной попыткой.

См. режимы трассировки, где приведено наглядное сравнение того, что записывает и сохраняет каждый режим.

Для более точного контроля передайте объект, который указывает mode и функции трассировки для включения.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
trace: 'on-first-retry'
},
});

Узнайте больше о записи трассировки.

Тип

  • Object | "off" | "on" | "on-first-retry" | "on-all-retries" | "retain-on-failure" | "retain-on-first-failure" | "retain-on-failure-and-retries"
    • mode "off" | "on" | "retain-on-failure" | "on-first-retry" | "on-all-retries" | "retain-on-first-failure" | "retain-on-failure-and-retries"

      Режим записи трассировки.

    • attachments boolean (опционально)

      Включать ли вложения теста. По умолчанию true. Необязательно.

    • screenshots boolean (опционально)

Определяет, следует ли делать скриншоты во время трассировки. Скриншоты используются для предварительного просмотра на временной шкале. По умолчанию true. Необязательный параметр.

  • snapshots boolean | Object (необязательный)

    • dom boolean (необязательный)

      Создавать снимок DOM при каждом действии и записывать сетевую активность. Необязательный параметр.

    • aria boolean (необязательный)

      Создавать ARIA-снимок страницы при каждом действии. Необязательный параметр.

    • screen boolean (необязательный)

      Делать скриншот страницы при каждом действии. Необязательный параметр.

    Определяет, какие снимки создавать при каждом действии. Передача true эквивалентна { dom: true }. По умолчанию true. Необязательный параметр.

  • sources boolean (необязательный)

    Включать ли исходные файлы для действий трассировки. По умолчанию true. Необязательно.


userAgent​

Добавлено в: v1.10 testOptions.userAgent

Конкретный пользовательский агент для использования в этом контексте.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
userAgent: 'some custom ua',
},
});

Тип


video​

Добавлено в: v1.10 testOptions.video

Определяет, следует ли записывать видео для каждого теста. По умолчанию — 'off'. Начальный запуск теста называется «первым запуском»; последующие запуски, вызванные повторными попытками, называются «повторными попытками».

  • 'off': Не записывать видео.
  • 'on': Записывать и сохранять видео для каждого запуска.
  • 'on-first-retry': Записывать и сохранять видео только для первой повторной попытки выполнения теста.
  • 'on-all-retries': Записывать и сохранять видео для каждой повторной попытки.
  • 'retain-on-failure': Записывать видео для каждого запуска, но сохранять его только для запусков, завершившихся с ошибкой. Видео неудачного запуска сохраняется, даже если последующая повторная попытка завершается успешно.
  • 'retain-on-first-failure': Записывать видео только для первого запуска теста (но не для повторных попыток) и сохранять его только в том случае, если этот запуск завершился с ошибкой.
  • 'retain-on-failure-and-retries': Записывать видео для каждого запуска и сохранять его для любого запуска, который завершился с ошибкой или является повторной попыткой.

См. раздел режимы записи видео, где приведено наглядное сравнение того, какие запуски записываются и какие видеозаписи сохраняются в каждом режиме.

Чтобы контролировать размер видео, передайте объект с свойствами mode и size. Если размер видео не указан, он будет равен testOptions.viewport, уменьшенному для соответствия 800x800. Если viewport не настроен явно, размер видео по умолчанию составляет 800x450. Фактическое изображение каждой страницы будет уменьшено, если необходимо, чтобы соответствовать указанному размеру.

Чтобы записывать более плавное видео анимаций и прокрутки, передайте fps, например { mode: 'on', size: { width: 1920, height: 1080 }, fps: 60 }. Более высокая частота кадров и больший размер видео увеличивают нагрузку на процессор при кодировании. В настоящее время Firefox и WebKit захватывают до 25 кадров в секунду.

Чтобы добавлять аннотации действий в видео, передайте show с вложенными параметрами actions и/или test. Параметр actions управляет визуальным выделением элементов, с которыми выполняется взаимодействие. Продолжительность каждого выделения можно задать с помощью необязательного параметра duration в миллисекундах (по умолчанию — 500). Параметр test определяет, какая информация о тесте отображается в виде наложения со статусом.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
video: 'on-first-retry',
},
});

Узнайте больше о записи видео.

Тип

  • Object | "off" | "on" | "retain-on-failure" | "on-first-retry" | "on-all-retries" | "retain-on-first-failure" | "retain-on-failure-and-retries"
    • mode "off" | "on" | "retain-on-failure" | "on-first-retry" | "on-all-retries" | "retain-on-first-failure" | "retain-on-failure-and-retries"

      Режим записи видео.

    • size Object (опционально)

Размер записываемого видео. Необязательный параметр.

  • fps number (необязательно)

    Частота кадров записываемого видео в кадрах в секунду. По умолчанию 25.

  • show Object (необязательно)

    • actions Object (необязательно)

      • duration number (необязательно)

        Продолжительность отображения каждой аннотации в миллисекундах. По умолчанию 500.

      • position "top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right" (необязательно)

        Положение наложенного заголовка действия. По умолчанию "top-right".

      • fontSize number (необязательно)

        Размер шрифта заголовка действия в пикселях. По умолчанию 24. Устарел, используйте style.title вместо него.

      • cursor "none" | "pointer" (необязательно)

        Визуальное обозначение курсора для действий с указателем. "pointer" (значение по умолчанию) отображает указатель мыши, который плавно перемещается от точки предыдущего действия к точке следующего. "none" отключает визуальное обозначение курсора.

      • style Object (необязательно)

        • point string (необязательно)

          CSS-объявления для маркера нулевого размера, центрированного в точке действия. Не отображается, если параметр не указан.

        • highlight string (необязательно)

          CSS-объявления для прямоугольника, покрывающего целевой элемент. Не отображается, если параметр не указан.

        • title string (необязательно)

          CSS-объявления для заголовка действия.

        Стили визуальных обозначений действий.

      Управляет визуальными аннотациями элементов, с которыми выполняется взаимодействие.

    • test Object (необязательно)

      • level "file" | "title" | "step" (необязательно)

        Уровень детализации включаемой информации о текущем тесте.

      • position "top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right" (необязательно)

        Положение наложенной информации о тесте. По умолчанию "top-left".

      • fontSize number (необязательно)

        Размер шрифта информации о тесте в пикселях. По умолчанию 14.

      Управляет информацией о тесте, отображаемой поверх видео в виде строки состояния.

    Если указан, добавляет на видео визуальные аннотации с информацией о тесте и подсветкой действий.


viewport​

Добавлено в: v1.10 testOptions.viewport

Эмулирует постоянную видовую область для каждой страницы. По умолчанию используется видовая область 1280x720. Используйте null, чтобы отключить эмуляцию постоянной видовой области. Узнайте больше о эмуляции видовой области.

примечание

Значение null исключает использование предустановок по умолчанию, делает видовую область зависимой от размера окна хоста, определяемого операционной системой. Это делает выполнение тестов недетерминированным.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
use: {
viewport: { width: 100, height: 100 },
},
});

Тип

  • null | Object
    • width number

      ширина страницы в пикселях.

    • height number

      высота страницы в пикселях.


Deprecated​

reuseContext​

Добавлено в: v1.62 testOptions.reuseContext
Discouraged

Эта опция ускоряет компонентные тесты с галереей сценариев за счёт изоляции. Для сквозных тестов оставьте её выключенной, чтобы каждый тест получал отдельный контекст браузера.

Экспериментальная опция. При значении true все тесты в одном воркере используют общий контекст браузера. По умолчанию false.

Между тестами Playwright очищает файлы cookie, кэш, localStorage и IndexedDB посещённых источников, отменяет регистрацию сервис-воркеров, закрывает лишние страницы, удаляет маршруты, привязки и скрипты инициализации, а затем заново применяет настроенное состояние хранилища, размер области просмотра и параметры эмуляции.

Этот сброс не гарантирует полной изоляции. Сохраняются:

Дополнительные ограничения:

  • При включённой записи testOptions.video опция игнорируется.
  • Между соседними тестами могут отличаться только colorScheme, forcedColors, reducedMotion, contrast, screen, userAgent, viewport и testIdAttribute. Изменение любой другой настройки через test.use(), например locale или storageState, создаёт новый контекст и сводит ускорение на нет.
  • Не сочетайте с testOptions.connectOptions, если несколько воркеров подключаются к одному браузеру. Они будут конкурировать за один контекст.
  • Параметр recordHar в testOptions.contextOptions не поддерживается. Файл HAR не создаётся.

Использование

playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
projects: [
{
name: 'components',
testDir: './tests/components',
use: { reuseContext: true },
},
],
});

Тип