TestOptions
Playwright Test предоставляет множество опций для настройки тестовой среды, Browser, BrowserContext и других.
Эти опции обычно указываются в файле конфигурации через testConfig.use и testProject.use.
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
headless: false,
viewport: { width: 1280, height: 720 },
ignoreHTTPSErrors: true,
video: 'on-first-retry',
},
});
Кроме того, с помощью test.use() вы можете переопределить некоторые опции для файла.
import { test, expect } from '@playwright/test';
// Запуск тестов в этом файле с портретным видом.
test.use({ viewport: { width: 600, height: 900 } });
test('my portrait test', async ({ page }) => {
// ...
});
Свойства
acceptDownloads
Добавлено в: v1.10Автоматически загружать все вложения. По умолчанию true, что означает, что все загрузки принимаются.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
acceptDownloads: false,
},
});
Тип
actionTimeout
Добавлено в: v1.10Тайм-аут по умолчанию для каждого действия Playwright в миллисекундах, по умолчанию 0 (без тайм-аута).
Это тайм-аут по умолчанию для всех действий Playwright, такой же, как настроен через page.setDefaultTimeout().
Использование
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
use: {
/* Максимальное время, которое может занять каждое действие, такое как `click()`. По умолчанию 0 (без ограничений). */
actionTimeout: 0,
},
});
Узнайте больше о различных тайм-аутах.
Тип
baseURL
Добавлено в: v1.10При использовании 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Имя браузера, в котором выполняются тесты. По умолчанию 'chromium'. В большинстве случаев следует устанавливать browserName в вашем TestConfig:
Использование
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
use: {
browserName: 'firefox',
},
});
Тип
- "chromium" | "firefox" | "webkit"
bypassCSP
Добавлено в: v1.10Переключает обход политики безопасности содержимого страницы. По умолчанию false.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
bypassCSP: true,
}
});
Тип
channel
Добавлено в: v1.10Канал распространения браузера.
Используйте "chromium", чтобы включить новый режим без заголовка.
Используйте "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev" или "msedge-canary", чтобы использовать брендированные Google Chrome и Microsoft Edge.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'Microsoft Edge',
use: {
...devices['Desktop Edge'],
channel: 'msedge'
},
},
]
});
Тип
clientCertificates
Добавлено в: v1.46Аутентификация клиента TLS позволяет серверу запросить клиентский сертификат и проверить его.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
clientCertificates: [{
origin: 'https://example.com',
certPath: './cert.pem',
keyPath: './key.pem',
passphrase: 'mysecretpassword',
}],
},
});
Тип
- Array<Object>
-
originstringТочный источник, для которого сертификат действителен. Источник включает протокол
https, имя хоста и, возможно, порт. -
certPathstring (опционально)Путь к файлу с сертификатом в формате PEM.
-
certBuffer (опционально)Прямое значение сертификата в формате PEM.
-
keyPathstring (опционально)Путь к файлу с закрытым ключом в формате PEM.
-
keyBuffer (опционально)Прямое значение закрытого ключа в формате PEM.
-
pfxPathstring (опционально)Путь к PFX или PKCS12 закодированному закрытому ключу и цепочке сертификатов.
-
pfxBuffer (опционально)Прямое значение PFX или PKCS12 закодированного закрытого ключа и цепочки сертификатов.
-
passphrasestring (опционально)Пароль для закрытого ключа (PEM или PFX).
-
Детали
Массив клиентских сертификатов для использования. Каждый объект сертификата должен иметь либо оба certPath и keyPath, либо один pfxPath, или их соответствующие прямые значения (cert и key, или pfx). При необходимости, свойство passphrase должно быть предоставлено, если сертификат зашифрован. Свойство origin должно быть предоставлено с точным совпадением с источником запроса, для которого сертификат действителен.
Аутентификация по клиентскому сертификату активна только если предоставлен хотя бы один клиентский сертификат. Если вы хотите отклонять все клиентские сертификаты, отправляемые сервером, нужно предоставить клиентский сертификат с origin, который не совпадает ни с одним из доменов, которые вы планируете посещать.
При использовании WebKit на macOS доступ к localhost не будет использовать клиентские сертификаты. Вы можете сделать это, заменив localhost на local.playwright.
colorScheme
Добавлено в: v1.10Эмулирует медиа-функцию prefers-colors-scheme, поддерживаемые значения: 'light' и 'dark'. Подробнее см. page.emulateMedia(). Передача null сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию 'light'.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
colorScheme: 'dark',
},
});
Тип
- null | "light" | "dark" | "no-preference"
connectOptions
Добавлено в: v1.10Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
connectOptions: {
wsEndpoint: 'ws://localhost:5678',
},
},
});
Если указаны параметры подключения, стандартные фикстуры fixtures.browser, fixtures.context и fixtures.page используют удалённый браузер вместо запуска браузера локально.
Тип
- void | Object
-
wsEndpointstringВеб-сокетный конечный пункт браузера для подключения.
-
headersvoid | Object<string, string> (опционально)Дополнительные HTTP-заголовки для отправки с запросом на подключение веб-сокета. Необязательно.
-
timeoutnumber (опционально)Тайм-аут в миллисекундах для установления соединения. Необязательно, по умолчанию без тайм-аута.
-
exposeNetworkstring (опционально)Опция для предоставления сети, доступной на подключающемся клиенте, браузеру, к которому подключаются. Подробнее см. browserType.connect().
-
contextOptions
Добавлено в: v1.10Опции, используемые для создания контекста, как передано в browser.newContext(). Конкретные опции, такие как testOptions.viewport, имеют приоритет над этим.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
contextOptions: {
reducedMotion: 'reduce',
},
},
});
Тип
contrast
Добавлено в: v1.50Эмулирует медиафункцию 'prefers-contrast'. Поддерживаются 'no-preference' и 'more'. Подробнее см. page.emulateMedia(). Значение null возвращает системные настройки. По умолчанию 'no-preference'.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
contrast: 'more',
},
});
Тип
- null | "no-preference" | "more"
deviceScaleFactor
Добавлено в: v1.10Укажите коэффициент масштабирования устройства (можно рассматривать как dpr). По умолчанию 1. Узнайте больше о эмуляции устройств с коэффициентом масштабирования устройства.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
viewport: { width: 2560, height: 1440 },
deviceScaleFactor: 2,
},
});
Тип
extraHTTPHeaders
Добавлено в: v1.10Объект, содержащий дополнительные HTTP-заголовки для отправки с каждым запросом. По умолчанию нет.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
extraHTTPHeaders: {
'X-My-Header': 'value',
},
},
});
Тип
forcedColors
Добавлено в: v1.50Эмулирует медиафункцию 'forced-colors'. Поддерживаются 'active' и 'none'. Подробнее см. page.emulateMedia(). Значение null возвращает системные настройки. По умолчанию 'none'.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
forcedColors: 'active',
},
});
Тип
- null | "active" | "none"
geolocation
Добавлено в: v1.10Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
geolocation: { longitude: 12.492507, latitude: 41.889938 },
},
});
Узнайте больше о геолокации.
Тип
hasTouch
Добавлено в: v1.10Указывает, поддерживает ли видовая область сенсорные события. По умолчанию false. Узнайте больше о мобильной эмуляции.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
hasTouch: true
},
});
Тип
headless
Добавлено в: v1.10Определяет, запускать ли браузер в режиме без графического интерфейса (headless). Подробнее для Chromium и Firefox. Значение по умолчанию — true.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
headless: false
},
});
Тип
httpCredentials
Добавлено в: v1.10Учетные данные для HTTP-аутентификации. Если источник не указан, имя пользователя и пароль отправляются на любые серверы при неавторизованных ответах.
Передайте массив, чтобы использовать разные учётные данные для разных источников (origin). Используется первая запись, соответствующая источнику запроса, а записи без указанного источника соответствуют любому запросу.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
httpCredentials: {
username: 'user',
password: 'pass',
},
},
});
При передаче массива учётных данных в test.use() оберните его в дополнительный массив, см. параметры фикстур.
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>
-
usernamestring -
passwordstring -
originstring (опционально)Ограничить отправку http-учетных данных на конкретный источник (scheme://host:port).
-
send"unauthorized" | "always" (опционально)Эта опция применяется только к запросам, отправленным из соответствующего APIRequestContext, и не влияет на запросы, отправленные из браузера.
'always'- заголовокAuthorizationс учетными данными базовой аутентификации будет отправлен с каждым API-запросом.'unauthorized- учетные данные отправляются только при получении ответа 401 (Unauthorized) с заголовкомWWW-Authenticate. По умолчанию'unauthorized'.
-
ignoreHTTPSErrors
Добавлено в: v1.10Игнорировать ли ошибки HTTPS при отправке сетевых запросов. По умолчанию false.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
ignoreHTTPSErrors: true,
},
});
Тип
isMobile
Добавлено в: v1.10Определяет, учитывается ли тег meta viewport и включены ли сенсорные события. Параметр isMobile входит в настройки устройства, поэтому его не нужно задавать вручную. По умолчанию — false. Подробнее см. в разделе эмуляция мобильных устройств.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
isMobile: false,
},
});
Тип
javaScriptEnabled
Добавлено в: v1.10Включать ли JavaScript в контексте. По умолчанию true. Узнайте больше о отключении JavaScript.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
javaScriptEnabled: false,
},
});
Тип
launchOptions
Добавлено в: v1.10Опции, используемые для запуска браузера, как передано в browserType.launch(). Конкретные опции testOptions.headless и testOptions.channel имеют приоритет над этим.
Используйте пользовательские аргументы браузера на свой страх и риск, так как некоторые из них могут нарушить функциональность Playwright.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'chromium',
use: {
...devices['Desktop Chrome'],
launchOptions: {
args: ['--start-maximized']
}
}
}
]
});
Тип
locale
Добавлено в: v1.10Укажите локаль пользователя, например en-GB, de-DE и т.д. Локаль повлияет на значение navigator.language, значение заголовка запроса Accept-Language, а также на правила форматирования чисел и дат. По умолчанию en-US. Узнайте больше об эмуляции в нашем руководстве по эмуляции.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
locale: 'it-IT',
},
});
Тип
navigationTimeout
Добавлено в: v1.10Тайм-аут для каждого действия навигации в миллисекундах. По умолчанию 0 (без тайм-аута).
Это тайм-аут навигации по умолчанию, такой же, как настроен через page.setDefaultNavigationTimeout().
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
navigationTimeout: 3000,
},
});
Узнайте больше о различных тайм-аутах.
Тип
offline
Добавлено в: v1.10Эмулировать ли отключение сети. По умолчанию false. Узнайте больше о эмуляции сети.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
offline: true
},
});
Тип
permissions
Добавлено в: v1.10Список разрешений, которые нужно предоставить всем страницам в этом контексте. Подробнее см. browserContext.grantPermissions(). По умолчанию нет.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
permissions: ['notifications'],
},
});
Тип
proxy
Добавлено в: v1.10Настройки сетевого прокси.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
proxy: {
server: 'http://myproxy.com:3128',
bypass: 'localhost',
},
},
});
Тип
- Object
-
serverstringПрокси для использования для всех запросов. Поддерживаются HTTP и SOCKS прокси, например
http://myproxy.com:3128илиsocks5://myproxy.com:3128. Краткая формаmyproxy.com:3128считается HTTP прокси. -
bypassstring (опционально)Необязательные домены, разделенные запятыми, для обхода прокси, например
".com, chromium.org, .domain.com". -
usernamestring (опционально)Необязательное имя пользователя для использования, если HTTP прокси требует аутентификации.
-
passwordstring (опционально)Необязательный пароль для использования, если HTTP прокси требует аутентификации.
-
reducedMotion
Добавлено в: v1.50Эмулирует медиафункцию 'prefers-reduced-motion'. Поддерживаются 'reduce' и 'no-preference'. Подробнее см. page.emulateMedia(). Значение null возвращает системные настройки. По умолчанию 'no-preference'.
Usage
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
reducedMotion: 'reduce',
},
});
Type
- null | "reduce" | "no-preference"
screen
Добавлено в: v1.64Эмулирует размер экрана, доступный странице через window.screen. Используется только при заданном testOptions.viewport.
Usage
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
viewport: { width: 390, height: 664 },
screen: { width: 390, height: 844 },
},
});
Type
screenshot
Добавлено в: v1.10Автоматически ли захватывать скриншот после каждого теста. По умолчанию 'off'.
'off': Не захватывать скриншоты.'on': Захватывать скриншот после каждого теста.'only-on-failure': Захватывать скриншот после каждого сбоя теста.'on-first-failure': Захватывать скриншот после первого сбоя каждого теста.
Использование
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"Режим автоматического захвата скриншотов.
-
fullPageboolean (опционально)Если true, делает скриншот всей прокручиваемой страницы, а не только видимой области. По умолчанию
false. -
omitBackgroundboolean (опционально)Скрывает белый фон по умолчанию и позволяет захватывать скриншоты с прозрачностью. Не применимо к изображениям
jpeg. По умолчаниюfalse.
-
serviceWorkers
Добавлено в: v1.10Разрешать ли сайтам регистрировать сервис-воркеры. По умолчанию 'allow'.
'allow': Сервис-воркеры могут быть зарегистрированы.'block': Playwright будет блокировать всю регистрацию сервис-воркеров.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
serviceWorkers: 'allow'
},
});
Тип
- "allow" | "block"
storageState
Добавлено в: v1.10Узнайте больше о состоянии хранилища и аутентификации.
Заполняет контекст заданным состоянием хранилища. Эта опция может быть использована для инициализации контекста с информацией о входе, полученной через browserContext.storageState().
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
storageState: 'storage-state.json',
},
});
Тип
- string | Object
-
-
namestring -
valuestring -
domainstringДомен и путь обязательны. Чтобы cookie применялись ко всем поддоменам, добавьте точку перед доменом, например: ".example.com"
-
pathstringДомен и путь обязательны
-
expiresnumberВремя Unix в секундах.
-
httpOnlyboolean -
secureboolean -
sameSite"Strict" | "Lax" | "None"флаг sameSite
Cookies для установки в контексте
-
-
Детали
Когда состояние хранилища настроено в конфигурации, возможно сбросить состояние хранилища для файла:
import { test } from '@playwright/test';
// Сброс состояния хранилища для этого файла, чтобы избежать аутентификации
test.use({ storageState: { cookies: [], origins: [] } });
test('not signed in test', async ({ page }) => {
// ...
});
testIdAttribute
Добавлено в: v1.27Пользовательский атрибут, используемый в page.getByTestId(). По умолчанию используется data-testid. Чтобы находить элементы по любому из нескольких атрибутов, передайте их в виде списка, разделённого запятыми.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
testIdAttribute: 'pw-test-id',
},
});
Несколько атрибутов:
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
testIdAttribute: 'data-pw,data-ti',
},
});
timezoneId
Добавлено в: v1.10Изменяет часовой пояс контекста. См. ICU's metaZones.txt для списка поддерживаемых идентификаторов часовых поясов. По умолчанию используется системный часовой пояс.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
timezoneId: 'Europe/Rome',
},
});
Тип
trace
Добавлено в: v1.10Определяет, следует ли записывать трассировку для каждого теста. По умолчанию — 'off'. Первоначальный запуск теста называется «первым запуском»; последующие запуски, вызванные повторными попытками, называются «повторными попытками».
'off': Не записывать трассировку.'on': Записывать и сохранять трассировку для каждого запуска.'on-first-retry': Записывать и сохранять трассировку только для первой повторной попытки теста.'on-all-retries': Записывать и сохранять трассировку для каждой повторной попытки.'retain-on-failure': Записывать трассировку для каждого запуска, но сохранять её только для запусков, завершившихся с ошибкой. Трассировка запуска, завершившегося с ошибкой, сохраняется, даже если последующая повторная попытка завершилась успешно.'retain-on-first-failure': Записывать трассировку только для первого запуска теста (не для повторных попыток) и сохранять её только в том случае, если этот запуск завершился с ошибкой.'retain-on-failure-and-retries': Записывать трассировку для каждого запуска и сохранять её для любого запуска, который завершился с ошибкой или является повторной попыткой.
См. режимы трассировки, где приведено наглядное сравнение того, что записывает и сохраняет каждый режим.
Для более точного контроля передайте объект, который указывает mode и функции трассировки для включения.
Использование
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"
Определяет, следует ли делать скриншоты во время трассировки. Скриншоты используются для предварительного просмотра на временной шкале. По умолчанию true. Необязательный параметр.
-
snapshotsboolean | Object (необязательный)-
domboolean (необязательный)Создавать снимок DOM при каждом действии и записывать сетевую активность. Необязательный параметр.
-
ariaboolean (необязательный)Создавать ARIA-снимок страницы при каждом действии. Необязательный параметр.
-
screenboolean (необязательный)Делать скриншот страницы при каждом действии. Необязательный параметр.
Определяет, какие снимки создавать при каждом действии. Передача
trueэквивалентна{ dom: true }. По умолчанию true. Необязательный параметр. -
-
sourcesboolean (необязательный)Включать ли исходные файлы для действий трассировки. По умолчанию true. Необязательно.
userAgent
Добавлено в: v1.10Конкретный пользовательский агент для использования в этом контексте.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
userAgent: 'some custom ua',
},
});
Тип
video
Добавлено в: v1.10Определяет, следует ли записывать видео для каждого теста. По умолчанию — '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 определяет, какая информация о тесте отображается в виде наложения со статусом.
Использование
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"
Размер записываемого видео. Необязательный параметр.
-
fpsnumber (необязательно)Частота кадров записываемого видео в кадрах в секунду. По умолчанию
25. -
showObject (необязательно)-
actionsObject (необязательно)-
durationnumber (необязательно)Продолжительность отображения каждой аннотации в миллисекундах. По умолчанию
500. -
position"top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right" (необязательно)Положение наложенного заголовка действия. По умолчанию
"top-right". -
fontSizenumber (необязательно)Размер шрифта заголовка действия в пикселях. По умолчанию
24. Устарел, используйтеstyle.titleвместо него. -
cursor"none" | "pointer" (необязательно)Визуальное обозначение курсора для действий с указателем.
"pointer"(значение по умолчанию) отображает указатель мыши, который плавно перемещается от точки предыдущего действия к точке следующего."none"отключает визуальное обозначение курсора. -
styleObject (необязательно)-
pointstring (необязательно)CSS-объявления для маркера нулевого размера, центрированного в точке действия. Не отображается, если параметр не указан.
-
highlightstring (необязательно)CSS-объявления для прямоугольника, покрывающего целевой элемент. Не отображается, если параметр не указан.
-
titlestring (необязательно)CSS-объявления для заголовка действия.
Стили визуальных обозначений действий.
-
Управляет визуальными аннотациями элементов, с которыми выполняется взаимодействие.
-
-
testObject (необязательно)-
level"file" | "title" | "step" (необязательно)Уровень детализации включаемой информации о текущем тесте.
-
position"top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right" (необязательно)Положение наложенной информации о тесте. По умолчанию
"top-left". -
fontSizenumber (необязательно)Размер шрифта информации о тесте в пикселях. По умолчанию
14.
Управляет информацией о тесте, отображаемой поверх видео в виде строки состояния.
-
Если указан, добавляет на видео визуальные аннотации с информацией о тесте и подсветкой действий.
-
viewport
Добавлено в: v1.10Эмулирует постоянную видовую область для каждой страницы. По умолчанию используется видовая область 1280x720. Используйте null, чтобы отключить эмуляцию постоянной видовой области. Узнайте больше о эмуляции видовой области.
Значение null исключает использование предустановок по умолчанию, делает видовую область зависимой от размера окна хоста, определяемого операционной системой. Это делает выполнение тестов недетерминированным.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
use: {
viewport: { width: 100, height: 100 },
},
});
Тип
Deprecated
reuseContext
Добавлено в: v1.62Эта опция ускоряет компонентные тесты с галереей сценариев за счёт изоляции. Для сквозных тестов оставьте её выключенной, чтобы каждый тест получал отдельный контекст браузера.
Экспериментальная опция. При значении true все тесты в одном воркере используют общий контекст браузера. По умолчанию false.
Между тестами Playwright очищает файлы cookie, кэш, localStorage и IndexedDB посещённых источников, отменяет регистрацию сервис-воркеров, закрывает лишние страницы, удаляет маршруты, привязки и скрипты инициализации, а затем заново применяет настроенное состояние хранилища, размер области просмотра и параметры эмуляции.
Этот сброс не гарантирует полной изоляции. Сохраняются:
- Разрешения, выданные через browserContext.grantPermissions() во время теста.
- Изменения, внесённые во время теста через browserContext.setGeolocation(), browserContext.setOffline() и browserContext.setExtraHTTPHeaders().
- История навигации,
window.nameи состояние, общее для процесса браузера.
Дополнительные ограничения:
- При включённой записи testOptions.video опция игнорируется.
- Между соседними тестами могут отличаться только
colorScheme,forcedColors,reducedMotion,contrast,screen,userAgent,viewportиtestIdAttribute. Изменение любой другой настройки через test.use(), напримерlocaleилиstorageState, создаёт новый контекст и сводит ускорение на нет. - Не сочетайте с testOptions.connectOptions, если несколько воркеров подключаются к одному браузеру. Они будут конкурировать за один контекст.
- Параметр
recordHarв testOptions.contextOptions не поддерживается. Файл HAR не создаётся.
Использование
import { defineConfig } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'components',
testDir: './tests/components',
use: { reuseContext: true },
},
],
});
Тип