Command-line Runner (SIDE Runner)

Instalación y configuración del runner

El Command-line Runner de Selenium IDE, también conocido como SIDE Runner, es una herramienta que permite ejecutar nuestros archivos .side directamente desde la terminal sin necesidad de abrir el navegador manualmente. Esta funcionalidad transforma nuestros tests grabados en la extensión en scripts automatizados que pueden ejecutarse en servidores, sistemas de integración continua o simplemente desde la línea de comandos de nuestro equipo local.

¿Por qué usar el command-line runner?

El SIDE Runner nos ofrece ventajas significativas para equipos de QA profesionales:

• Automatización completa: Los tests se ejecutan sin intervención manual, ideal para validaciones nocturnas o periódicas
• Integración con CI/CD: Posibilita incluir nuestros tests en pipelines de despliegue automático
• Ejecución en segundo plano: Los tests corren sin ocupar nuestra interfaz gráfica
• Reporting automatizado: Genera informes de resultados en formatos procesables por sistemas externos

Requisitos previos

Antes de instalar el SIDE Runner, necesitamos tener Node.js instalado en nuestro sistema. Node.js es el entorno de ejecución que permite al runner funcionar correctamente.

Para verificar si Node.js está instalado, abrimos una terminal y ejecutamos:

node --version

Si no tenemos Node.js instalado, debemos descargarlo desde su sitio web oficial. Se recomienda la versión LTS (Long Term Support) para mayor estabilidad.

Instalación del SIDE Runner

La instalación del runner se realiza mediante npm (Node Package Manager), que se instala automáticamente con Node.js. El comando de instalación es sencillo:

npm install -g selenium-side-runner

El parámetro -g indica una instalación global, lo que significa que el runner estará disponible desde cualquier directorio de nuestro sistema. Esta instalación puede tardar unos minutos, ya que descarga todas las dependencias necesarias.

Instalación de drivers de navegador

El SIDE Runner requiere drivers específicos para cada navegador donde queramos ejecutar nuestros tests. Estos drivers actúan como intermediarios entre el runner y el navegador.

Para Chrome (el más comúnmente usado):

npm install -g chromedriver

Para Firefox:

npm install -g geckodriver

Para Edge:

npm install -g edgedriver

Es importante mantener estos drivers actualizados con las versiones de nuestros navegadores. Un driver desactualizado puede causar fallos en la ejecución de los tests.

Verificación de la instalación

Una vez completada la instalación, podemos verificar que todo funciona correctamente ejecutando:

selenium-side-runner --version

Este comando debe mostrar la versión instalada del runner, confirmando que la instalación fue exitosa.

Configuración básica

El SIDE Runner utiliza un archivo de configuración opcional que nos permite personalizar el comportamiento de ejecución. Este archivo, llamado .side.yml, se coloca en el directorio raíz de nuestro proyecto.

Un ejemplo de configuración básica incluye:

capabilities:
  browserName: "chrome"
timeout: 15000
baseUrl: "https://miapp.ejemplo.com"

Las opciones de configuración más relevantes son:

• browserName: Especifica qué navegador usar (chrome, firefox, edge)
• timeout: Tiempo máximo de espera para elementos en milisegundos
• baseUrl: URL base que se antepone a rutas relativas en nuestros tests
• headless: Ejecuta el navegador en modo sin interfaz gráfica (true/false)

Consideraciones para equipos

En entornos de equipo, es recomendable documentar la versión específica del SIDE Runner utilizada para garantizar consistencia entre diferentes máquinas. Esto se puede hacer creando un archivo package.json en el directorio del proyecto:

{
  "devDependencies": {
    "selenium-side-runner": "^3.17.0"
  }
}

De esta manera, cualquier miembro del equipo puede instalar la versión exacta usando npm install, manteniendo la compatibilidad entre diferentes entornos de desarrollo y producción.

Ejecución automatizada desde terminal

Una vez configurado el SIDE Runner, podemos ejecutar nuestros tests directamente desde la línea de comandos. Esta capacidad transforma por completo la forma en que gestionamos nuestras pruebas, permitiendo automatizar procesos que antes requerían intervención manual constante.

Comando básico de ejecución

El comando fundamental para ejecutar un archivo .side es extremadamente sencillo. Desde la terminal, navegamos al directorio donde se encuentra nuestro archivo de proyecto y ejecutamos:

selenium-side-runner miproyecto.side

Este comando iniciará automáticamente una instancia del navegador, ejecutará todos los tests contenidos en el proyecto y mostrará los resultados en tiempo real en la terminal. El navegador se abrirá, ejecutará las acciones grabadas y se cerrará automáticamente al finalizar.

Selección de navegador específico

Por defecto, el runner utiliza Chrome, pero podemos especificar un navegador diferente usando el parámetro -c:

