Validar status codes 200 y 404 en Cypress

Curso de Automatización de Pruebas de Backend con Cypress

Contenido del curso

No sé dónde empezar

Introduccion a la Automatización Backend

Conociendo Cypress

Validando el contenido de la respuesta

Haciendo diferentes tipos de peticiones

Bases de Datos

Prueba en conjunto

15
Prueba de API y base de datos con Cypress
09:08 min

Próximos pasos

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:005:52

Validar status codes 200 y 404 en Cypress

Curso de Automatización de Pruebas de Backend con Cypress

Clase 6 de 17

Clase 6 / 17

Recursos

Validar el status code en Cypress es una de las acciones más críticas al probar una API, porque define si el servidor respondió como esperabas. Aquí aprenderás a verificar respuestas exitosas, manejar errores 404 y configurar Cypress para que no detenga tus pruebas cuando buscas validar fallos.

¿Cómo crear un archivo de pruebas para status codes en Cypress?

Dentro de la carpeta de integración creas un archivo nuevo, por ejemplo status.spec, y ahí defines el bloque principal con describe("Probando statuses"). Ese contenedor agrupa todas las validaciones relacionadas con códigos de respuesta.

Dentro del describe, abres tu primer it con un mensaje claro como debe validar el status code exitoso. Esa nomenclatura ayuda a que cualquier persona del equipo entienda qué se está probando con solo leer el log [0:35].

¿Cómo validar un status code 200 exitoso?

El flujo es directo: haces un cy.request al endpoint employees, accedes con .its('status') y encadenas un .should('equal', 200). Cuando el servidor responde correctamente, esa aserción pasa sin problema.

¿Qué significa un status code 200? Es la respuesta estándar del servidor cuando la petición HTTP se completó con éxito. En Cypress, lo validas comparando its('status') contra 200.

Al abrir el navegador de Cypress puedes inspeccionar la consola y confirmar que el valor esperado y el obtenido coinciden. Esa visibilidad es clave para depurar pruebas de API rápido [1:45].

¿Por qué Cypress falla cuando esperas un status code 404?

Cuando intentas validar un recurso que ya no existe, por ejemplo el empleado 4 que fue eliminado, Cypress lanza un error automáticamente aunque tu código diga .should('equal', 404). El log muestra el detalle del fallo, la URL afectada y el código recibido.

Esto ocurre porque Cypress, por defecto, considera cualquier respuesta fuera del rango 2xx como un fallo de la prueba. Es una medida preventiva pensada para que no pases por alto errores reales del servidor [2:50].

¿Cómo desactivar failOnStatusCode en Cypress?

La solución es transformar el argumento de cy.request de una simple cadena a un objeto de configuración. En ese objeto especificas la propiedad url y agregas failOnStatusCode: false.

El bloque queda así:

javascript cy.request({ url: '/employees/4', failOnStatusCode: false }).its('status').should('equal', 404)

Con esa bandera en false, le indicas a Cypress que no marque la prueba como fallida cuando reciba un código de error. Ahora puedes confirmar que tu API devuelve un 404 cuando el recurso no existe, que es exactamente el comportamiento esperado [3:30].

¿Cuándo debo usar failOnStatusCode false? Úsalo cuando tu objetivo es probar respuestas de error como 400, 401, 404 o 500. Si lo dejas activo, Cypress detendrá la prueba antes de que llegues a tu aserción.

¿Qué otros status codes puedes validar en tus pruebas?

La lógica que aprendiste con 200 y 404 se replica para cualquier código HTTP. Solo cambias el número en la aserción y, si esperas un error, ajustas la configuración de la petición.

Algunos códigos comunes que vale la pena cubrir en tus pruebas:

200: petición exitosa.
201: recurso creado correctamente, típico en POST.
400: petición mal formada por el cliente.
401: falta de autenticación.
404: recurso no encontrado.
500: error interno del servidor.

Validar el status code es el primer filtro, pero no el único. Hay casos donde tu API responde con un 200 y aun así el body trae datos incorrectos o incompletos, así que la siguiente capa de pruebas se enfoca en validar el contenido de la respuesta.

¿Qué status code probaste con tu propia API? Déjalo en los comentarios y comparte cómo lo configuraste.

