Extracción y validación de datos en Playwright
La extracción y validación de datos son clave en las pruebas automatizadas, e incluyen principalmenteobtención de datos de la página, aserciones y validación, capturas de pantalla y grabación, no solo puede verificar si la funcionalidad es correcta, sino que también ayuda en la depuración y las pruebas de regresión.
Obtención de información de elementos
En las pruebas, a menudo es necesario leer la información de la página para validarla; Playwright ofrece una amplia gama de API.
1. Obtener contenido de texto
Ejemplo
const text = await page.textContent('#welcome');
console.log(text);
// Obtener el texto de varios elementos
const items = await page.$$eval('.list-item', els => els.map(e => e.textContent));
console.log(items);
2. Obtener valores de atributos
const value = await page.getAttribute('#username', 'placeholder');
console.log(value); // "请输入用户名"
3. Obtener información de estilos
// 获取元素的 style 属性
const color = await page.$eval('#btn', el => getComputedStyle(el).color);
console.log(color);
4. Comprobación del estado de los elementos
await page.isVisible('#dialog'); // 是否可见
await page.isHidden('#loading'); // 是否隐藏
await page.isEnabled('#submit'); // 是否可用
await page.isDisabled('#submit'); // 是否禁用
await page.isChecked('#agree'); // 复选框是否选中
Aserciones y validación
Playwright proporcionauna biblioteca de aserciones integrada(@playwright/test), lo que facilita la escritura de casos de prueba.
1. Métodos de aserción integrados
En@playwright/testEn él, se utilizaexpectpara realizar aserciones.
Ejemplo
test('Ejemplo de validación', async ({ page }) => {
await page.goto('https://example.com');
// Aserción de texto
await expect(page.locator('h1')).toHaveText('Example Domain');
// Aserción de atributo
await expect(page.locator('a')).toHaveAttribute('href', 'https://www.iana.org/domains/example');
// Aserción de visibilidad
await expect(page.locator('h1')).toBeVisible();
});
2. Validación de contenido de texto
await expect(page.locator('#message')).toHaveText('登录成功');
await expect(page.locator('#username')).toHaveValue('testuser');
3. Validación del estado de los elementos
await expect(page.locator('#submit')).toBeEnabled();
await expect(page.locator('#agree')).toBeChecked();
await expect(page.locator('#loading')).toBeHidden();
4. Validación del título de la página y la URL
await expect(page).toHaveTitle(/Playwright/);
await expect(page).toHaveURL('https://playwright.dev/');
Capturas de pantalla y grabación
Las capturas de pantalla y la grabación son muy útiles en la depuración, el análisis de casos fallidos y las pruebas de regresión.
1. Captura de pantalla de la página
await page.screenshot({ path: 'screenshot.png', fullPage: true });
path: ruta de guardadofullPage: si se captura toda la página
2. Captura de pantalla de un elemento
const element = page.locator('#logo');
await element.screenshot({ path: 'logo.png' });
3. Grabación de video
Al crearcontextse habilita la grabación:
const context = await browser.newContext({
recordVideo: { dir: 'videos/' }
});
const page = await context.newPage();
await page.goto('https://example.com');
await context.close(); // 关闭后保存视频
4. Comparación de capturas (pruebas de instantáneas)
Playwright admite la comparación de instantáneas, que se usa a menudo en pruebas de regresión.
import { test, expect } from '@playwright/test';
test('页面快照测试', async ({ page }) => {
await page.goto('https://playwright.dev');
expect(await page.screenshot()).toMatchSnapshot('homepage.png');
});
comparará la captura con la imagen de referenciahomepage.pngy detectará cambios en la UI.
Bien ✅ Entonces voy aCapítulo 6: Extracción y validación de datosañadir uncaso práctico completo, y prepararuna tabla comparativa de API. De esta manera, tendrás tanto casos prácticos como una referencia rápida.
Caso práctico: validación de inicio de sesión y captura de instantánea
Este caso cubre:Extracción de información + validación con aserciones + captura de pantalla de página。
Ejemplo
import { test, expect } from '@playwright/test';
test('El usuario inicia sesión y verifica el resultado', async ({ page }) => {
// 1. Abrir la página de inicio de sesión
await page.goto('https://example.com/login');
// 2. Ingresar nombre de usuario y contraseña
await page.fill('#username', 'testuser');
await page.fill('#password', 'Password123');
// 3. Hacer clic en Iniciar sesión
await page.click('#submit');
// 4. Esperar la redirección y verificar el título
await expect(page).toHaveTitle(/Dashboard/);
// 5. Validar el texto de bienvenida
await expect(page.locator('.welcome')).toHaveText('Bienvenido, testuser');
// 6. Comprobar el estado del botón
await expect(page.locator('#logout')).toBeVisible();
await expect(page.locator('#logout')).toBeEnabled();
// 7. Obtener el atributo de ID de usuario y validarlo
const userId = await page.getAttribute('#user-profile', 'data-id');
console.log('ID de usuario:', userId);
expect(userId).not.toBeNull();
// 8. Captura de pantalla de la página
await page.screenshot({ path: 'login-success.png', fullPage: true });
// 9. Comparación de instantáneas (prueba de regresión de UI)
expect(await page.screenshot()).toMatchSnapshot('dashboard.png');
});
Esta prueba verificará:
- si el título de la página y el texto de bienvenida son correctos
- si los elementos son visibles / están habilitados
- si existe el atributo de información del usuario
- la comparación de capturas de pantalla y snapshots de UI
Tabla de API comunes
A continuación se muestrala extracción y validación de datosuna tabla de las API relacionadas.
| Método | Descripción | Ejemplo |
|---|---|---|
page.textContent(selector) |
Obtener el contenido de texto del elemento | await page.textContent('#msg') |
page.innerText(selector) |
Obtener el texto plano renderizado | await page.innerText('#msg') |
page.innerHTML(selector) |
Obtener el HTML del elemento | await page.innerHTML('#content') |
page.getAttribute(selector, name) |
Obtener el valor de un atributo | await page.getAttribute('#btn', 'class') |
page.$eval(selector, fn) |
Ejecutar una función en el elemento | await page.$eval('#logo', el => el.tagName) |
page.$$eval(selector, fn) |
Ejecutar funciones en lote | await page.$$eval('.item', els => els.length) |
page.isVisible(selector) |
Si es visible | await page.isVisible('#dialog') |
page.isHidden(selector) |
Si está oculto | await page.isHidden('#loading') |
page.isEnabled(selector) |
Si está habilitado | await page.isEnabled('#submit') |
page.isDisabled(selector) |
Si está deshabilitado | await page.isDisabled('#submit') |
page.isChecked(selector) |
Si está seleccionado | await page.isChecked('#agree') |
Aserciones y validación (@playwright/test)
| Método | Descripción | Ejemplo |
|---|---|---|
expect(locator).toHaveText(value) |
Validar texto | expect(page.locator('h1')).toHaveText('欢迎') |
expect(locator).toHaveValue(value) |
Validar el valor del campo de entrada | expect(page.locator('#user')).toHaveValue('test') |
expect(locator).toHaveAttribute(name, value) |
Validar atributo | expect(page.locator('#btn')).toHaveAttribute('type', 'submit') |
expect(locator).toBeVisible() |
Elemento visible | expect(page.locator('#msg')).toBeVisible() |
expect(locator).toBeHidden() |
Elemento oculto | expect(page.locator('#loading')).toBeHidden() |
expect(locator).toBeEnabled() |
Elemento habilitado | expect(page.locator('#submit')).toBeEnabled() |
expect(locator).toBeDisabled() |
Elemento deshabilitado | expect(page.locator('#submit')).toBeDisabled() |
expect(locator).toBeChecked() |
Elemento seleccionado | expect(page.locator('#agree')).toBeChecked() |
expect(page).toHaveTitle(title) |
Validación del título de la página | expect(page).toHaveTitle(/Dashboard/) |
expect(page).toHaveURL(url) |
Validación de la URL de la página | expect(page).toHaveURL('https://example.com/dashboard') |
Capturas de pantalla y grabación
| Método | Descripción | Ejemplo |
|---|---|---|
page.screenshot(options) |
Captura de pantalla de la página | await page.screenshot({ path: 'page.png' }) |
locator.screenshot(options) |
Captura de pantalla del elemento | await page.locator('#logo').screenshot({ path: 'logo.png' }) |
context = browser.newContext({ recordVideo }) |
Activar la grabación de video | recordVideo: { dir: 'videos/' } |
expect(await page.screenshot()).toMatchSnapshot(name) |
Comparación de capturas (prueba de instantáneas) | expect(await page.screenshot()).toMatchSnapshot('home.png') |