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

// Obtener el texto de un solo elemento
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

import { test, expect } from '@playwright/test';

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 guardado
  • fullPage: 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

// login-test.spec.js
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')
Otras extensiones