it("should validate 201 Created status code when creating a new employee and 200 Ok status code when deleting the just created employee", function () {
    cy.request("POST", "employees", {
      name: "Joe",
      lastname: "Doe",
      email: "joe_doe@gmail.com",
    }).as("createdEmployee");

    cy.get("@createdEmployee").its("status").should("eq", 201);

    cy.get("@createdEmployee")
      .its("body")
      .its("id")
      .then((createdEmployeeId) => {
        cy.request("DELETE", `employees/${createdEmployeeId}`)
          .its("status")
          .should("eq", 200);
      });
  });

it('first employee to be created', () => {
        cy.request("POST", "employees", {
            first_name: "Mauricio",
            last_name: "Perez",
            email: "mauricio@gmail.com",
            gender: "Male",
            ip_address: "79.77.68.154"
          }).as("createdEmployee");
      
          cy.get("@createdEmployee").its("status").should("eq", 201);
    })

    it('second employee to be created', () => {
        cy.request("POST", "employees", {
            first_name: "Carlos",
            last_name: "Antelo",
            email: "carlos@gmail.com",
            gender: "Male",
            ip_address: "105.59.68.154"
          }).as("createdEmployee");
      
          cy.get("@createdEmployee").its("status").should("eq", 201);
    })

    afterEach(() => {
        cy.get("@createdEmployee")
            .its("body")
            .its("id")
            .then((createdEmployeeId) => {
              cy.request("DELETE", `employees/${createdEmployeeId}`)
                .its("status")
                .should("eq", 200);
            });
    })

describe("Apis", () => {
  it("index - getAll", () => {
    cy.request("https://jsonplaceholder.typicode.com/todos").as("response");
    cy.get("@response").its("body").as("body");
    cy.get("@response").its("status").as("status");

    cy.get("@status").should("eq", 200);
    cy.get("@body").should("not.be.empty");

    cy.get("@body").its(0).as("firstItem");

    cy.get("@firstItem").should("have.property", "userId").and("be.a", "number");
    cy.get("@firstItem").should("have.property", "id").and("be.a", "number");
    cy.get("@firstItem").should("have.property", "title").and("be.a", "string");
    cy.get("@firstItem").should("have.property", "completed").and("be.a", "boolean");
  })
})

