BrowserType

BrowserType предоставляет методы для запуска конкретного экземпляра браузера или подключения к существующему. Ниже приведен типичный пример использования Playwright для управления автоматизацией:

const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  // other actions...
  await browser.close();
})();

Методы​

connect​

Этот метод подключает Playwright к существующему экземпляру браузера. При подключении к другому браузеру, запущенному с помощью BrowserType.launchServer в Node.js, основные и дополнительные версии должны соответствовать версии клиента (1.2.3 → совместимо с 1.2.x).

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

await browserType.connect(wsEndpoint);
await browserType.connect(wsEndpoint, options);

Аргументы

• wsEndpoint строка

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

• options Объект (необязательно)

  • exposeNetwork строка (необязательно)

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

    Доступные правила:

    1. Шаблон имени хоста, например: example.com, *.org:99, x.*.y.com, *foo.org.
    2. Литеральное значение IP, например: 127.0.0.1, 0.0.0.0:99, [::1], [0:0::1]:99.
    3. <loopback>, который соответствует локальным петлевым интерфейсам: localhost, *.localhost, 127.0.0.1, [::1].

    Некоторые распространенные примеры:

    1. "*" для экспонирования всей сети.
    2. "<loopback>" для экспонирования локальной сети.
    3. "*.test.internal-domain,*.staging.internal-domain,<loopback>" для экспонирования развертываний test/staging и локальной сети.

  • headers Объект<строка, строка> (необязательно)

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

  • logger Логгер (необязательно)

    Приемник логгера для ведения логов Playwright. Необязательно.

  • slowMo число (необязательно)

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

  • timeout число (необязательно)

    Максимальное время в миллисекундах ожидания установления подключения. По умолчанию 0 (без таймаута).

Возвращает

• Promise<Браузер>

connectOverCDP​

Этот метод подключает Playwright к существующему экземпляру браузера с использованием протокола Chrome DevTools.

Доступ к контексту браузера по умолчанию осуществляется через browser.contexts().

примечание

Подключение через протокол Chrome DevTools поддерживается только для браузеров на основе Chromium.

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

const browser = await playwright.chromium.connectOverCDP('http://localhost:9222');
const defaultContext = browser.contexts()[0];
const page = defaultContext.pages()[0];

Аргументы

• endpointURL строка

  Конечная точка веб-сокет-подключения или http url для подключения. Например http://localhost:9222/ или ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4.

• options Объект (необязательно)

  • endpointURL строка (необязательно)

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

  • headers Объект<строка, строка> (необязательно)

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

  • logger Логгер (необязательно)

    Приемник логгера для ведения логов Playwright. Необязательно.

  • slowMo число (необязательно)

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

  • timeout число (необязательно)

    Максимальное время в миллисекундах ожидания установления подключения. По умолчанию 30000 (30 секунд). Установите значение 0 для отключения таймаута.

Возвращает

• Promise<Браузер>

executablePath​

Путь, где Playwright ожидает найти исполняемый файл браузера.

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

browserType.executablePath();

Возвращает

• строка

launch​

Возвращает экземпляр браузера.

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

Вы можете использовать ignoreDefaultArgs для фильтрации --mute-audio из аргументов по умолчанию:

const browser = await chromium.launch({  // Or 'firefox' or 'webkit'.
  ignoreDefaultArgs: ['--mute-audio']
});

Только Chromium Playwright также может использоваться для управления браузерами Google Chrome или Microsoft Edge, но он лучше всего работает с версией Chromium, с которой он связан. Нет гарантии, что он будет работать с любой другой версией. Используйте опцию executablePath с большой осторожностью.

Если предпочтительнее Google Chrome (а не Chromium), рекомендуется использовать сборку Chrome Canary или Dev Channel.

Стандартные браузеры, такие как Google Chrome и Microsoft Edge, подходят для тестов, которые требуют проприетарных кодеков медиа для воспроизведения видео. См. эту статью для других различий между Chromium и Chrome. Эта статья описывает некоторые различия для пользователей Linux.

Аргументы