selenium-side-runner -c "browserName=firefox" miproyecto.side

selenium-side-runner -c "browserName=edge" miproyecto.side

Esta flexibilidad nos permite validar la compatibilidad de nuestras aplicaciones en diferentes navegadores sin modificar nuestros tests.

Ejecución en modo headless

Para ejecutar tests sin mostrar la interfaz gráfica del navegador, utilizamos el modo headless. Esto es especialmente útil en servidores o cuando queremos ejecutar tests en segundo plano:

selenium-side-runner -c "browserName=chrome headless=true" miproyecto.side

En modo headless, los tests se ejecutan significativamente más rápido y consumen menos recursos del sistema, siendo ideal para validaciones automáticas frecuentes.

Ejecución de tests específicos

Cuando nuestro proyecto contiene múltiples tests, podemos ejecutar únicamente aquellos que necesitemos mediante el parámetro --filter:

selenium-side-runner --filter "Login*" miproyecto.side

Este comando ejecutará únicamente los tests cuyo nombre comience con "Login". También podemos usar patrones más específicos:

selenium-side-runner --filter "*checkout*" miproyecto.side

Control de paralelización

El SIDE Runner puede ejecutar múltiples tests simultáneamente para reducir el tiempo total de ejecución. Utilizamos el parámetro -w para especificar el número de workers:

selenium-side-runner -w 3 miproyecto.side

Esta configuración ejecutará hasta 3 tests en paralelo. Sin embargo, debemos ser cuidadosos con este parámetro, ya que tests que dependan entre sí o que modifiquen los mismos datos pueden interferir mutuamente.

Configuración de timeouts desde línea de comandos

Podemos sobrescribir los timeouts configurados en nuestros tests directamente desde la terminal:

selenium-side-runner --timeout 30000 miproyecto.side

Este parámetro establece un timeout global de 30 segundos para todos los comandos waitFor de nuestros tests, útil cuando ejecutamos tests en entornos más lentos que el de desarrollo.

Gestión de informes y logs

El runner genera automáticamente informes detallados de la ejecución. Podemos especificar el formato y ubicación de estos informes:

selenium-side-runner --output-directory ./resultados miproyecto.side

Los informes incluyen detalles sobre tests exitosos, fallidos, capturas de pantalla de errores y métricas de rendimiento. Esta información es invaluable para identificar patrones en fallos o para generar reportes para stakeholders.

Ejecución de múltiples proyectos

Podemos ejecutar varios archivos .side en una sola sesión, útil cuando organizamos nuestros tests en proyectos separados por funcionalidad:

selenium-side-runner login.side checkout.side administracion.side

El runner ejecutará secuencialmente cada proyecto, proporcionando un informe consolidado al final de todas las ejecuciones.

Variables de entorno

El SIDE Runner respeta las variables de entorno del sistema, permitiendo configuraciones dinámicas. Por ejemplo, podemos definir una URL base diferente según el entorno:

BASE_URL=https://testing.miapp.com selenium-side-runner miproyecto.side

Esta flexibilidad permite usar los mismos tests en diferentes entornos (desarrollo, testing, staging) sin modificar los archivos .side.

Integración básica con scripts

Podemos crear scripts simples que automaticen la ejecución de nuestros tests. Un ejemplo básico en un archivo batch de Windows:

@echo off
echo Ejecutando tests de regresion...
selenium-side-runner -c "browserName=chrome headless=true" tests-regresion.side
echo Tests completados. Revisando resultados...

O en un script de shell para sistemas Unix:

#!/bin/bash
echo "Iniciando validación automática..."
selenium-side-runner --timeout 20000 validacion-diaria.side
echo "Validación completada a las $(date)"

Monitoreo de la ejecución

Durante la ejecución, el runner proporciona feedback visual en la terminal mostrando el progreso de cada test:

✓ Test: Login exitoso
✓ Test: Crear pedido
✗ Test: Procesar pago - Error: Element not found
✓ Test: Logout

Esta información en tiempo real nos permite identificar rápidamente qué tests están fallando y tomar acciones correctivas inmediatas.

Hacia la automatización profesional

El dominio del command-line runner marca la transición desde testing manual hacia automatización profesional. Con estas herramientas, los equipos de QA pueden establecer rutinas de validación que se ejecuten automáticamente, liberando tiempo para enfocarse en casos de prueba más complejos y análisis de resultados.

La capacidad de ejecutar tests desde terminal abre las puertas a integraciones más sofisticadas: sistemas de monitoreo continuo, alertas automáticas cuando fallan tests críticos, y reportes periódicos que mantienen informados a todos los stakeholders sobre la calidad del producto.

Este conocimiento sienta las bases para que, en el futuro, puedan explorar integraciones con sistemas de CI/CD como Jenkins, GitLab CI o GitHub Actions, llevando la automatización de pruebas al nivel empresarial.