---
title: 'Guía de pruebas automatizadas con Selenium'
---

<style>
.two-column-layout {
column-count: 2; /* Set column number */
column-gap: 20px;
max-width: 100%;
overflow: hidden;
}

/* Media query for mobile devices */
@media (max-width: 768px) {
.two-column-layout {
column-count: 1; /* Switch to single column on small screens */
column-gap: 0; /* Optional: Set gap to 0 for single column */
}
}

.markdown-body, .ui-infobar {
max-width: unset !important;
}

.two-column-layout ul,
.two-column-layout ol {
margin: 0;
padding-left: 20px;
}

.two-column-layout strong {
font-weight: bold;
}

.two-column-layout em {
font-style: italic;
}

.two-column-layout h1,
.two-column-layout h2,
.two-column-layout h3,
.two-column-layout h4,
.two-column-layout h5,
.two-column-layout h6 {
margin-top: 0;
}
</style>

# Guía de pruebas automatizadas con Selenium IDE

Dentro de este documento se especifican las guías de ayuda y buenas prácticas para la ejecución de pruebas automatizadas básicas con Selenium.

&nbsp;

## Funcionamiento general de la herramienta

Selenium IDE es una herramienta visual de automatización que permite:

* Abrir una página web.
* Grabar acciones reales del usuario (clicks, escritura, selecciones).
* Reproducir esas acciones automáticamente.
* Validar que el sistema funcione correctamente.

**No es necesario saber programar para usar Selenium IDE.**

El software captura las acciones del usuario y después permite ejecutar esa misma secuencia en el sistema, ofreciendo opciones para cambiar los inputs del usuario, o agregando eventos adicionales en la secuencia originalmente capturada.

Selenium IDE graba las acciones que se realicen, pero es importante agregar validaciones a la secuencia generada para validar los diversos escenarios dentro de las pruebas.

Por su naturaleza, las pruebas más sencillas de integrar con Selenium IDE son de regresión, y es indispensable que se intente automatizar las mismas para ahorrar tiempo en las pruebas de las funcionalidades del sistema.

## Descarga e instalación de Selenium IDE