• options Объект (необязательно)

  • args Массив<строка> (необязательно)

    предупреждение

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

    Дополнительные аргументы для передачи экземпляру браузера. Список флагов Chromium можно найти здесь.

  • channel строка (необязательно)

    Канал дистрибуции браузера. Поддерживаемые значения: "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Подробнее об использовании Google Chrome и Microsoft Edge.

  • chromiumSandbox логическое (необязательно)

    Включить песочницу Chromium. По умолчанию false.

  • devtools логическое (необязательно)

    Устарело

    Используйте средства отладки вместо этого.

    Только Chromium Автоматически открывать панель разработчика для каждой вкладки. Если этот параметр true, параметр headless будет установлен false.

  • downloadsPath строка (необязательно)

    Если указано, принятые загрузки будут скачиваться в эту директорию. В противном случае создается временная директория, которая удаляется при закрытии браузера. В обоих случаях загрузки удаляются при закрытии контекста браузера, в котором они были созданы.

  • env Объект<строка, строка | число | логическое> (необязательно)

    Укажите переменные среды, которые будут видны браузеру. По умолчанию process.env.

  • executablePath строка (необязательно)

    Путь к исполняемому файлу браузера, который нужно запустить вместо встроенного. Если executablePath — относительный путь, он разрешается относительно текущей рабочей директории. Обратите внимание, что Playwright работает только со встроенным Chromium, Firefox или WebKit, используйте на свой страх и риск.

  • firefoxUserPrefs Объект<строка, строка | число | логическое> (необязательно)

    Предпочтения пользователя Firefox. Подробнее о предпочтениях пользователя Firefox about:config.

  • handleSIGHUP логическое (необязательно)

    Закрыть процесс браузера при SIGHUP. По умолчанию true.

  • handleSIGINT логическое (необязательно)

    Закрыть процесс браузера при Ctrl-C. По умолчанию true.

  • handleSIGTERM логическое (необязательно)

    Закрыть процесс браузера при SIGTERM. По умолчанию true.

  • headless логическое (необязательно)

    Запустить браузер в режиме headless. Подробнее для Chromium и Firefox. По умолчанию true если опция devtools true.

  • ignoreDefaultArgs логическое | Массив<строка> (необязательно)

    Если true, Playwright не передаёт свои собственные конфигурационные аргументы и использует только аргументы из args. Если задан массив, он отфильтровывает заданные аргументы по умолчанию. Опасный параметр; использовать с осторожностью. По умолчанию false.

  • logger Логгер (необязательно)

    Приёмник логгера для логов Playwright.

  • proxy Объект (необязательно)

    • server строка

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

    • bypass строка (необязательно)

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

    • username строка (необязательно)

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

    • password строка (необязательно)

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

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

  • slowMo число (необязательно)

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

  • timeout число (необязательно)

    Максимальное время в миллисекундах ожидания запуска экземпляра браузера. По умолчанию 30000 (30 секунд). Передайте 0 для отключения таймаута.

  • tracesDir строка (необязательно)

    Если указано, трассы сохраняются в эту директорию.

Возвращает

• Обещание<Браузер>

launchPersistentContext​

Возвращает экземпляр персистентного контекста браузера.

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

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

await browserType.launchPersistentContext(userDataDir);
await browserType.launchPersistentContext(userDataDir, options);

Аргументы

• userDataDir строка

  Путь к каталогу данных пользователя, который хранит данные сеанса браузера, такие как cookie и локальное хранилище. Дополнительные сведения см. в Chromium и Firefox. Обратите внимание, что каталог данных пользователя Chromium является родительским каталогом «Пути профиля», отображаемого в chrome://version. Для использования временного каталога передайте пустую строку.

