Cómo probar MongoDB con 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:0011:17

Cómo probar MongoDB con Cypress

Curso de Automatización de Pruebas de Backend con Cypress

Clase 13 de 17

Clase 13 / 17

Recursos

Probar bases de datos NoSQL con Cypress requiere un enfoque distinto al de SQL, sobre todo cuando trabajas con MongoDB. Aquí aprenderás a configurar un plugin de conexión, listar documentos de una colección y validar resultados dentro de tus pruebas automatizadas, paso a paso y con ejemplos reales.

Los principios funcionan para cualquier motor NoSQL, así que si usas Firebase u otra opción, la lógica de conexión, consulta y cierre se mantiene casi idéntica.

¿Cómo se conecta Cypress a MongoDB desde un plugin?

La conexión empieza instalando la librería oficial de MongoDB en tu proyecto y creando una función asíncrona que devuelva la base de datos lista para consultarse [01:00].

Dentro del plugin defines una función connect que recibe un cliente, espera a que se establezca la conexión y retorna client.db apuntando a la colección que vas a usar. Para obtener las credenciales puedes apoyarte en Mongo Atlas, que entrega un servidor, un cluster y la dirección lista para pegar en tu configuración [01:30].

¿Qué es Mongo Atlas? Es el servicio en la nube de MongoDB que te permite crear bases de datos gratis dentro de ciertos límites. Te da el clúster, el servidor y la cadena de conexión que necesitas para configurar tu cliente.

Un detalle clave: el cliente se crea con new MongoClient y necesita la configuración que sacas de tus variables de entorno. Por eso, en tu archivo de configuración agregas una propiedad mongo con la cadena que te entregó Atlas [02:30].

¿Cómo listar documentos de una colección NoSQL?

Una vez que tu cliente conecta, creas una tarea asíncrona llamada getListing que se encarga de traer los datos. Toda la lógica vive dentro de un try catch porque trabajas con código asíncrono y conexiones que pueden fallar.

Dentro del try haces tres cosas concretas:

Llamas a await connect(client) para obtener la base de datos.
Seleccionas la colección con db.collection('listingsAndReviews').
Ejecutas find().limit(50).toArray() para devolver máximo 50 documentos como arreglo [03:30].

El limit no es opcional. Sin él, una colección como listingsAndReviews (un dataset de ejemplo tipo Airbnb) puede regresar miles de registros y tardar demasiado. En el catch haces console.error del error, y en el finally ejecutas await client.close() para cerrar la conexión y no dejar procesos colgados [04:00].

¿Cómo validar los resultados en la prueba de Cypress?

Con el plugin listo, creas el archivo mongo.spec con un describe('Probando Mongo') y una prueba que llama a cy.task('getListing'). El resultado lo encadenas con .then(results => ...) para imprimirlo con cy.log y luego validar la longitud esperada [04:30].

La aserción se ve así: expect(results).to.have.length(50). Como en el plugin convertiste la respuesta a array, esta validación funciona directamente sobre la longitud del listado.

¿Por qué falla la conexión a MongoDB con timeout? Porque tu IP no está autorizada. En Mongo Atlas debes ir a Network Access y agregar tu dirección IP para que el cliente pueda conectarse por temas de seguridad.

Qué hacer cuando el array regresa vacío

Si tu prueba esperaba 50 elementos y obtuviste 0, lo más probable es que la colección esté vacía. En el ejemplo, la colección original se había borrado, así que la solución fue cambiar a otro dataset disponible: la base sample-guides con la colección planets [05:30].

Al correr de nuevo la prueba, el array devolvió 8 documentos, que era el total real de planetas en esa colección. Ajustando la aserción a to.have.length(8), la prueba pasa sin problema [06:00].

¿Por qué NoSQL se prueba distinto a SQL?

En bases relacionales pasas un query como cadena de texto y listo. En NoSQL trabajas con funciones encadenadas como find, limit o toArray, así que el plugin debe exponer métodos específicos para cada operación que quieras probar.

Por ahora solo estás listando información. Las operaciones de inserción, actualización y borrado en MongoDB requieren funciones distintas, y eso se cubre en la siguiente clase.

¿Ya intentaste conectar tu propia base en Mongo Atlas? Cuéntame en los comentarios qué dataset elegiste y si tuviste que ajustar tu Network Access para que funcionara.

Mauricio Gonzalo Aliendre Pérez

Hace 3 años

Para Cypress 12 lo que hcie en mi caso fue lo siguiente:

Por defecto utilice la conexion que te da Mongo al momento de instalarlo y el URI en el archivo cypress.env.json lo puse asi:

"mongo": "mongodb://127.0.0.1:27017/"

| Este lo pueden sacar desde la opción Copy connection string en MongoDB Compass | NOTA: Esta con 127.0.0.1 debido a que con localhost falla y según leí es debido a que con localhost Mongo utiliza una dirección IPv6 y al darle el valor de 127.0.0.1 utiliza la dirección de localhost pero de IPv4 | La conexion la configure asi en el archivo cypress.config.js

const { defineConfig } = require("cypress");
const { MongoClient } = require("mongodb");
const mysql = require('mysql')

module.exports = defineConfig({
  e2e: {
    baseUrl: "https://localhost:3000/",
    setupNodeEvents(on, config) {
      // implement node event listeners here
      on('task',{
        queryTestDb:function(query) {
        const connection = mysql.createConnection(config.env.db)
        connection.connect()
        return new Promise((resolve, reject) => {
          connection.query(query,(err,results)=>{
            if(err){
              reject(err)
            } else {

              connection.end()
              return resolve(results)
            }
          })
        })
      },
      queryMongo: async function(object) {
        let client;
        try {
          client = new MongoClient(config.env.mongo);
          await client.connect();
          console.log("Connected to MongoDB");
  
          const db = client.db('cypress');
          const collection = db.collection("tests");
          const results = await collection.find(object).toArray();
          return results;
        } catch (e) {
          console.error("Error connecting to MongoDB", e);
          throw e;
        } finally {
          if (client) {
            await client.close();
            console.log("Disconnected from MongoDB");
          }
        }
      }
    })
    },
    excludeSpecPattern:[
      "**/1-getting-started/*.js",
      "**/2-advanced-examples/*.js"
    ]
  }
});

En mi caso me cree una base de datos llamada cypress y dentro una coleccion llamada tests, el objeto que cree solo para tener informacion que recuperar de dicha coleccion es {Name: 'Mauricio'} | Y finalmente para el test puse lo siguiente:

describe("Testing mongo", function() {
    it('Listing mongo', function () {
      let object = { Name: "Mauricio" };
      cy.task("queryMongo", object).then((results) => {
        cy.log(results);
        expect(results).to.have.length(1);
        expect(results[0].Name).to.be.eq("Mauricio")
      });
    });
});

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

Cómo probar MongoDB con 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