Tutorial de Playwright

Playwright Test y Reporter API

Otras API de Playwright

Este apéndice enumera las API de las clases auxiliares como Dialog, Download, Video, Tracing, etc.

Clase Dialog

Métodos	Descripción
`dialog.accept(promptText?)`	Confirmar diálogo
`dialog.dismiss()`	Cancelar diálogo
`dialog.message()`	Mensaje del diálogo
`dialog.type()`	Tipo de diálogo:`'alert'` \| `'confirm'` \| `'prompt'` \| `'beforeunload'`
`dialog.defaultValue()`	Valor de entrada predeterminado del diálogo
`dialog.page()`	Página a la que pertenece el diálogo

Clase Download

Métodos	Descripción
`download.saveAs(path)`	Guardar archivo en la ruta especificada
`download.suggestedFilename()`	Obtener el nombre de archivo sugerido
`download.url()`	URL de descarga
`download.page()`	Página a la que pertenece
`download.failure()`	Información de fallo de descarga (devuelve null si no hay fallo)
`download.delete()`	Eliminar el archivo descargado

Clase FileChooser

Métodos	Descripción
`fileChooser.setFiles(files, options?)`	Seleccionar archivos
`fileChooser.isMultiple()`	Indica si es modo de selección múltiple
`fileChooser.page()`	Página a la que pertenece

Clase ConsoleMessage

Métodos	Descripción
`consoleMessage.type()`	Tipo de mensaje:`'log'` \| `'error'` \| `'warning'` \| `'info'` \| `'debug'`
`consoleMessage.text()`	Texto del mensaje
`consoleMessage.location()`	Ubicación de origen del mensaje
`consoleMessage.args()`	Parámetros del mensaje (array de JSHandle)

Clase Video

Métodos	Descripción
`video.saveAs(path)`	Guardar video en un archivo
`video.delete()`	Eliminar archivo de video
`video.path()`	Ruta del archivo de video

Clase Tracing

Métodos	Descripción
`tracing.start(options?)`	Iniciar grabación de Trace
`tracing.startChunk(options?)`	Iniciar un nuevo bloque de Trace
`tracing.stopChunk(options?)`	Detener el bloque de Trace y guardar
`tracing.stop(options?)`	Detener la grabación y guardar Trace

Clase Clock

Métodos	Descripción
`clock.install(options?)`	Instalar reloj simulado
`clock.pauseAt(time)`	Pausar en el tiempo especificado
`clock.resume()`	Reanudar la ejecución
`clock.setFixedTime(time)`	Establecer tiempo fijo
`clock.fastForward(time)`	Adelantar el tiempo
`clock.runFor(time)`	Ejecutar durante el tiempo especificado

Clase Selectors

Métodos	Descripción
`selectors.register(name, script, options?)`	Registrar motor de selectores personalizado

Clase ElementHandle

Métodos	Descripción
`elementHandle.click(options?)`	Clic
`elementHandle.fill(value)`	Rellenar texto
`elementHandle.screenshot(options?)`	Captura de pantalla del elemento
`elementHandle.boundingBox()`	Obtener posición y tamaño
`elementHandle.getAttribute(name)`	Obtener atributo
`elementHandle.textContent()`	Obtener texto
`elementHandle.ownerFrame()`	Frame al que pertenece

Clase JSHandle

Métodos	Descripción
`jsHandle.evaluate(fn, arg?)`	Ejecutar JS
`jsHandle.getProperty(name)`	Obtener propiedad
`jsHandle.getProperties()`	Obtener todas las propiedades
`jsHandle.jsonValue()`	Obtener valor JSON
`jsHandle.dispose()`	Liberar recursos

Clase CDPSession

Métodos	Descripción
`cdpSession.send(method, params?)`	Enviar comando CDP
`cdpSession.detach()`	Desconectar sesión CDP

Clase Worker

Métodos/Eventos	Descripción
`worker.url()`	Worker URL
`worker.evaluate(fn, arg?)`	Ejecutar JS en el Worker
`worker.on('close', handler)`	Evento de cierre del Worker

Clase Frame

Métodos	Descripción
`frame.name()`	Nombre del Frame
`frame.url()`	Frame URL
`frame.goto(url, options?)`	Navegación del Frame
`frame.locator(selector)`	Localización por CSS/XPath
`frame.getByRole(role, options?)`	Localizar por rol
`frame.getByText(text)`	Localizar por texto
`frame.evaluate(fn, arg?)`	Ejecutar JS
`frame.content()`	Obtener contenido HTML
`frame.parentFrame()`	Frame padre
`frame.childFrames()`	Lista de frames hijos

Clases de error

Clase	Descripción
`PlaywrightException`	Excepción general de Playwright
`TimeoutError`	Error de tiempo de espera (timeout de aserción, timeout de operación, etc.)

Otras extensiones

Playwright Test y Reporter API