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() | Принудительно завершает процесс браузера |