• options Объект (необязательно)

  • acceptDownloads boolean (необязательно)

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

  • args Массив<строка> (необязательно)

    предупреждение

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

    Дополнительные аргументы для передачи экземпляру браузера. Список флагов Chromium можно найти здесь.

  • 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

  • bypassCSP boolean (необязательно)

    Включает/выключает обход Content-Security-Policy страницы. По умолчанию false.

  • channel строка (необязательно)

    Канал дистрибуции браузера. Поддерживаемые значения — "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Дополнительную информацию о использовании Google Chrome и Microsoft Edge можно найти здесь.

  • chromiumSandbox boolean (необязательно)

    Включить песочницу Chromium. По умолчанию false.

  • clientCertificates Массив<Объект> (необязательно)

    • origin строка

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

    • certPath строка (необязательно)

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

    • cert Буфер (необязательно)

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

    • keyPath строка (необязательно)

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

    • key Буфер (необязательно)

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

    • pfxPath строка (необязательно)

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

    • pfx Буфер (необязательно)

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

    • passphrase строка (необязательно)

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

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

    Подробности

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

    примечание

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

  • colorScheme null | "светлый" | "тёмный" | "нет предпочтений" (необязательно)

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

  • deviceScaleFactor число (необязательно)

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

  • devtools boolean (необязательно)

    Устарело

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

    Только Chromium Автоматически открыть панель инструментов разработчика для каждого вкладки. Если это значение true, параметр headless будет установлен false.

  • downloadsPath строка (необязательно)

    При указании принятые загрузки сохраняются в эту директорию. В противном случае создается временная директория, которая удаляется при закрытии браузера. В обоих случаях загрузки удаляются при закрытии контекста браузера, в котором они были созданы.

  • env Объект<строка, строка | число | boolean> (необязательно)

    Укажите переменные среды, которые будут видны браузеру. По умолчанию process.env.

  • executablePath строка (необязательно)

    Путь к исполняемому файлу браузера, который необходимо запустить вместо встроенного. Если executablePath — относительный путь, он разрешается относительно текущей рабочей директории. Обратите внимание, что Playwright работает только со встроенными Chromium, Firefox или WebKit, используйте на свой страх и риск.

  • extraHTTPHeaders Объект<строка, строка> (необязательно)

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

• • firefoxUserPrefs Объект<строка, строка | число | логическое> (необязательно)

    Настройки пользователя Firefox. Подробнее о настройках пользователя Firefox см. на странице about:config.

  • forcedColors null | "активно" | "нет" (необязательно)

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

  • geolocation Объект (необязательно)

    • latitude число

      Широта от -90 до 90.

    • longitude число

      Долгота от -180 до 180.

    • accuracy число (необязательно)

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

  • handleSIGHUP логическое (необязательно)

    Закрыть процесс браузера при SIGHUP. По умолчанию true.

  • handleSIGINT логическое (необязательно)

    Закрыть процесс браузера при Ctrl-C. По умолчанию true.

  • handleSIGTERM логическое (необязательно)

    Закрыть процесс браузера при SIGTERM. По умолчанию true.

  • hasTouch логическое (необязательно)

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

  • headless логическое (необязательно)

    Запускать браузер в безадресном режиме. Дополнительные сведения о Chromium и Firefox. По умолчанию true, если опция devtools имеет значение true.

  • httpCredentials Объект (необязательно)

    • username строка

    • password строка

    • origin строка (необязательно)

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

    • send "неавторизован" | "всегда" (необязательно)

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

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

  • ignoreDefaultArgs логическое | массив<строка> (необязательно)

    Если true, Playwright не передает собственные аргументы конфигурации и использует только аргументы из args. Если задан массив, отфильтруются указанные аргументы по умолчанию. Опасная опция; использовать с осторожностью. По умолчанию false.

  • ignoreHTTPSErrors логическое (необязательно)

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

  • isMobile логическое (необязательно)

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

  • javaScriptEnabled логическое (необязательно)

    Включить или выключить JavaScript в контексте. По умолчанию true. Подробнее о отключении JavaScript.

  • locale строка (необязательно)

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

  • logger Логгер (необязательно)

    Приемник логгера для ведения логов Playwright.

  • offline логическое (необязательно)

    Эмулировать отсутствие сетевого соединения. По умолчанию false. Подробнее о эмуляции сетевого соединения.

  • permissions массив<строка> (необязательно)

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

