Browser
Браузер создается с помощью browser_type.launch(). Пример использования Browser для создания Page:
- Sync
- Async
from playwright.sync_api import sync_playwright, Playwright
def run(playwright: Playwright):
firefox = playwright.firefox
browser = firefox.launch()
page = browser.new_page()
page.goto("https://example.com")
browser.close()
with sync_playwright() as playwright:
run(playwright)
import asyncio
from playwright.async_api import async_playwright, Playwright
async def run(playwright: Playwright):
firefox = playwright.firefox
browser = await firefox.launch()
page = await browser.new_page()
await page.goto("https://example.com")
await browser.close()
async def main():
async with async_playwright() as playwright:
await run(playwright)
asyncio.run(main())
Методы
bind
Added in: v1.59Привязывает браузер к именованному каналу или веб-сокету, делая его доступным для подключения других клиентов.
Использование
browser.bind(title)
browser.bind(title, **kwargs)
Аргументы
-
Название сервера браузера, используемое для идентификации.
-
Хост, к которому привязывается сервер веб-сокетов. Если указан, вместо именованного канала создаётся сервер веб-сокетов.
-
Порт, к которому привязывается сервер веб-сокетов. Если указан, вместо именованного канала создаётся сервер веб-сокетов. Используйте
0, чтобы ОС выбрала доступный порт. -
Рабочий каталог, связанный с этим сервером браузера.
Возвращает
close
Добавлено до v1.9Если этот браузер был получен с помощью browser_type.launch(), закрывает браузер и все его страницы (если они были открыты).
Если этот браузер подключен, очищает все созданные контексты, принадлежащие этому браузеру, и отключается от сервера браузера.
Это похоже на принудительное завершение работы браузера. Чтобы закрыть страницы корректно и убедиться, что вы получаете события закрытия страниц, вызовите browser_context.close() для всех экземпляров BrowserContext, которые вы явно создали ранее с помощью browser.new_context() перед вызовом browser.close().
Сам объект Browser считается утилизированным и больше не может быть использован.
Использование
browser.close()
browser.close(**kwargs)
Аргументы
-
reasonstr (необязательно) Добавлено в: v1.40#Причина, которая будет сообщена операциям, прерванным закрытием браузера.
Возвращает
new_browser_cdp_session
Добавлено в: v1.11Сессии CDP поддерживаются только в браузерах на основе Chromium.
Возвращает вновь созданную сессию браузера.
Использование
browser.new_browser_cdp_session()
Возвращает
new_context
Добавлено до v1.9Создает новый контекст браузера. Он не будет делиться cookies/кэшем с другими контекстами браузера.
Если вы напрямую используете этот метод для создания BrowserContext, рекомендуется явно закрыть возвращенный контекст через browser_context.close(), когда ваш код завершит работу с BrowserContext, и перед вызовом browser.close(). Это обеспечит корректное закрытие context и полное сохранение всех артефактов, таких как HAR и видео.
Использование
- Sync
- Async
browser = playwright.firefox.launch() # или "chromium" или "webkit".
# создайте новый инкогнито контекст браузера.
context = browser.new_context()
# создайте новую страницу в чистом контексте.
page = context.new_page()
page.goto("https://example.com")
# корректно закройте все
context.close()
browser.close()
browser = await playwright.firefox.launch() # или "chromium" или "webkit".
# создайте новый инкогнито контекст браузера.
context = await browser.new_context()
# создайте новую страницу в чистом контексте.
page = await context.new_page()
await page.goto("https://example.com")
# корректно закройте все
await context.close()
await browser.close()
Аргументы
-
accept_downloadsbool (опционально)#Автоматически загружать все вложения. По умолчанию
true, где все загрузки принимаются. -
При использовании page.goto(), page.route(), page.wait_for_url(), page.expect_request() или page.expect_response() учитывается базовый 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
- baseURL:
Включает или отключает обход политики Content-Security-Policy страницы. По умолчанию — false.
-
client_certificatesList[Dict] (необязательно) Добавлено в: v1.46#-
originstrТочный источник, для которого сертификат действителен. Источник включает протокол
https, имя хоста и, возможно, порт. -
certPathUnion[str, pathlib.Path] (опционально)Путь к файлу с сертификатом в формате PEM.
-
certbytes (опционально)Прямое значение сертификата в формате PEM.
-
keyPathUnion[str, pathlib.Path] (опционально)Путь к файлу с закрытым ключом в формате PEM.
-
keybytes (опционально)Прямое значение закрытого ключа в формате PEM.
-
pfxPathUnion[str, pathlib.Path] (опционально)Путь к PFX или PKCS12 закодированному закрытому ключу и цепочке сертификатов.
-
pfxbytes (опционально)Прямое значение PFX или PKCS12 закодированного закрытого ключа и цепочки сертификатов.
-
passphrasestr (опционально)Пароль для закрытого ключа (PEM или PFX).
Аутентификация клиента TLS позволяет серверу запросить клиентский сертификат и проверить его.
Детали
Массив клиентских сертификатов для использования. Каждый объект сертификата должен иметь либо оба
certPathиkeyPath, либо одинpfxPath, или их соответствующие прямые значения (certиkey, илиpfx). При необходимости, свойствоpassphraseдолжно быть предоставлено, если сертификат зашифрован. Свойствоoriginдолжно быть предоставлено с точным совпадением с источником запроса, для которого сертификат действителен.Аутентификация клиентского сертификата активна только когда предоставлен как минимум один клиентский сертификат. Если вы хотите отклонить все клиентские сертификаты, отправляемые сервером, вам нужно предоставить клиентский сертификат с
origin, который не соответствует ни одному из доменов, которые вы планируете посетить.примечаниеПри использовании WebKit на macOS доступ к
localhostне будет использовать клиентские сертификаты. Вы можете сделать это, заменивlocalhostнаlocal.playwright. -
-
color_scheme"light" | "dark" | "no-preference" | "null" (опционально)#Эмулирует медиа-функцию prefers-colors-scheme, поддерживаемые значения:
'light'и'dark'. См. page.emulate_media() для получения более подробной информации. Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'light'. -
contrast"no-preference" | "more" | "null" (опционально)#Эмулирует медиа-функцию
'prefers-contrast', поддерживаемые значения:'no-preference','more'. См. page.emulate_media() для получения более подробной информации. Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'no-preference'. -
device_scale_factorfloat (опционально)#Указывает коэффициент масштабирования устройства (можно рассматривать как dpr). По умолчанию
1. Узнайте больше о эмуляции устройств с коэффициентом масштабирования устройства. -
extra_http_headersDict[str, str] (опционально)#Объект, содержащий дополнительные HTTP-заголовки, которые будут отправляться с каждым запросом. По умолчанию нет.
-
forced_colors"active" | "none" | "null" (опционально)#Эмулирует медиа-функцию
'forced-colors', поддерживаемые значения:'active','none'. См. page.emulate_media() для получения более подробной информации. Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'none'.
Указывает, поддерживает ли область просмотра сенсорные события. По умолчанию — false. Подробнее об эмуляции мобильных устройств.
http_credentialsDict | List[Dict] (необязательно)#-
usernamestr -
passwordstr -
originstr (опционально)Ограничивает отправку http-учетных данных на конкретный источник (scheme://host:port).
-
send"unauthorized" | "always" (опционально)Этот параметр применяется только к запросам, отправленным из соответствующего APIRequestContext, и не влияет на запросы, отправленные из браузера.
'always'- заголовокAuthorizationс учетными данными базовой аутентификации будет отправляться с каждым API-запросом.'unauthorized- учетные данные отправляются только при получении ответа 401 (Unauthorized) с заголовкомWWW-Authenticate. По умолчанию'unauthorized'.
-
Учётные данные для HTTP-аутентификации. Если источник (origin) не указан, имя пользователя и пароль отправляются любым серверам в ответ на сообщения об отсутствии авторизации.
Передайте массив, чтобы использовать разные учётные данные для разных источников. Используется первая запись, соответствующая источнику запроса, а записи без указания источника соответствуют любому запросу.
-
ignore_https_errorsbool (необязательно)#Игнорировать ли ошибки HTTPS при отправке сетевых запросов. По умолчанию
false.
Определяет, учитывается ли тег meta viewport и включены ли сенсорные события. Параметр isMobile входит в настройки устройства, поэтому задавать его вручную не требуется. По умолчанию — false. Подробнее об эмуляции мобильных устройств.
-
java_script_enabledbool (необязательный)#Включать ли JavaScript в контексте. По умолчанию
true. Узнайте больше о отключении JavaScript. -
Укажите локаль пользователя, например
en-GB,de-DEи т. д. Локаль повлияет на значениеnavigator.language, значение заголовка запросаAccept-Language, а также на правила форматирования чисел и дат. По умолчанию используется системная локаль. Узнайте больше о эмуляции в нашем руководстве по эмуляции. -
no_viewportbool (опционально)#Не применять фиксированную видовую область, позволяет изменять размер окна в режиме с заголовком.
-
Эмулировать ли отключение сети. По умолчанию
false. Узнайте больше о эмуляции сети. -
permissionsList[str] (опционально)#Список разрешений, которые нужно предоставить всем страницам в этом контексте. См. browser_context.grant_permissions() для получения более подробной информации. По умолчанию нет.
-
-
serverstrПрокси для использования для всех запросов. Поддерживаются HTTP и SOCKS прокси, например
http://myproxy.com:3128илиsocks5://myproxy.com:3128. Краткая формаmyproxy.com:3128считается HTTP прокси. -
bypassstr (опционально)Необязательные домены, разделенные запятыми, для обхода прокси, например
".com, chromium.org, .domain.com". -
usernamestr (опционально)Необязательное имя пользователя для использования, если HTTP прокси требует аутентификации.
-
passwordstr (опционально)Необязательный пароль для использования, если HTTP прокси требует аутентификации.
Настройки сетевого прокси для использования с этим контекстом. По умолчанию нет.
-
-
record_har_content"omit" | "embed" | "attach" (опционально)#Необязательная настройка для управления содержимым ресурсов. Если указано
omit, содержимое не сохраняется. Если указаноattach, ресурсы сохраняются как отдельные файлы, и все эти файлы архивируются вместе с файлом HAR. По умолчаниюembed, который сохраняет содержимое встраиваемым в файл HAR в соответствии со спецификацией HAR. -
record_har_mode"full" | "minimal" (опционально)#При установке в
minimalзаписывается только информация, необходимая для маршрутизации из HAR. Это исключает размеры, время, страницу, cookies, безопасность и другие типы информации HAR, которые не используются при воспроизведении из HAR. По умолчаниюfull. -
record_har_omit_contentbool (опционально)#Необязательная настройка для управления тем, следует ли исключать содержимое запроса из HAR. По умолчанию
false. -
record_har_pathUnion[str, pathlib.Path] (опционально)#Включает запись HAR для всех страниц в указанный файл HAR в файловой системе. Если не указано, HAR не записывается. Убедитесь, что вызвали browser_context.close(), чтобы HAR был сохранен.
-
record_video_dirUnion[str, pathlib.Path] (опционально)#
Включает запись видео для всех страниц в указанный каталог. Если параметр не указан, видео не записывается. Обязательно вызовите browser_context.close(), чтобы видео были сохранены.
-
record_video_fpsint (необязательно) Добавлено в: v1.64#Частота кадров записываемых видео в кадрах в секунду. По умолчанию —
25. Firefox и WebKit в настоящее время поддерживают запись с частотой до 25 кадров в секунду. -
record_video_sizeDict (необязательно)#Размеры записанных видео. Если не указано, размер будет равен
viewport, уменьшенному для соответствия 800x800. Еслиviewportне настроен явно, размер видео по умолчанию составляет 800x450. Фактическое изображение каждой страницы будет уменьшено, если необходимо, чтобы соответствовать указанному размеру. -
reduced_motion"reduce" | "no-preference" | "null" (опционально)#Эмулирует медиа-функцию
'prefers-reduced-motion', поддерживаемые значения:'reduce','no-preference'. См. page.emulate_media() для получения более подробной информации. Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'no-preference'. -
Эмулирует постоянный размер окна экрана, доступный внутри веб-страницы через
window.screen. Используется только при установке viewport. -
service_workers"allow" | "block" (опционально)#Разрешать ли сайтам регистрировать сервис-воркеры. По умолчанию
'allow'.'allow': Сервис-воркеры могут быть зарегистрированы.'block': Playwright будет блокировать всю регистрацию сервис-воркеров.
-
storage_stateUnion[str, pathlib.Path] | Dict (опционально)#-
-
namestr -
valuestr -
domainstrДомен и путь обязательны. Чтобы cookie применялись ко всем поддоменам, добавьте точку перед доменом, например: ".example.com"
-
pathstrДомен и путь обязательны
-
expiresfloatВремя Unix в секундах.
-
httpOnlybool -
securebool -
sameSite"Strict" | "Lax" | "None"флаг sameSite
Cookies для установки в контексте
-
Узнайте больше о состоянии хранилища и аутентификации.
Заполняет контекст заданным состоянием хранилища. Этот параметр можно использовать для инициализации контекста с информацией о входе, полученной через browser_context.storage_state().
-
-
strict_selectorsbool (опционально)#Если установлено значение true, включает режим строгих селекторов для этого контекста. В режиме строгих селекторов все операции с селекторами, которые подразумевают один целевой элемент DOM, будут вызывать ошибку, если селектор соответствует более чем одному элементу. Этот параметр не влияет на любые API локаторов (локаторы всегда строгие). По умолчанию
false. См. Locator, чтобы узнать больше о строгом режиме. -
timezone_idstr (опционально)#Изменяет часовой пояс контекста. См. metaZones.txt ICU для списка поддерживаемых идентификаторов часовых поясов. По умолчанию используется системный часовой пояс.
-
Специфический user agent для использования в этом контексте.
-
viewportNoneType | Dict (опционально)#Устанавливает постоянную видовую область для каждой страницы. По умолчанию используется видовая область 1280x720.
no_viewportотключает фиксированную видовую область. Узнайте больше о эмуляции видовой области.
Возвращает
new_page
Добавлено до v1.9Создает новую страницу в новом контексте браузера. Закрытие этой страницы также закроет контекст.
Это удобный API, который следует использовать только для сценариев с одной страницей и коротких фрагментов. Производственный код и тестовые фреймворки должны явно создавать browser.new_context(), а затем browser_context.new_page(), чтобы контролировать их точное время жизни.
Использование
browser.new_page()
browser.new_page(**kwargs)
Аргументы
-
accept_downloadsbool (опционально)#Автоматически загружать все вложения. По умолчанию
true, где все загрузки принимаются. -
При использовании page.goto(), page.route(), page.wait_for_url(), page.expect_request() или page.expect_response() учитывается базовый 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
- baseURL:
Включает или отключает обход политики Content-Security-Policy страницы. По умолчанию — false.
-
client_certificatesList[Dict] (необязательно) Добавлено в: v1.46#-
originstrТочный источник, для которого сертификат действителен. Источник включает протокол
https, имя хоста и, возможно, порт. -
certPathUnion[str, pathlib.Path] (опционально)Путь к файлу с сертификатом в формате PEM.
-
certbytes (опционально)Прямое значение сертификата в формате PEM.
-
keyPathUnion[str, pathlib.Path] (опционально)Путь к файлу с закрытым ключом в формате PEM.
-
keybytes (опционально)Прямое значение закрытого ключа в формате PEM.
-
pfxPathUnion[str, pathlib.Path] (опционально)Путь к PFX или PKCS12 закодированному закрытому ключу и цепочке сертификатов.
-
pfxbytes (опционально)Прямое значение PFX или PKCS12 закодированного закрытого ключа и цепочки сертификатов.
-
passphrasestr (опционально)Пароль для закрытого ключа (PEM или PFX).
Аутентификация клиента TLS позволяет серверу запросить клиентский сертификат и проверить его.
Детали
Массив клиентских сертификатов для использования. Каждый объект сертификата должен иметь либо оба
certPathиkeyPath, одинpfxPath, либо их соответствующие прямые значения (certиkey, илиpfx). Опционально, свойствоpassphraseдолжно быть предоставлено, если сертификат зашифрован. Свойствоoriginдолжно быть предоставлено с точным совпадением с источником запроса, для которого сертификат действителен.Аутентификация по клиентскому сертификату активна только если предоставлен хотя бы один клиентский сертификат. Если вы хотите отклонять все клиентские сертификаты, отправляемые сервером, нужно предоставить клиентский сертификат с
origin, который не совпадает ни с одним из доменов, которые вы планируете посещать.примечаниеПри использовании WebKit на macOS, доступ к
localhostне будет использовать клиентские сертификаты. Вы можете сделать это, заменивlocalhostнаlocal.playwright. -
-
color_scheme"light" | "dark" | "no-preference" | "null" (опционально)#Эмулирует медиа-функцию prefers-colors-scheme, поддерживаемые значения:
'light'и'dark'. Подробнее см. page.emulate_media(). Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'light'. -
contrast"no-preference" | "more" | "null" (опционально)#Эмулирует медиа-функцию
'prefers-contrast', поддерживаемые значения:'no-preference','more'. Подробнее см. page.emulate_media(). Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'no-preference'. -
device_scale_factorfloat (опционально)#Указывает коэффициент масштабирования устройства (можно рассматривать как dpr). По умолчанию
1. Узнайте больше о эмуляции устройств с коэффициентом масштабирования устройства. -
extra_http_headersDict[str, str] (опционально)#Объект, содержащий дополнительные HTTP-заголовки, которые будут отправляться с каждым запросом. По умолчанию отсутствуют.
-
forced_colors"active" | "none" | "null" (опционально)#Эмулирует медиа-функцию
'forced-colors', поддерживаемые значения:'active','none'. Подробнее см. page.emulate_media(). Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'none'.
Указывает, поддерживает ли область просмотра события касания. По умолчанию — false. Подробнее об эмуляции мобильных устройств.
http_credentialsDict | List[Dict] (необязательно)#-
usernamestr -
passwordstr -
originstr (опционально)Ограничивает отправку HTTP-учетных данных на определенный источник (scheme://host:port).
-
send"unauthorized" | "always" (опционально)Эта опция применяется только к запросам, отправленным из соответствующего APIRequestContext и не влияет на запросы, отправленные из браузера.
'always'- заголовокAuthorizationс учетными данными базовой аутентификации будет отправляться с каждым API-запросом.'unauthorized- учетные данные отправляются только при получении ответа 401 (Unauthorized) с заголовкомWWW-Authenticate. По умолчанию'unauthorized'.
-
Учётные данные для HTTP-аутентификации. Если источник (origin) не указан, имя пользователя и пароль отправляются любым серверам в ответ на сообщения об отсутствии авторизации.
Передайте массив, чтобы использовать разные учётные данные для разных источников. Используется первая запись, соответствующая источнику запроса, а записи без указанного источника соответствуют любому запросу.
-
ignore_https_errorsbool (необязательно)#Игнорировать ли ошибки HTTPS при отправке сетевых запросов. По умолчанию
false.
Определяет, учитывается ли тег meta viewport и включены ли сенсорные события. Параметр isMobile входит в состав настроек устройства, поэтому задавать его вручную не требуется. По умолчанию — false. Подробнее об эмуляции мобильных устройств.
-
java_script_enabledbool (необязательный)#Включать ли JavaScript в контексте. По умолчанию
true. Узнайте больше о отключении JavaScript. -
Укажите локаль пользователя, например
en-GB,de-DEи т.д. Локаль повлияет на значениеnavigator.language, значение заголовка запросаAccept-Language, а также на правила форматирования чисел и дат. По умолчанию используется системная локаль. Узнайте больше о эмуляции в нашем руководстве по эмуляции. -
no_viewportbool (опционально)#Не применять фиксированную видовую область, позволяет изменять размер окна в режиме с заголовком.
-
Эмулировать ли отключение сети. По умолчанию
false. Узнайте больше о эмуляции сети. -
permissionsList[str] (опционально)#Список разрешений, которые будут предоставлены всем страницам в этом контексте. Подробнее см. browser_context.grant_permissions(). По умолчанию отсутствуют.
-
-
serverstrПрокси, который будет использоваться для всех запросов. Поддерживаются HTTP и SOCKS прокси, например
http://myproxy.com:3128илиsocks5://myproxy.com:3128. Краткая формаmyproxy.com:3128считается HTTP прокси. -
bypassstr (опционально)Опциональные домены, разделенные запятыми, для обхода прокси, например
".com, chromium.org, .domain.com". -
usernamestr (опционально)Опциональное имя пользователя для использования, если HTTP прокси требует аутентификации.
-
passwordstr (опционально)Опциональный пароль для использования, если HTTP прокси требует аутентификации.
Настройки сетевого прокси для использования с этим контекстом. По умолчанию отсутствуют.
-
-
record_har_content"omit" | "embed" | "attach" (опционально)#Опциональная настройка для управления содержимым ресурсов. Если указано
omit, содержимое не сохраняется. Если указаноattach, ресурсы сохраняются как отдельные файлы, и все эти файлы архивируются вместе с HAR файлом. По умолчаниюembed, что сохраняет содержимое в HAR файле в соответствии со спецификацией HAR. -
record_har_mode"full" | "minimal" (опционально)#При установке в
minimal, записывается только информация, необходимая для маршрутизации из HAR. Это исключает размеры, время, страницу, куки, безопасность и другие типы информации HAR, которые не используются при воспроизведении из HAR. По умолчаниюfull. -
record_har_omit_contentbool (опционально)#Опциональная настройка для управления тем, следует ли исключать содержимое запроса из HAR. По умолчанию
false. -
record_har_pathUnion[str, pathlib.Path] (опционально)#Включает запись HAR для всех страниц в указанный HAR файл на файловой системе. Если не указано, HAR не записывается. Убедитесь, что вызов browser_context.close() для сохранения HAR.
-
record_video_dirUnion[str, pathlib.Path] (опционально)#
Включает запись видео для всех страниц в указанный каталог. Если не задано, видео не записываются. Обязательно вызовите browser_context.close(), чтобы видео были сохранены.
-
record_video_fpsint (необязательно) Добавлено в: v1.64#Частота кадров записываемых видео в кадрах в секунду. По умолчанию —
25. Firefox и WebKit в настоящее время захватывают до 25 кадров в секунду. -
record_video_sizeDict (необязательно)#Размеры записанных видео. Если не указано, размер будет равен
viewport, уменьшенному до 800x800. Еслиviewportне настроен явно, размер видео по умолчанию 800x450. Фактическое изображение каждой страницы будет уменьшено, если необходимо, чтобы соответствовать указанному размеру. -
reduced_motion"reduce" | "no-preference" | "null" (опционально)#Эмулирует медиа-функцию
'prefers-reduced-motion', поддерживаемые значения:'reduce','no-preference'. Подробнее см. page.emulate_media(). Передача'null'сбрасывает эмуляцию на системные настройки по умолчанию. По умолчанию'no-preference'. -
Эмулирует постоянный размер экрана окна, доступный внутри веб-страницы через
window.screen. Используется только при установке viewport. -
service_workers"allow" | "block" (опционально)#Разрешать ли сайтам регистрировать сервис-воркеры. По умолчанию
'allow'.'allow': Сервис-воркеры могут быть зарегистрированы.'block': Playwright будет блокировать всю регистрацию сервис-воркеров.
-
storage_stateUnion[str, pathlib.Path] | Dict (опционально)#-
-
namestr -
valuestr -
domainstrДомен и путь обязательны. Чтобы куки применялись ко всем поддоменам, добавьте точку перед доменом, например: ".example.com"
-
pathstrДомен и путь обязательны
-
expiresfloatВремя в секундах по Unix.
-
httpOnlybool -
securebool -
sameSite"Strict" | "Lax" | "None"флаг sameSite
Куки для установки в контексте
-
Узнайте больше о состоянии хранилища и аутентификации.
Заполняет контекст заданным состоянием хранилища. Эта опция может быть использована для инициализации контекста с информацией о входе, полученной через browser_context.storage_state().
-
-
strict_selectorsbool (опционально)#Если установлено в true, включает режим строгих селекторов для этого контекста. В режиме строгих селекторов все операции с селекторами, которые подразумевают один целевой элемент DOM, будут вызывать ошибку, если более одного элемента соответствует селектору. Эта опция не влияет на любые API локаторов (локаторы всегда строгие). По умолчанию
false. См. Locator, чтобы узнать больше о строгом режиме. -
timezone_idstr (опционально)#Изменяет часовой пояс контекста. См. ICU's metaZones.txt для списка поддерживаемых идентификаторов часовых поясов. По умолчанию используется системный часовой пояс.
-
Специфический пользовательский агент для использования в этом контексте.
-
viewportNoneType | Dict (опционально)#Устанавливает постоянную видовую область для каждой страницы. По умолчанию используется видовая область 1280x720.
no_viewportотключает фиксированную видовую область. Узнайте больше о эмуляции видовой области.
Возвращает
start_tracing
Добавлено в: v1.11Этот API управляет Chromium Tracing, который является низкоуровневым инструментом отладки, специфичным для Chromium. API для управления Playwright Tracing можно найти здесь.
Вы можете использовать browser.start_tracing() и browser.stop_tracing(), чтобы создать файл трассировки, который можно открыть в панели производительности Chrome DevTools.
Использование
- Sync
- Async
browser.start_tracing(page, path="trace.json")
page.goto("https://www.google.com")
browser.stop_tracing()
await browser.start_tracing(page, path="trace.json")
await page.goto("https://www.google.com")
await browser.stop_tracing()
Аргументы
-
categoriesList[str] (необязательно)#Указывает пользовательские категории для использования вместо категорий по умолчанию.
-
Необязательный параметр. Если указан, трассировка включает снимки экрана заданной страницы.
-
pathUnion[str, pathlib.Path] (необязательно)#Путь для записи файла трассировки.
-
screenshotsbool (опционально)#захватывает скриншоты в трассировке.
Возвращает
stop_tracing
Добавлено в: v1.11Этот API управляет Chromium Tracing, который является низкоуровневым инструментом отладки, специфичным для Chromium. API для управления Playwright Tracing можно найти здесь.
Возвращает буфер с данными трассировки.
Использование
browser.stop_tracing()
Возвращает
unbind
Добавлено в: v1.59Отменяет привязку сервера браузера, ранее созданную с помощью browser.bind().
Использование
browser.unbind()
Возвращает
Свойства
browser_type
Добавлено в: v1.23Получить тип браузера (chromium, firefox или webkit), к которому принадлежит браузер.
Использование
browser.browser_type
Возвращает
contexts
Добавлено до v1.9Возвращает массив всех открытых контекстов браузера. В недавно созданном браузере это вернет ноль контекстов браузера.
Использование
- Sync
- Async
browser = pw.webkit.launch()
print(len(browser.contexts)) # выводит `0`
context = browser.new_context()
print(len(browser.contexts)) # выводит `1`
browser = await pw.webkit.launch()
print(len(browser.contexts)) # выводит `0`
context = await browser.new_context()
print(len(browser.contexts)) # выводит `1`
Возвращает
is_connected
Добавлено до v1.9Указывает, что браузер подключен.
Использование
browser.is_connected()
Возвращает
version
Добавлено до версии v1.9Возвращает версию браузера.
Использование
browser.version
Возвращает
События
on("context")
Добавлено в: v1.60Возникает при создании нового контекста браузера.
Использование
browser.on("context", handler)
Данные события
on("disconnected")
Добавлено до версии v1.9Вызывается, когда браузер отключается от приложения браузера. Это может произойти по одной из следующих причин:
- Приложение браузера закрыто или аварийно завершило работу.
- Был вызван метод browser.close().
Использование
browser.on("disconnected", handler)
Данные события