1. Descargar el software de Selenium IDE desde la página oficial: [Selenium IDE](https://www.selenium.dev/selenium-ide/), en su versión de escritorio o extensión para navegador (Firefox).
2. Instalar el software adquirido siguiendo los pasos del instalador de Selenium.

NOTA: La extensión de Chrome ya no se encuentra actualmente disponible para su descarga, si se quiere usar una extensión de navegador debe ser para Firefox.

## Crear proyecto de pruebas

1. Abrir Selenium IDE desde la extensión de Firefox o la aplicación de escritorio, según sea el caso.
2. Seleccionar `Create a new project`.
3. Asignar un nombre al proyecto
Ejemplo:
`Pruebas MA-ERP`
4. Ingresar la Base URL del sistema
Ejemplo:
https://sistema.ejemplo.com

El proyecto agrupa todas las pruebas relacionadas a ese sistema.

## Crear y grabar un caso de prueba

**¿Qué es un caso de prueba?**
Es un conjunto de pasos que validan una funcionalidad específica del sistema.

Pasos para grabar:

1. En Selenium IDE, seleccionar `Record a new test`.
2. Asignar un nombre claro al test. (ID Funcionalidad - ID Caso de prueba - Nombre de la prueba)
Ejemplo:
`FN001-CP01-Login_Exitoso`
3. Selenium abrirá automáticamente una nueva pestaña. (cargará la vista correspondiente a la URL ingresada en URL Base)
4. Realizar las acciones manualmente, como lo haría un usuario:
-Escribir usuario y contraseña
-Dar clic en “Iniciar sesión”
-Navegar por el sistema
5. Cuando termine el flujo, presionar **Stop** en Selenium IDE.

Selenium registrará cada acción realizada.

## Reproducir un caso de prueba

1. Seleccionar el test grabado.
2. Presionar Run current test.
3. Selenium ejecutará automáticamente los pasos grabados y mostrará si:
-El test fue exitoso (verde)
-El test falló (rojo)

## Agregar validaciones

Grabar acciones no es suficiente, un buen caso de prueba debe validar los resultados. De otra manera, al reproducir las grabaciones de nuestras acciones, esto solo sería una navegación dentro del sistema, no una prueba real de la funcionalidad.

**Validaciones básicas recomendadas:**

* Que se muestre un texto esperado
* Que exista un botón o elemento
* Que la URL sea correcta
* Que aparezca un mensaje de éxito o error

**Ejemplos de validaciones en Selenium IDE:**

* assert text
* assert element present
* assert title
* assert value

### assert text
**¿Qué valida?**
Verifica que un texto específico esté presente en un elemento de la pantalla.

**¿Cuándo usarlo?**
* Confirmar mensajes de éxito o error
* Validar títulos de pantalla
* Verificar etiquetas, encabezados o estados visibles

**Ejemplos comunes**

* “Bienvenido”
* “Registro guardado correctamente”
* “Error de autenticación”
* “Tablero Kanban”

**Ejemplo práctico**

Después de hacer login:
Objetivo: Validar que el usuario entró correctamente.

Command: assert text
Target: css=h1.dashboard-title
Value: Bienvenido

Si el texto no aparece, el test falla.

**Buenas prácticas**
* Usar textos claros y estables
* Evitar textos que cambian dinámicamente (fechas, IDs)
* No validar textos demasiado largos

### assert element present

**¿Qué valida?**
Verifica que un elemento exista en la página, sin importar su contenido.

**¿Cuándo usarlo?**

* Validar que una pantalla cargó
* Confirmar que un botón, tabla o formulario está disponible
* Verificar que una acción generó un nuevo elemento

**Ejemplos comunes**

* Botón “Guardar”
* Tabla de resultados
* Modal abierto
* Tarjeta creada en Kanban

**Ejemplo práctico**

Después de entrar al módulo de Tableros Kanban:

Command: assert element present
Target: css=button#create-card

Si el botón no existe, el test falla.

**Buenas prácticas**

* Ideal para validar navegación
* Útil cuando el texto no es confiable
* No usar selectores frágiles (muy largos)

### assert title
**¿Qué valida?**
Verifica el título de la página (lo que aparece en la pestaña del navegador).

**¿Cuándo usarlo?**
* Confirmar que se abrió la página correcta
* Validar navegación entre módulos
* Pruebas de smoke básicas

**Ejemplo práctico**

Al abrir el sistema:

Command: assert title
Target: Sistema de Gestión Kanban

Si el título no coincide, falla.

**Buenas prácticas**

* Útil para pruebas rápidas
* Muy estable
* No sirve para validar lógica interna

### assert value
**¿Qué valida?**
Verifica el valor contenido en un input o campo editable.

¿Cuándo usarlo?

* Validar que un campo se llenó correctamente
* Confirmar datos precargados
* Revisar que una edición se aplicó

**Ejemplos comunes**

* Email cargado
* Nombre del usuario
* Valor de un filtro
* Campo editable de una tarjeta

**Ejemplo práctico**

Después de editar una tarjeta:

Command: assert value
Target: css=input[name="title"]
Value: Corregir error de login

**Buenas prácticas**

* Muy útil para formularios
* Ideal para flujos de edición
* No usar si el campo se llena dinámicamente por backend sin sincronización

### Diferencia entre assert y verify

| Tipo | ¿Qué pasa si falla? |
| -------- | -------- |
| assert | El test se detiene |
| verify | El test continua |

## Organización de casos de prueba

**Convención de nombres**
Usar nombres claros y consistentes, incluyendo el ID de la funcionalidad, el ID del caso de prueba y el nombre de la prueba:

FN001-CP01_Login_Exitoso
FN002-CP02_Login_Usuario_Invalido
FN003-CP03_Crear_Tarjeta_Kanban
FN004-CP04_Mover_Tarjeta_Columna

Esto permite:
* Identificar rápidamente qué se prueba
* Relacionar el test con una funcionalidad.

Los nombres de los tests de pruebas deben estar relacionados con el ID del caso de prueba diseñado en la matriz de pruebas del proyecto.

## Organización en sets de pruebas
**¿Qué es un set de pruebas?**
Un set de pruebas es un grupo de casos que se ejecutan juntos.

Ejemplos de agrupaciones de sets comunes:

1. Smoke Tests
-Login
-Acceso al dashboard
-Navegación básica

2. Pruebas por módulo
-Kanban
-Usuarios
-Reportes

Ejecutar un set de pruebas reproducirá todos los casos de pruebas que contiene. Para que un set de pruebas pueda considerarse como pasado, todos los casos de prueba deben pasarse también.

## Errores comunes y cómo evitarlos

**Error:** el test falla por tiempos de carga
**Solución:** usar comandos de espera (waitForElementVisible)

**Error:** el test se rompe al cambiar el diseño
**Solución:** usar selectores estables (IDs o data-testid)

**Error:** grabar todo en un solo test gigante, puede ocasionar laggeo en la ejecución de las pruebas
**Solución:** dividir en varios casos pequeños

**Error:** no se registran mis acciones en la secuencia de steps de Selenium
**Solución:** esperar a que el sistema registre la acción realizada, debe salir en la esquina inferior derecha de la ventana en donde se graba la pantalla