• • proxy Объект (необязательно)

    • server строка

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

    • bypass строка (необязательно)

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

    • username строка (необязательно)

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

    • password строка (необязательно)

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

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

  • recordHar Объект (необязательно)

    • omitContent логическое (необязательно)

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

    • content "omit" | "embed" | "attach" (необязательно)

      Необязательная настройка для управления управлением содержимым ресурсов. Если omit указано, содержимое не сохраняется. Если attach указано, ресурсы сохраняются как отдельные файлы или записи в архиве ZIP. Если embed указано, содержимое сохраняется внутри файла HAR в соответствии со спецификацией HAR. По умолчанию attach для файлов вывода .zip и embed для всех других расширений файлов.

    • path строка

      Путь в файловой системе для записи файла HAR. Если имя файла заканчивается на .zip, content: 'attach' используется по умолчанию.

    • mode "full" | "minimal" (необязательно)

      При установке на minimal, записывается только информация, необходимая для маршрутизации из HAR. Это пропускает размеры, тайминг, страницу, куки, безопасность и другие типы информации HAR, которые не используются при воспроизведении из HAR. По умолчанию full.

    • urlFilter строка | RegExp (необязательно)

      Шаблон glob или regex для фильтрации запросов, которые сохраняются в HAR. Когда baseURL был предоставлен через опции контекста, и переданный URL является путем, он объединяется с помощью конструктора new URL(). По умолчанию ничего.

    Включает запись HAR для всех страниц в файл recordHar.path. Если не указано, HAR не записывается. Убедитесь, что ожидаете browserContext.close() для сохранения HAR.

  • recordVideo Объект (необязательно)

    • dir строка

      Путь к каталогу для размещения видео.

    • size Объект (необязательно)

      • width число

        Ширина кадра видео.

      • height число

        Высота кадра видео.

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

    Включает запись видео для всех страниц в каталог recordVideo.dir. Если не указано, видео не записываются. Убедитесь, что ожидаете browserContext.close() для сохранения видео.

  • reducedMotion null | "reduce" | "no-preference" (необязательно)

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

  • screen Объект (необязательно)

    • width число

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

    • height число

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

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

  • serviceWorkers "allow" | "block" (необязательно)

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

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

  • slowMo число (необязательно)

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

  • strictSelectors логическое (необязательно)

    Если установлено в true, включает режим строгих селекторов для этого контекста. В режиме строгих селекторов все операции над селекторами, предполагающие единственный целевой элемент DOM, будут вызывать исключение, когда более одного элемента соответствует селектору. Эта опция не влияет на API Locator (Locators всегда строгие). По умолчанию false. См. Locator, чтобы узнать больше о строгом режиме.

  • timeout число (необязательно)

    Максимальное время в миллисекундах ожидания запуска экземпляра браузера. По умолчанию 30000 (30 секунд). Передайте 0 чтобы отключить таймаут.

  • timezoneId строка (необязательно)

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

  • tracesDir строка (необязательно)

    Если указано, трассировки сохраняются в этот каталог.

  • userAgent строка (необязательно)

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

• • videoSize Объект (необязательно)

    Устаревший

    Используйте recordVideo вместо него.

    • width число

      Ширина кадра видео.

    • height число

      Высота кадра видео.

  • videosPath строка (необязательно)

    Устаревший

    Используйте recordVideo вместо него.

  • viewport null | Объект (необязательно)

    • width число

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

    • height число

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

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

    примечание

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

Возвращает

• Promise<BrowserContext>

launchServer​

Возвращает экземпляр приложения браузера. Вы можете подключиться к нему с помощью browserType.connect(), которое требует совпадения основных/дополнительных версий клиента/сервера (1.2.3 → совместимо с 1.2.x).

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

Запускает сервер браузера, к которому клиент может подключиться. Пример запуска исполняемого файла браузера и подключения к нему позже:

const { chromium } = require('playwright');  // Or 'webkit' or 'firefox'.

(async () => {
  const browserServer = await chromium.launchServer();
  const wsEndpoint = browserServer.wsEndpoint();
  // Use web socket endpoint later to establish a connection.
  const browser = await chromium.connect(wsEndpoint);
  // Close browser instance.
  await browserServer.close();
})();

Аргументы

• options Объект (необязательно)

