API de clases principales de Playwright
Este apéndice enumera las API de uso común de las clases principales de Playwright para una consulta rápida.
Clase Playwright
Playwright es el objeto de entrada de la librería Playwright.
| Métodos/Propiedades | Descripción |
|---|---|
playwright.chromium | Devuelve el objeto BrowserType de Chromium |
playwright.firefox | Devuelve el objeto BrowserType de Firefox |
playwright.webkit | Devuelve el objeto BrowserType de WebKit |
playwright.request | Devuelve el objeto APIRequest |
playwright.selectors | Devuelve el objeto Selectors |
Clase BrowserType
BrowserType se utiliza para iniciar y conectarse a navegadores.
| Métodos | Descripción |
|---|---|
browserType.launch(options?) | Inicia una instancia del navegador |
browserType.launchPersistentContext(userDataDir, options?) | Inicia un Context persistente (utilizando el directorio de datos de usuario local) |
browserType.connect(url, options?) | Se conecta a un navegador que ya está en ejecución |
browserType.connectOverCDP(url, options?) | Se conecta a un navegador en ejecución mediante el protocolo CDP |
browserType.executablePath() | Devuelve la ruta del ejecutable del navegador |
browserType.name() | Devuelve el nombre del navegador |
Clase Browser
Browser representa una instancia del navegador.
| Métodos/Propiedades | Descripción |
|---|---|
browser.newContext(options?) | Crea un nuevo BrowserContext |
browser.newPage(options?) | Crea una nueva Page en un nuevo Context |
browser.contexts() | Devuelve la lista de todos los Context |
browser.close() | Cierra el navegador y todas las páginas |
browser.browserType() | Devuelve el BrowserType correspondiente |
browser.version() | Devuelve la versión del navegador |
browser.isConnected() | Indica si está conectado |
Clase BrowserContext
BrowserContext representa un contexto de navegador independiente.
| Métodos | Descripción |
|---|---|
context.newPage() | Crea una nueva página |
context.pages() | Devuelve todas las páginas abiertas |
context.close() | Cierra el Context |
context.cookies(urls?) | Obtiene las cookies |
context.addCookies(cookies) | Añade cookies |
context.clearCookies() | Elimina todas las cookies |
context.storageState(options?) | Obtiene el estado de almacenamiento actual (para reutilizar la autenticación) |
context.grantPermissions(permissions) | Otorga permisos |
context.clearPermissions() | Limpia los permisos |
context.setGeolocation(geolocation) | Establece la ubicación geográfica |
context.setExtraHTTPHeaders(headers) | Establece cabeceras HTTP adicionales |
context.route(url, handler) | Intercepta solicitudes de red |
context.unroute(url, handler?) | Cancela la interceptación |
context.exposeFunction(name, fn) | Expone funciones a la página |
context.exposeBinding(name, callback) | Expone bindings a la página |
Clase BrowserServer
BrowserServer representa, a través delaunchServer()el proceso del navegador iniciado.
| Métodos | Descripción |
|---|---|
browserServer.wsEndpoint() | Devuelve la URL del endpoint WebSocket (para conexión remota) |
browserServer.close() | Cierra el servidor y el navegador |
browserServer.kill() | Fuerza la terminación del proceso del navegador |