Cómo establecer variables en el script Post-Request de Postman

Las pruebas de API efectivas requieren la gestión dinámica de datos. Los scripts posteriores a la solicitud de Postman ofrecen un mecanismo robusto para lograr esto a través de la configuración de variables. Al capturar y almacenar estratégicamente los valores de las respuestas de la API, los testers pueden mejorar la eficiencia, la mantenibilidad y la fiabilidad de las pruebas.

Este artículo profundiza en las complejidades de la utilización de las capacidades de scripting de Postman para establecer variables. Proporcionará una guía completa sobre el empleo de las funciones pm.environment.set() y pm.globals.set() para crear y administrar variables dentro de diferentes ámbitos. Ejemplos prácticos ilustrarán cómo extraer datos de las respuestas de la API y asignarlos a variables para su uso posterior en casos de prueba.

¿Qué son los scripts posteriores a la solicitud?

Los scripts posteriores a la solicitud son fragmentos de código JavaScript que se ejecutan después de que Postman envía una solicitud y recibe una respuesta. Proporcionan una forma poderosa de interactuar con los datos de la respuesta, realizar aserciones, extraer información y manipular datos para solicitudes posteriores.

Esencialmente, te permiten automatizar varias tareas de prueba y manejo de datos dentro del entorno de Postman.

Guía paso a paso sobre cómo establecer una variable en el script posterior a la solicitud de Postman

Paso 1: accede a la pestaña Script posterior a la solicitud:

Primero, abre la API o la solicitud que deseas editar y haz clic en la pestaña Scripts. Aquí es donde puedes encontrar la sección Post-response.

Paso 2: extrae datos de la respuesta de Postman

Utiliza los métodos pm.response.json() o pm.response.text() para acceder al cuerpo de la respuesta de la API como JSON o texto, respectivamente.

Durante este paso, también debes emplear cualquier técnica necesaria de manipulación de objetos o cadenas de JavaScript para extraer los datos deseados.

Paso 3: establece la variable

Debes usar pm.environment.set(), pm.globals.set() o pm.collectionVariables.set() para almacenar los datos extraídos en una variable. La elección depende del ámbito deseado.

Ejemplo de cómo establecer una variable en el script posterior a la solicitud de Postman

pm.test("Set a variable", () => {
    const jsonData = pm.response.json();
    const token = jsonData.access_token;
    pm.environment.set("auth_token", token);
});

Este fragmento de código extrae el access_token de la respuesta JSON y lo almacena en una variable de entorno llamada auth_token.

Consejos adicionales

• Manejo de errores: Implementa el manejo de errores para gestionar con elegancia formatos de respuesta inesperados o datos faltantes.
• Tipos de datos: Asegúrate de que los tipos de datos para las variables sean correctos. Utiliza el operador typeof para verificar.
• Uso de variables: Accede a las variables en solicitudes posteriores utilizando llaves dobles: {{auth_token}}.
• Mejores prácticas: Considera usar nombres de variables descriptivos y organizar tus scripts para una mejor legibilidad.

Ventajas de establecer variables en los scripts posteriores a la solicitud de Postman

Datos de prueba dinámicos

Datos en tiempo real: Captura y almacena datos dinámicos de las respuestas de la API (por ejemplo, IDs, tokens, marcas de tiempo) para su uso inmediato en solicitudes posteriores.

Pruebas basadas en datos: Crea pruebas más robustas utilizando datos reales del sistema en lugar de valores estáticos.

Reutilización de datos de prueba

Eficiencia: Reutiliza los datos capturados en múltiples solicitudes dentro de una colección o entorno, reduciendo la entrada manual de datos y los posibles errores.

Correlación: Vincula solicitudes dependientes pasando datos de una respuesta a otra, mejorando la precisión de las pruebas.

Mantenimiento de pruebas

Flexibilidad: Modifica fácilmente los valores de las variables sin cambiar múltiples cuerpos de solicitud, lo que hace que las actualizaciones de las pruebas sean más eficientes.

