En este tema, aprenderás cómo automatizar tus pruebas de API utilizando Newman, una herramienta de línea de comandos que te permite ejecutar colecciones de Postman. La automatización de pruebas es crucial para integrar pruebas en flujos de trabajo de integración continua y entrega continua (CI/CD), asegurando que las APIs funcionen correctamente en todo momento.

¿Qué es Newman?

Newman es un ejecutor de colecciones de Postman que permite ejecutar tus pruebas de API desde la línea de comandos. Esto es especialmente útil para:

  • Integración Continua (CI): Ejecutar pruebas automáticamente cada vez que se realiza un cambio en el código.
  • Automatización de Pruebas: Programar ejecuciones de pruebas en intervalos regulares.
  • Entornos sin Interfaz Gráfica: Ejecutar pruebas en servidores o entornos donde no se dispone de una interfaz gráfica.

Instalación de Newman

Para comenzar a usar Newman, primero necesitas instalarlo. Newman se distribuye a través de npm, el gestor de paquetes de Node.js. Asegúrate de tener Node.js y npm instalados en tu sistema.

Pasos para instalar Newman:

  1. Verifica la instalación de Node.js y npm:

    Abre una terminal y ejecuta los siguientes comandos para verificar que Node.js y npm están instalados:

    node -v
    npm -v
    

    Si no están instalados, descárgalos e instálalos desde nodejs.org.

  2. Instala Newman:

    Ejecuta el siguiente comando en la terminal para instalar Newman globalmente:

    npm install -g newman
    

    Esto instalará Newman y lo hará accesible desde cualquier lugar en tu sistema.

Ejecutando Colecciones de Postman con Newman

Una vez que Newman está instalado, puedes comenzar a ejecutar tus colecciones de Postman desde la línea de comandos.

Exportar una Colección de Postman

Antes de ejecutar una colección con Newman, necesitas exportarla desde Postman:

  1. Abre Postman y selecciona la colección que deseas exportar.
  2. Haz clic en el menú de tres puntos junto al nombre de la colección.
  3. Selecciona "Exportar" y elige el formato de exportación (recomendado: v2.1).

Ejecutar la Colección con Newman

Con la colección exportada, puedes usar Newman para ejecutarla:

newman run path/to/your-collection.json

Opciones Comunes de Newman

Newman ofrece varias opciones para personalizar la ejecución de tus pruebas:

  • Especificar un archivo de entorno:

    Si tu colección utiliza variables de entorno, puedes especificar un archivo de entorno:

    newman run path/to/your-collection.json -e path/to/your-environment.json
    
  • Generar un reporte:

    Puedes generar un reporte en diferentes formatos, como HTML o JSON:

    newman run path/to/your-collection.json -r html
    
  • Configurar tiempo de espera:

    Ajusta el tiempo de espera para solicitudes y respuestas:

    newman run path/to/your-collection.json --timeout-request 5000
    

Ejercicio Práctico

Objetivo: Automatizar la ejecución de una colección de Postman utilizando Newman.

  1. Exporta una colección de Postman que contenga al menos tres solicitudes.
  2. Crea un archivo de entorno en Postman y exporta este archivo.
  3. Ejecuta la colección con Newman desde la línea de comandos, utilizando el archivo de entorno.
  4. Genera un reporte HTML de la ejecución.

Solución

  1. Exporta la colección y el entorno desde Postman.

  2. Ejecuta el siguiente comando en la terminal:

    newman run path/to/your-collection.json -e path/to/your-environment.json -r html
    
  3. Revisa el reporte HTML generado para verificar los resultados de las pruebas.

Conclusión

Automatizar pruebas con Newman es un paso esencial para integrar tus pruebas de API en un flujo de trabajo de CI/CD. Con Newman, puedes ejecutar tus colecciones de Postman en cualquier entorno, generar reportes detallados y asegurar que tus APIs funcionen correctamente en todo momento. En el siguiente tema, exploraremos cómo integrar Newman en un sistema de integración continua para maximizar la eficiencia de tus pruebas.

© Copyright 2024. Todos los derechos reservados