Playwright Test y Reporter API
Este apéndice enumera las API de configuración, Fixture, Reporter, etc. de Playwright Test Runner.
Función Test
| Método | Descripción |
|---|
test(name, fn) | Definir prueba |
test.describe(name, fn) | Definir grupo de pruebas |
test.describe.serial(name, fn) | Grupo de pruebas en serie |
test.describe.parallel(name, fn) | Grupo de pruebas en paralelo |
test.describe.configure(options) | Configurar el comportamiento del grupo (mode, retries) |
test.skip(name?, fn?) | Omitir prueba |
test.fail(name?, fn?) | Marcar como fallo esperado |
test.fixme(name?, fn?) | Marcar como pendiente de reparación |
test.slow(name?, fn?) | Marcar como prueba lenta (tiempo de espera ×3) |
test.only(name, fn) | Ejecutar solo esta prueba |
test.beforeEach(fn) | Ejecutar antes de cada prueba |
test.afterEach(fn) | Ejecutar después de cada prueba |
test.beforeAll(fn) | Ejecutar una vez antes de todas las pruebas |
test.afterAll(fn) | Ejecutar una vez después de todas las pruebas |
test.extend(fixtures) | Crear Fixture personalizado |
test.use(options) | Anular la configuración del ámbito actual |
test.setTimeout(ms) | Establecer el tiempo de espera de la prueba actual |
test.step(name, fn) | Definir pasos de prueba (visibles en el informe) |
test.info() | Obtener el objeto TestInfo |
Interfaz de configuración TestConfig
| Campo | Tipo | Descripción |
|---|
testDir | string | Directorio de pruebas |
fullyParallel | boolean | Totalmente paralelo |
workers | number | Número de workers |
retries | number | Número de reintentos |
timeout | number | Tiempo de espera total de la prueba |
reporter | string | array | Reporter |
forbidOnly | boolean | Prohibironly |
testMatch | string | RegExp | Patrón de coincidencia de pruebas |
testIgnore | string | RegExp | Patrón de exclusión |
projects | Project[] | Lista de proyectos |
webServer | object | Configuración del servidor web |
globalSetup | string | Ruta del script de Setup global |
globalTeardown | string | Ruta del script de Teardown global |
use | object | Configuración compartida |
expect | object | Configuración de aserciones |
Interfaz TestInfo
| Campos/Métodos | Descripción |
|---|
testInfo.title | Nombre de la prueba |
testInfo.file | Ruta del archivo de prueba |
testInfo.line | Número de línea de la prueba |
testInfo.column | Número de columna de la prueba |
testInfo.expectedStatus | Estado esperado:'passed' | 'failed' | 'skipped' |
testInfo.timeout | Tiempo de espera de la prueba actual |
testInfo.annotations | Lista de anotaciones |
testInfo.attachments | Lista de adjuntos |
testInfo.project.name | Nombre del proyecto actual |
testInfo.retry | Número de reintentos actual |
testInfo.parallelIndex | Índice paralelo |
testInfo.skip(reason?) | Omitir prueba (dinámico) |
testInfo.fail(reason?) | Marcar como fallo (dinámico) |
testInfo.attach(name, options?) | Adjuntar archivo al informe |
Interfaz Fixtures
| Fixture | Tipo | Descripción |
|---|
page | Page | Pestaña del navegador |
context | BrowserContext | Contexto del navegador |
browser | Browser | Instancia del navegador |
browserName | string | Nombre del navegador |
request | APIRequestContext | Cliente de solicitudes HTTP |
Interfaz WorkerInfo
| Campo | Descripción |
|---|
workerInfo.project.name | Nombre del proyecto |
workerInfo.parallelIndex | Índice paralelo del worker |
workerInfo.config | Objeto FullConfig |
Interfaz Reporter
| Método | Descripción |
|---|
reporter.onBegin(config, suite) | Inicio de la prueba |
reporter.onTestBegin(test) | Inicio de una prueba individual |
reporter.onTestEnd(test, result) | Fin de una prueba individual |
reporter.onStepBegin(test, result, step) | Inicio del paso |
reporter.onStepEnd(test, result, step) | Fin del paso |
reporter.onEnd(result) | Fin de la prueba |
reporter.onExit() | Salida del proceso |
reporter.printsToStdio() | Si se emite a la salida estándar |
Clase Suite
| Campo | Descripción |
|---|
suite.title | Nombre de la Suite |
suite.suites | Lista de sub-suites |
suite.tests | Lista de pruebas |
suite.location | Ubicación de la Suite |
Clase TestCase
| Campo | Descripción |
|---|
test.title | Nombre de la prueba |
test.location | Ubicación de la prueba |
test.expectedStatus | Estado esperado |
test.annotations | Lista de anotaciones |
test.parent | Suite a la que pertenece |
test.id() | ID de la prueba |
Clase TestResult
| Campo | Descripción |
|---|
result.status | Estado:'passed' | 'failed' | 'skipped' | 'interrupted' |
result.duration | Duración de la ejecución (milisegundos) |
result.error | Información del error (TestError) |
result.attachments | Lista de adjuntos |
result.stdout | Salida estándar |
result.stderr | Error estándar |
Electron API
| Método | Descripción |
|---|
electron.launch(options?) | Iniciar aplicación Electron |
Clase ElectronApplication
| Método | Descripción |
|---|
electronApp.firstWindow() | Obtener la primera ventana |
electronApp.windows() | Obtener todas las ventanas |
electronApp.close() | Cerrar aplicación |
Android API
| Métodos/Clases | Descripción |
|---|
android.devices() | Obtener la lista de dispositivos conectados |
AndroidDevice | Objeto de dispositivo Android |
AndroidWebView | Objeto WebView |
Otras extensiones