Centralización: Administra los datos de prueba en una ubicación centralizada (variables de entorno o globales) para una mejor organización.

Escenarios de prueba complejos

Manipulación de datos: Procesa y transforma los datos capturados antes de almacenarlos como una variable, lo que permite una lógica de prueba compleja.

Lógica condicional: Utiliza variables en sentencias condicionales para controlar el flujo de la prueba en función de los datos de la respuesta.

Colaboración

Datos compartidos: Comparte variables de entorno o globales entre los miembros del equipo para mantener datos de prueba consistentes.

Gestión del entorno: Crea diferentes entornos con diferentes valores de variables para diferentes escenarios de prueba.

Casos de uso comunes para establecer variables en los scripts posteriores a la solicitud de Postman

Establecer variables en los scripts posteriores a la solicitud de Postman es una técnica versátil con numerosas aplicaciones en las pruebas de API. Aquí hay algunos casos de uso comunes:

• Gestión de tokens de autenticación: Extrae tokens de acceso de las respuestas de autenticación y almacénalos para solicitudes posteriores.
• Manejo dinámico de datos: Captura y almacena datos dinámicos como IDs de usuario, números de pedido o IDs de sesión para la correlación de datos de prueba.
• Pruebas basadas en datos: Genera datos de prueba dinámicamente y almacénalos en variables para pruebas iterativas.
• Manejo de errores: Almacena mensajes o códigos de error para su posterior análisis o informes.
• Pruebas de rendimiento: Mide los tiempos de respuesta y almacénalos para su análisis.
• Encadenamiento de solicitudes: Pasa datos de una solicitud a otra, creando flujos de prueba complejos.
• Gestión del entorno: Almacena valores de configuración específicos del entorno, como URLs base o claves de API.
• Generación de datos de prueba: Crea datos aleatorios o secuenciales para casos de prueba.
• Lógica personalizada: Implementa lógica personalizada basada en los datos de la respuesta, como la ejecución condicional o las transformaciones de datos.

Apidog: una herramienta de desarrollo de API todo en uno

Apidog es una herramienta de API integral que proporciona a los usuarios funcionalidades completas para todo el ciclo de vida de la API. Se especializa en una interfaz de usuario simple e intuitiva que promueve un enfoque de diseño primero para el desarrollo de API.

Crea scripts de post-procesador en segundos

Con Apidog, puedes implementar el post-procesador de la forma que desees.

Puedes seleccionar entre una variedad de post-procesadores, como aserciones, personalizados e incluso scripts públicos.

Importa otras APIs a Apidog

Apidog admite varios tipos de archivos API, incluidos OpenAPI (o Swagger), Postman e Insomnia. De esta manera, puedes importar proyectos existentes al elegante entorno de desarrollo de Apidog para realizar más modificaciones.

Primero, abre la sección Configuración en tu proyecto y localiza el botón Import Data que se encuentra en Administración de datos. Si no encuentras el tipo de archivo que deseas importar, ¡no te preocupes! Simplemente arrastra y suelta el archivo en la parte inferior de la pantalla.

Conclusión

Al dominar el arte de establecer variables en los scripts posteriores a la solicitud de Postman, has desbloqueado una poderosa herramienta para optimizar tu flujo de trabajo de pruebas de API. La capacidad de capturar y almacenar dinámicamente datos de las respuestas te permite crear conjuntos de pruebas más robustos, eficientes y mantenibles. A través de una cuidadosa consideración de los ámbitos de las variables y las técnicas efectivas de extracción de datos, puedes mejorar significativamente tus capacidades de prueba y acelerar los ciclos de desarrollo.

Recuerda, la clave del éxito radica en comprender el comportamiento de tu API, planificar tus casos de prueba estratégicamente y aprovechar todo el potencial de las funciones de scripting de Postman. Siguiendo la guía proporcionada en este artículo, estarás bien equipado para aprovechar el poder de las variables y elevar tus pruebas de API a nuevas alturas.