El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia

HOME

En este módulo, aprenderemos a realizar pruebas unitarias en aplicaciones Node.js utilizando Mocha y Chai. Las pruebas unitarias son fundamentales para asegurar que cada parte de tu aplicación funcione correctamente de manera aislada.

¿Qué es Mocha?

Mocha es un framework de pruebas para Node.js que facilita la escritura de pruebas asíncronas y proporciona una estructura flexible para organizar y ejecutar pruebas.

Características de Mocha:

Soporte para pruebas asíncronas.
Salida de informes personalizable.
Funciona con cualquier biblioteca de aserciones.

¿Qué es Chai?

Chai es una biblioteca de aserciones que se puede usar con cualquier framework de pruebas. Proporciona una sintaxis legible y expresiva para escribir aserciones.

Características de Chai:

Soporte para diferentes estilos de aserciones: TDD (Test-Driven Development) y BDD (Behavior-Driven Development).
Extensible con plugins.

Instalación de Mocha y Chai

Para comenzar, necesitamos instalar Mocha y Chai en nuestro proyecto. Puedes hacerlo utilizando npm:

npm install --save-dev mocha chai

Configuración de Mocha

Crear una estructura de directorios para las pruebas:
```
mkdir test
```

Agregar un script de prueba en package.json:

{
  "scripts": {
    "test": "mocha"
  }
}

Escribiendo tu Primera Prueba

Vamos a escribir una prueba simple para una función que suma dos números. Primero, creamos un archivo sum.js en el directorio src:

// src/sum.js
function sum(a, b) {
  return a + b;
}

module.exports = sum;

Ahora, creamos un archivo de prueba sum.test.js en el directorio test:

// test/sum.test.js
const chai = require('chai');
const expect = chai.expect;
const sum = require('../src/sum');

describe('Función sum', () => {
  it('debería devolver la suma de dos números', () => {
    const result = sum(2, 3);
    expect(result).to.equal(5);
  });

  it('debería devolver un número negativo si la suma es negativa', () => {
    const result = sum(-2, -3);
    expect(result).to.equal(-5);
  });
});

Explicación del Código:

describe: Agrupa pruebas relacionadas. En este caso, estamos agrupando pruebas para la función sum.
it: Define una prueba individual. Cada prueba tiene una descripción y una función que contiene las aserciones.
expect: Es una función de Chai que se usa para hacer aserciones. En este caso, estamos verificando que el resultado de sum(2, 3) sea igual a 5.

Ejecutando las Pruebas

Para ejecutar las pruebas, simplemente corre el siguiente comando en tu terminal:

npm test

Deberías ver una salida similar a esta:

  Función sum
    ✓ debería devolver la suma de dos números
    ✓ debería devolver un número negativo si la suma es negativa

  2 passing (10ms)

Pruebas Asíncronas

Mocha facilita la escritura de pruebas asíncronas. Supongamos que tenemos una función que lee un archivo de manera asíncrona:

// src/readFile.js
const fs = require('fs');

function readFile(filePath, callback) {
  fs.readFile(filePath, 'utf8', (err, data) => {
    if (err) return callback(err);
    callback(null, data);
  });
}

module.exports = readFile;

Podemos escribir una prueba para esta función de la siguiente manera:

// test/readFile.test.js
const chai = require('chai');
const expect = chai.expect;
const readFile = require('../src/readFile');
const fs = require('fs');
const path = require('path');

describe('Función readFile', () => {
  it('debería leer el contenido de un archivo', (done) => {
    const filePath = path.join(__dirname, 'test.txt');
    fs.writeFileSync(filePath, 'Hola, mundo!');

    readFile(filePath, (err, data) => {
      expect(err).to.be.null;
      expect(data).to.equal('Hola, mundo!');
      fs.unlinkSync(filePath); // Limpieza
      done();
    });
  });
});

Explicación del Código:

done: Es una función que Mocha proporciona para manejar pruebas asíncronas. Llamamos a done cuando la prueba ha terminado.
fs.writeFileSync y fs.unlinkSync: Estas funciones se usan para crear y eliminar un archivo de prueba.

Ejercicios Prácticos

Ejercicio 1: Prueba de una Función de Multiplicación

Crea una función multiply que multiplique dos números.
Escribe pruebas para verificar que la función multiply funciona correctamente.

Solución:

// src/multiply.js
function multiply(a, b) {
  return a * b;
}

module.exports = multiply;

// test/multiply.test.js
const chai = require('chai');
const expect = chai.expect;
const multiply = require('../src/multiply');

describe('Función multiply', () => {
  it('debería devolver el producto de dos números', () => {
    const result = multiply(2, 3);
    expect(result).to.equal(6);
  });

  it('debería devolver cero si uno de los números es cero', () => {
    const result = multiply(0, 5);
    expect(result).to.equal(0);
  });
});

Ejercicio 2: Prueba de una Función Asíncrona

Crea una función fetchData que simule una llamada a una API y devuelva datos después de 1 segundo.
Escribe pruebas para verificar que la función fetchData funciona correctamente.

Solución:

// src/fetchData.js
function fetchData(callback) {
  setTimeout(() => {
    callback(null, { data: 'Datos de la API' });
  }, 1000);
}

module.exports = fetchData;

// test/fetchData.test.js
const chai = require('chai');
const expect = chai.expect;
const fetchData = require('../src/fetchData');

describe('Función fetchData', () => {
  it('debería devolver datos después de 1 segundo', (done) => {
    fetchData((err, data) => {
      expect(err).to.be.null;
      expect(data).to.deep.equal({ data: 'Datos de la API' });
      done();
    });
  });
});

Conclusión

En este módulo, hemos aprendido a realizar pruebas unitarias en Node.js utilizando Mocha y Chai. Hemos cubierto la instalación, configuración y escritura de pruebas tanto síncronas como asíncronas. Además, hemos proporcionado ejercicios prácticos para reforzar los conceptos aprendidos.

En el siguiente módulo, exploraremos las pruebas de integración y cómo asegurar que diferentes partes de tu aplicación funcionen correctamente juntas.

Pruebas Unitarias con Mocha y Chai

¿Qué es Mocha?

Características de Mocha:

¿Qué es Chai?

Características de Chai:

Instalación de Mocha y Chai

Configuración de Mocha

Escribiendo tu Primera Prueba

Explicación del Código:

Ejecutando las Pruebas

Pruebas Asíncronas

Explicación del Código:

Ejercicios Prácticos

Ejercicio 1: Prueba de una Función de Multiplicación

Solución:

Ejercicio 2: Prueba de una Función Asíncrona

Solución:

Conclusión

Curso de Node.js

Módulo 1: Introducción a Node.js

Módulo 2: Conceptos Básicos

Módulo 3: Sistema de Archivos y E/S

Módulo 4: HTTP y Servidores Web

Módulo 5: NPM y Gestión de Paquetes

Módulo 6: Framework Express.js

Módulo 7: Bases de Datos y ORMs

Módulo 8: Autenticación y Autorización

Módulo 9: Pruebas y Depuración

Módulo 10: Temas Avanzados

Módulo 11: Despliegue y DevOps

Módulo 12: Proyectos del Mundo Real