• • args Массив<строка> (необязательно)

    предупреждение

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

    Дополнительные аргументы для передачи экземпляру браузера. Список флагов Chromium можно найти здесь.

  • channel строка (необязательно)

    Канал дистрибуции браузера. Поддерживаемые значения: «chrome», «chrome-beta», «chrome-dev», «chrome-canary», «msedge», «msedge-beta», «msedge-dev», «msedge-canary». Дополнительную информацию об использовании Google Chrome и Microsoft Edge можно найти по этой ссылке.

  • chromiumSandbox логическое значение (необязательно)

    Включить песочницу Chromium. По умолчанию false.

  • devtools логическое значение (необязательно)

    Устарело

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

    Только для Chromium Автоматически открывать панель инструментов разработчика для каждого вкладки. Если этот параметр true, то параметр headless будет установлен false.

  • downloadsPath строка (необязательно)

    Если указано, принятые для загрузки файлы будут загружаться в эту директорию. В противном случае создается временная директория, которая удаляется при закрытии браузера. В любом случае, загрузки удаляются при закрытии контекста браузера, в котором они были созданы.

  • env Объект<строка, строка | число | логическое значение> (необязательно)

    Укажите переменные среды, которые будут видны браузеру. По умолчанию process.env.

  • executablePath строка (необязательно)

    Путь к исполняемому файлу браузера для запуска вместо встроенного. Если executablePath — относительный путь, то он разрешается относительно текущей рабочей директории. Обратите внимание, что Playwright работает только со встроенным Chromium, Firefox или WebKit, используйте на свой страх и риск.

  • firefoxUserPrefs Объект<строка, строка | число | логическое значение> (необязательно)

    Настройки пользовательских предпочтений Firefox. Узнайте больше о пользовательских предпочтениях Firefox на about:config.

  • handleSIGHUP логическое значение (необязательно)

    Закрыть процесс браузера при получении SIGHUP. По умолчанию true.

  • handleSIGINT логическое значение (необязательно)

    Закрыть процесс браузера при нажатии Ctrl-C. По умолчанию true.

  • handleSIGTERM логическое значение (необязательно)

    Закрыть процесс браузера при получении SIGTERM. По умолчанию true.

  • headless логическое значение (необязательно)

    Запускать браузер в режиме headless. Дополнительные сведения для Chromium и Firefox. По умолчанию true, если параметр devtools равен true.

  • host строка (необязательно)

    Хост для использования в веб-сокет. Необязательно; если не указано, сервер будет принимать подключения по неявному IPv6-адресу (::), если IPv6 доступен, или неявному IPv4-адресу (0.0.0.0) в противном случае. Рекомендуется уточнение с выбором конкретного интерфейса.

  • ignoreDefaultArgs логическое значение | Массив<строка> (необязательно)

    Если true, Playwright не передаёт собственные параметры конфигурации и использует только параметры из args. Если указан массив, отфильтровываются заданные параметры по умолчанию. Опасный параметр; использовать с осторожностью. По умолчанию false.

  • logger Журнал (необязательно)

    Поток-приёмник для записи логов Playwright.

  • port число (необязательно)

    Порт для веб-соккета. По умолчанию 0, что выбирает любой доступный порт.

  • proxy Объект (необязательно)

    • server строка

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

    • bypass строка (необязательно)

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

    • username строка (необязательно)

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

    • password строка (необязательно)

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

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

  • timeout число (необязательно)

    Максимальное время в миллисекундах ожидания запуска экземпляра браузера. По умолчанию 30000 (30 секунд). Передайте 0 для отключения таймаута.

  • tracesDir строка (необязательно)

    Если указано, трассировки сохраняются в эту директорию.

  • wsPath строка (необязательно)

    Путь для обслуживания сервера браузера. Для безопасности по умолчанию используется непредсказуемая строка.

    предупреждение

    Любой процесс или веб-страница (включая те, которые работают в Playwright) с доступом к wsPath может получить контроль над пользователем ОС. По этой причине при использовании этого параметра следует использовать непредсказуемый токен.

Возвращает

• Promise<BrowserServer>

Имя​

Возвращает имя браузера. Например: 'chromium', 'webkit' или 'firefox'.

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

browserType.name();

Возвращает

• строка