Cómo escribir scripts en Postman

Repasemos brevemente las bases de escritura de código en JavaScript.

1. Variables

Una variable es un contenedor para almacenar información. La palabra clave var se usa para declarar una variable.

var name = "Catstronaut";

var age = 4;

var isReadyForLaunch = true;

var inventory = ["casco", "guantes", "raciones"];

2. Funciones

Las funciones se crean usando la palabra clave function.

Supongamos que tenemos dos funciones: una prepara la nave para el lanzamiento, la otra calcula la reserva de combustible.

function prepareShip(name) {
    return "La nave «" + name + "» está lista para el lanzamiento.";
}

function calculateFuel(distance) {
    return distance * 42;
}

3. Llamada a funciones

Las funciones se llaman por nombre y pueden aceptar argumentos. Veamos cómo se ve en código.

prepareShip("Voskhod-3");

var fuel = calculateFuel(800);

console.log("El lanzamiento ha comenzado.");

Postman proporciona un entorno de ejecución donde puedes escribir scripts JavaScript: el llamado “Postman Sandbox”. Puedes escribir código en la sección Scripts.

Puedes llamar funciones especiales de Postman accediendo a los métodos y propiedades del objeto llamado pm.

1. pm.environment

Usando el objeto pm puedes acceder a la environment propiedad y obtener o establecer dinámicamente variables de entorno.

pm.environment.get("variableName")

pm.environment.set("variableName", "variableValue")

2. pm.globals

Usando el objeto pm puedes acceder a la globals propiedad y trabajar dinámicamente con variables globales (disponibles en todos los entornos).

pm.globals.get("variableName")

pm.globals.set("variableName", "variableValue")

3. pm.test

Usando el objeto pm puedes llamar al test método para escribir tu propia prueba.

pm.test("Let's check if code is 200",
    function () {
        pm.response.to.have.status(200);
    }
);

Los scripts definidos en la sección Scripts > Pre-request se ejecutan antes de enviar una solicitud. Puede ser cualquier código JavaScript, pero el objeto clave cuyas propiedades están disponibles en la sección Pre-request es request. Puedes acceder a él mediante pm.request. Cuando escribes un punto, aparece una lista desplegable con todos los métodos disponibles.

pm.request.headers.add({
    key: "Authorization",
    value: "Bearer jwt"
});

Los scripts definidos en la sección Scripts > Post-response se ejecutan después de enviar una solicitud y recibir una respuesta del servidor. Además de acceder a la solicitud, ahora tienes acceso al response objeto. Puedes acceder a él mediante pm.response. Después de escribir un punto, se muestra una lista con todos los métodos disponibles.

Es en Post-response donde normalmente se escriben comprobaciones automatizadas para asegurar que la respuesta del servidor cumple lo esperado. Para escribir una prueba, llama a pm.test y pasa cualquier nombre de prueba y una función que se ejecutará después de enviar la solicitud. El resultado de la función establecerá el estado de la prueba en true = PASSED o false = FAILED y se mostrará en el Test Results.

pm.response.code

pm.response.json()

En resumen, los scripts en Postman permiten automatizar parte del trabajo: generar datos de prueba, preparar solicitudes y escribir comprobaciones automáticas para respuestas del servidor.

Las capacidades de Postman para escribir pruebas automatizadas a gran escala son limitadas, pero son suficientes para pruebas básicas de API. Para escenarios completos de pruebas automatizadas necesitarás aprender un lenguaje de programación como Java o Python y explorar frameworks y herramientas de pruebas como Selenium, Playwright, Rest Assured.