Respuesta
Page Object Model (POM) es un patrón donde cada página o componente se modela como una clase. La clase encapsula los localizadores y expone acciones de negocio. Los tests usan esas acciones y no tocan el DOM directamente.
Qué resuelve
- Mantenimiento: si cambia un selector, se corrige en un solo lugar y no en 40 tests.
- Legibilidad: el test se lee como un flujo de negocio.
- Reutilización: login, navegación y formularios comunes se escriben una vez.
class LoginPage {
constructor(page) { this.page = page; }
async login(user, pass) {
await this.page.getByLabel('Usuario').fill(user);
await this.page.getByLabel('Contraseña').fill(pass);
await this.page.getByRole('button', { name: 'Ingresar' }).click();
}
}
// test
await new LoginPage(page).login('qa_user', 'secret');
await expect(page.getByRole('heading', { name: 'Panel' })).toBeVisible();Buenas prácticas: las aserciones van en el test y no en el page object. Para pantallas grandes conviene dividir en componentes en vez de armar una clase gigante.
Selectores, en orden de preferencia
- Por rol y nombre accesible, o por label (getByRole, getByLabel). Son estables y además validan accesibilidad.
- Atributos dedicados como data-testid, acordados con desarrollo.
- CSS simple y estable.
- Evitar XPath absolutos, índices, clases generadas por el framework (css-1x2y3) y textos que cambian con la traducción.
Errores comunes
Meter aserciones y lógica de test dentro del page object, o crear clases enormes que replican toda la página. También es común defender XPath absolutos o sleeps fijos como solución a la inestabilidad.
Redactado con el asistente Underc0de IA. Actualizado el 20/11/2026. ¿Ves un error? Contanos en el foro.