describe('Probando statuses', ()=>{

    it('Debe de validar el status code exitoso',()=>{

        cy.request('employees')
        .its('status')
        .should('eq',  200)
    });

    it('Debe de validar el status code fallido',()=>{
        cy.request({url:'employees/4', failOnStatusCode: false})
        .its('status')
        .should('eq', 404)
    });
});
```describe('Probando statuses', ()=>{
    it('Debe de validar el status code exitoso',()=>{
        cy.request('employees')        .its('status')        .should('eq',  200)    });
    it('Debe de validar el status code fallido',()=>{        cy.request({url:'employees/4', failOnStatusCode: false})        .its('status')        .should('eq', 404)    });});

 it('Debe de validar el status code exitoso de la actualizacion', () => {
                cy.request({method: 'PUT', url: 'employees/5'})
                    .its('status')
                    .should('eq', 200)
     })
 it('Debe de validar el status code exitoso de la eliminacion', () => {
                         cy.request({method: 'DELETE', url: 'employees/5'})
                             .its('status')
                             .should('eq', 200)
      })

describe("Apis", () => {
  it("index - getAll", () => {
    cy.request("https://jsonplaceholder.typicode.com/todos").as("response");
    cy.get("@response").its("body").as("body");
    cy.get("@response").its("status").as("status");

    cy.get("@status").should("eq", 200);
    cy.get("@body").should("not.be.empty");

    cy.get("@body").its(0).as("firstItem");

    cy.get("@firstItem").should("have.property", "userId").and("be.a", "number");
    cy.get("@firstItem").should("have.property", "id").and("be.a", "number");
    cy.get("@firstItem").should("have.property", "title").and("be.a", "string");
    cy.get("@firstItem").should("have.property", "completed").and("be.a", "boolean");
  })
})
```*describe*("Apis", () *=>* {  *it*("index - getAll", () *=>* {    *cy.request*("https://jsonplaceholder.typicode.com/todos")*.as*("response");    *cy.get*("@response")*.its*("body")*.as*("body");    *cy.get*("@response")*.its*("status")*.as*("status");
&#x20;   *cy.get*("@status")*.should*("eq", 200);    *cy.get*("@body")*.should*("not.be.empty");
&#x20;   *cy.get*("@body")*.its*(0)*.as*("firstItem");
&#x20;   *cy.get*("@firstItem")*.should*("have.property", "userId")*.and*("be.a", "number");    *cy.get*("@firstItem")*.should*("have.property", "id")*.and*("be.a", "number");    *cy.get*("@firstItem")*.should*("have.property", "title")*.and*("be.a", "string");    *cy.get*("@firstItem")*.should*("have.property", "completed")*.and*("be.a", "boolean");  })})

Resumen

¿Cómo crear un archivo de pruebas para status codes en Cypress?

¿Cómo validar un status code 200 exitoso?

¿Qué significa un status code 200? Es la respuesta estándar del servidor cuando la petición HTTP se completó con éxito. En Cypress, lo validas comparando its('status') contra 200.

Al abrir el navegador de Cypress puedes inspeccionar la consola y confirmar que el valor esperado y el obtenido coinciden. Esa visibilidad es clave para depurar pruebas de API rápido [1:45].

¿Por qué Cypress falla cuando esperas un status code 404?

¿Cómo desactivar failOnStatusCode en Cypress?

La solución es transformar el argumento de cy.request de una simple cadena a un objeto de configuración. En ese objeto especificas la propiedad url y agregas failOnStatusCode: false.

El bloque queda así:

javascript cy.request({ url: '/employees/4', failOnStatusCode: false }).its('status').should('equal', 404)

¿Cuándo debo usar failOnStatusCode false? Úsalo cuando tu objetivo es probar respuestas de error como 400, 401, 404 o 500. Si lo dejas activo, Cypress detendrá la prueba antes de que llegues a tu aserción.

¿Qué otros status codes puedes validar en tus pruebas?

La lógica que aprendiste con 200 y 404 se replica para cualquier código HTTP. Solo cambias el número en la aserción y, si esperas un error, ajustas la configuración de la petición.

Algunos códigos comunes que vale la pena cubrir en tus pruebas:

200: petición exitosa.
201: recurso creado correctamente, típico en POST.
400: petición mal formada por el cliente.
401: falta de autenticación.
404: recurso no encontrado.
500: error interno del servidor.

¿Qué status code probaste con tu propia API? Déjalo en los comentarios y comparte cómo lo configuraste.

it("should validate 201 Created status code when creating a new employee and 200 Ok status code when deleting the just created employee", function () {
    cy.request("POST", "employees", {
      name: "Joe",
      lastname: "Doe",
      email: "joe_doe@gmail.com",
    }).as("createdEmployee");

    cy.get("@createdEmployee").its("status").should("eq", 201);

    cy.get("@createdEmployee")
      .its("body")
      .its("id")
      .then((createdEmployeeId) => {
        cy.request("DELETE", `employees/${createdEmployeeId}`)
          .its("status")
          .should("eq", 200);
      });
  });

it('first employee to be created', () => {
        cy.request("POST", "employees", {
            first_name: "Mauricio",
            last_name: "Perez",
            email: "mauricio@gmail.com",
            gender: "Male",
            ip_address: "79.77.68.154"
          }).as("createdEmployee");
      
          cy.get("@createdEmployee").its("status").should("eq", 201);
    })

    it('second employee to be created', () => {
        cy.request("POST", "employees", {
            first_name: "Carlos",
            last_name: "Antelo",
            email: "carlos@gmail.com",
            gender: "Male",
            ip_address: "105.59.68.154"
          }).as("createdEmployee");
      
          cy.get("@createdEmployee").its("status").should("eq", 201);
    })

    afterEach(() => {
        cy.get("@createdEmployee")
            .its("body")
            .its("id")
            .then((createdEmployeeId) => {
              cy.request("DELETE", `employees/${createdEmployeeId}`)
                .its("status")
                .should("eq", 200);
            });
    })

Comentarios (8)8 comentarios

Nicolas Cardona

Hace 4 años

Una buena practica cuando se está creando datos en la base de datos por una prueba automatizada es limpiar la base de datos, si tú objetivo es simplemente validar que el empleado se crea bien, entonces no lo necesitas para más adelante por eso es mejor borrarlo enseguida. Ahora imagínalo en un pipeline de Integración Continua, crearía demasiados usuarios, y eso para la base de datos y otros servicios no sería óptimo. Acá un ejemplo:

Mauricio Gonzalo Aliendre Pérez

Hace 3 años

Excelente aporte! usando tu código como ejemplo también se me ocurrió poner el método DELETE en un hook, en este caso me puse de ejemplo crear dos empleados y con un afterEach() ir borrando cada empleado cuando acabe la ejecución de cada test

Aqui el codigo

NOTA: En mi caso los empleados también cuentan con campos adicionales como genero y la dirección ip por eso es algo diferente

Emmanuel Rodríguez

Request

. 📚 Documentación . Tomando como referencia la lista de argumentos que se envían como opciones podemos adicionar más elementos a nuestra request. . Si necesitamos enviar datos, como lo es una creación, tenemos la siguiente definición:

cy.request('POST', 'URL', { name: 'Fionna Delahunty', email: 'fdelahunty0@sitemeter.com'})

Nicolás Chamorro Girón

Hace 2 años

Pueden usar este codigo que testea un api en linea gratuita:

Eduardo Zamora Miranda

¿Qué diferencia hay entre usar cypress o REST assured con java/python para las pruebas en backend?

Cuáles serian ventajas o desventajas?

Javier Fuentes Mora

Profesor

cypress ya lo tiene integrado no necesitas ninguna libreria mas ni dependes de alguien

Eduardo Huanca

python solo necesita pytest para lo que es pruebas de backend y las apis que vas a probar, el interpretador, el ide pycharm u otro...
...igualmente no entedí muy bien la pregunta.

Mario Alexander Vargas Celis

Marcos Germán Medina

La clave aquí es la opción failOnStatusCode: false, que le dice a Cypress que no falle automáticamente si el código de estado no es 2xx. Esto te permite verificar manualmente el código de estado en la siguiente línea.

describe("Probando status", () => { it("Validar el status code exitoso", () => { ``//se valida que el status code sea 200`` cy.request("employees").its("status").should("eq", 200); }); it("Validar el status code fallido", () => { ``//se valida que el status code sea 404 fallido`` cy.request({url: "employees/6", failOnStatusCode: false}).its("status").should("eq", 404); });});

Elizabeth Daniela Rodriguez Ubaldo

it('Debe de validar el status code exitoso de la creacion', () => { cy.request({method: 'POST', url: 'employees'}) .its('status') .should('eq', 201) })

Pueden usar este mismo código para las pruebas, se testea una api en linea y gratuita:

Introduccion a la Automatización Backend

Pruebas de backend con Cypress desde cero

Qué es el backend testing y sus conceptos clave

DevTools y Postman para probar APIs

Conociendo Cypress

Cypress y JSON Server para pruebas de API

Validar headers con cy.request en Cypress

Validar status codes 200 y 404 en Cypress

Validando el contenido de la respuesta

Validar body, headers y status con Cypress

Validar status code y mensaje de error en Cypress

Haciendo diferentes tipos de peticiones

Flujo POST, PUT y DELETE con cy.request

Cómo testear una GraphQL API con Cypress

Bases de Datos

Conectar Cypress a MySQL sin exponer secretos

INSERT, SELECT y DELETE en Cypress con MySQL

Cómo probar MongoDB con Cypress

Crear e insertar registros en MongoDB con Cypress

Prueba en conjunto

Prueba de API y base de datos con Cypress

Próximos pasos

Qué hacer al terminar un curso online

Automatización de Pruebas con Cypress

Validar status codes 200 y 404 en Cypress

Progreso del curso

Introduccion a la Automatización Backend

Conociendo Cypress

Validando el contenido de la respuesta

Haciendo diferentes tipos de peticiones

Bases de Datos

Prueba en conjunto

Próximos pasos

Recursos

Recursos