API основных классов Playwright

В этом приложении перечислены общие API основных классов Playwright для быстрого ознакомления.


Класс Playwright

Playwright — это входной объект библиотеки Playwright.

Методы/СвойстваОписание
playwright.chromiumВозвращает объект BrowserType для Chromium
playwright.firefoxВозвращает объект BrowserType для Firefox
playwright.webkitВозвращает объект BrowserType для WebKit
playwright.requestВозвращает объект APIRequest
playwright.selectorsВозвращает объект Selectors

Класс BrowserType

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

МетодыОписание
browserType.launch(options?)Запускает экземпляр браузера
browserType.launchPersistentContext(userDataDir, options?)Запускает постоянный контекст (используя локальный каталог данных пользователя)
browserType.connect(url, options?)Подключается к уже запущенному браузеру
browserType.connectOverCDP(url, options?)Подключается к уже запущенному браузеру через протокол CDP
browserType.executablePath()Возвращает путь к исполняемому файлу браузера
browserType.name()Возвращает имя браузера

Класс Browser

Browser представляет экземпляр браузера.

Методы/СвойстваОписание
browser.newContext(options?)Создаёт новый BrowserContext
browser.newPage(options?)Создает новую Page в новом Context
browser.contexts()Возвращает список всех Contexts
browser.close()Закрывает браузер и все страницы
browser.browserType()Возвращает соответствующий BrowserType
browser.version()Возвращает версию браузера
browser.isConnected()Подключен ли

Класс BrowserContext

BrowserContext представляет независимый контекст браузера.

МетодыОписание
context.newPage()Создает новую страницу
context.pages()Возвращает все открытые страницы
context.close()Закрывает Context
context.cookies(urls?)Получает cookies
context.addCookies(cookies)Добавляет cookies
context.clearCookies()Очищает все cookies
context.storageState(options?)Получает текущее состояние хранилища (для повторного использования аутентификации)
context.grantPermissions(permissions)Предоставляет разрешения
context.clearPermissions()Очищает разрешения
context.setGeolocation(geolocation)Устанавливает геолокацию
context.setExtraHTTPHeaders(headers)Устанавливает дополнительные HTTP-заголовки
context.route(url, handler)Перехватывает сетевые запросы
context.unroute(url, handler?)Отменяет перехват
context.exposeFunction(name, fn)Делает функцию доступной на странице
context.exposeBinding(name, callback)Делает привязку доступной на странице

Класс BrowserServer

BrowserServer представляет процесс браузера, запущенный черезlaunchServer()запущенный процесс браузера.

МетодыОписание
browserServer.wsEndpoint()Возвращает URL конечной точки WebSocket (для удалённого подключения)
browserServer.close()Закрывает сервер и браузер
browserServer.kill()Принудительно завершает процесс браузера
Другие расширения