Nivel inicial9 min de lectura · Publicado el

Añadir Node.js, Jest y Chai a IntelliJ IDEA

Node, Jest y Chai en IntelliJ IDEA: IntelliJ usa Node.js, Node ejecuta Jest y suma.test.js da 2 passed; Chai ya no hace falta. Jest en IntelliJ, sin Chairubentejera.com IntelliJ IDEANode.jsJestsuma.test.jsTests: 2 passedChaino hace falta
IntelliJ necesita un Node.js configurado para ejecutar JavaScript; con él, Jest lanza suma.test.js y marca 2 passed. Chai sobra porque Jest trae su propio expect, aunque se puede añadir para migrar tests antiguos.

Quieres escribir y lanzar tests de JavaScript sin salir de IntelliJ IDEA. Para eso necesitas tres piezas, y cada una tiene su papel:

  • Node.js ejecuta JavaScript fuera del navegador. Es el motor.
  • npm viene con Node e instala librerías en tu proyecto. Es el repartidor.
  • Jest ejecuta tus tests y te dice cuáles fallan. Es el examinador.

IntelliJ es donde escribes y lanzas los tests, pero por sí solo no ejecuta JavaScript: necesita a Node para ejecutarlo y a Jest para comprobar los resultados.

Elige tu sistema

Comprobar si tienes instalado Node y npm

Abre un terminal (en IntelliJ, con Alt + F12⌥ + F12) y escribe:

node --version
npm --version

Si ves dos números de versión, ya los tienes. Si el terminal dice que no encuentra el comando, toca instalarlos.

Instalar Node y npm

En Ubuntu puedes instalarlo con apt, pero te dará una versión antigua: en Ubuntu 26.04, el paquete nodejs es la versión 22, mientras que la LTS (la versión con soporte largo, la recomendada) es ya la 26.

La forma más cómoda es nvm, un gestor que instala la versión que quieras y te deja cambiar de una a otra:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
# Abre un terminal nuevo y después:
nvm install --lts

Con eso tienes Node y npm a la vez. Te lo explico paso a paso, también para macOS y Windows, en NVM (Node Version Manager): qué es y cómo se usa. Si prefieres no usar nvm, en nodejs.org tienes el instalador oficial para cada sistema.

Añadir Node.js a IntelliJ IDEA y elegir su versión

IntelliJ suele detectar Node solo. Para comprobarlo o elegir otra versión:

  1. Abre los ajustes con Ctrl + Alt + S⌘ + ,.
  2. Ve a Languages & Frameworks › JavaScript Runtime.
  3. En Preferred runtime, elige Node.js y, en la lista de abajo, la versión que has instalado. Si no aparece, añádela buscando su carpeta.
  4. En Package manager, deja npm (o elige Yarn, pnpm o bun si usas otro).

No hace falta instalar ningún plugin para esto: el plugin JavaScript and TypeScript viene incluido y activado por defecto. Si no ves estas opciones, comprueba en Settings › Plugins que no lo has desactivado.

Si usas una versión antigua de IntelliJ

Hasta la versión 2025.2, Node se configuraba en otra página. En 2018, cuando escribí la primera versión de este artículo, había que instalar el plugin NodeJS desde Plugins › Browse Repositories:

Ventana Browse Repositories de IntelliJ IDEA 2018 con la búsqueda nodejs y el plugin NodeJS de JetBrains seleccionado

Después aparecía la página Languages & Frameworks › Node.js and NPM, con el intérprete de Node y los paquetes instalados:

Ajustes de IntelliJ IDEA 2018 en Node.js and NPM: intérprete /usr/bin/node 8.11.1, gestor npm y el paquete jest 22.4.3 instalado

Desde la versión 2025.3, Node.js, Bun y Deno se configuran juntos en la página JavaScript Runtime que has visto arriba.

Añadir Jest al proyecto

Jest se instala en cada proyecto, no en IntelliJ. En el terminal, dentro de la carpeta del proyecto:

npm init -y                  # crea package.json, si aún no lo tienes
npm install --save-dev jest  # instala Jest solo para desarrollo
npm pkg set scripts.test=jest

La última línea añade a tu package.json el script test, para que npm test lance Jest. Si quieres más detalle sobre la configuración, lo cuento en Instalar Jest en un proyecto de JavaScript.

Un primer test

Crea suma.js:

function suma(a, b) {
  return a + b;
}

module.exports = suma;

Y a su lado, suma.test.js:

const suma = require('./suma');

describe('suma', () => {
  test('1 + 2 da 3', () => {
    expect(suma(1, 2)).toBe(3);
  });

  test('un número más 0 da el mismo número', () => {
    expect(suma(5, 0)).toBe(5);
  });
});

describe, test y expect no se importan: Jest los pone a tu disposición en cada fichero de test. Lánzalo con npm test:

Test Suites: 1 passed, 1 total
Tests:       2 passed, 2 total
Snapshots:   0 total
Time:        0.336 s, estimated 1 s
Ran all test suites.

Lanzar los tests desde IntelliJ

Con Jest instalado, IntelliJ muestra un icono verde de ejecutar junto a cada test y cada describe:

  • Un test: pulsa el icono del margen o pon el cursor dentro y usa Ctrl + Shift + F10⌃ + ⇧ + R.
  • Una carpeta: clic derecho sobre ella en el panel del proyecto y Run ‘Tests in…’.
  • Una configuración propia: Run › Edit Configurations, botón + y Jest. Ahí eliges el fichero de configuración, las opciones de Jest (por ejemplo, --watch para que se relancen al guardar) y las de Node.

Los resultados salen en un árbol: si un test falla, un clic te lleva a la línea que lo ha roto. También puedes depurar un test o ver la cobertura desde el mismo menú del icono.

Si no autocompleta test ni expect

Como test y expect no se importan, a veces el editor no sabe de dónde salen. Tienes dos soluciones:

  1. Descargar los tipos de Jest. En Settings › Languages & Frameworks › JavaScript › Libraries, pulsa Download, busca jest y pulsa Download and Install. También puedes ponerte sobre el require y pulsar Alt + Enter⌥ + ⏎ para que te lo ofrezca.
  2. Importarlos de forma explícita, como recomienda Jest si lo prefieres así: const { describe, expect, test } = require('@jest/globals');.

Así se veía la página de librerías en 2018, con @types/jest ya añadido. Hoy el botón Download sigue en el mismo sitio:

Ajustes de IntelliJ IDEA en Languages & Frameworks, JavaScript, Libraries: la librería @types/jest activada y el botón Download a la derecha

¿Y Chai? Con Jest ya no lo necesitas

Chai es una librería de aserciones: la parte que dice «espero que esto valga 3». Era habitual combinarla con Mocha, que no trae aserciones propias. Jest sí las trae, así que añadir Chai es como llevar dos reglas en el estuche.

Jest ya trae su propio expect.

Si vienes de Chai, el cambio es casi directo:

Chai Jest
expect(x).to.equal(3) expect(x).toBe(3)
expect(obj).to.deep.equal({ a: 1 }) expect(obj).toEqual({ a: 1 })
expect(ok).to.be.true expect(ok).toBe(true)
expect(lista).to.include(2) expect(lista).toContain(2)
expect(fn).to.throw() expect(fn).toThrow()

Si aun así quieres usar Chai con Jest

Por ejemplo, porque migras tests antiguos poco a poco. Ten en cuenta dos cosas:

  • Los dos se llaman expect. Renombra el de Chai al importarlo para no pisar el de Jest:

    const { expect: chaiExpect } = require('chai');
    
    test('con Chai', () => {
      chaiExpect(suma(1, 2)).to.equal(3);
    });
  • Chai 6 solo se distribuye como módulo ES (el formato de import/export). Con Jest 30 en Node 24, el require('chai') anterior falla con «Must use import to load ES Module». Se arregla activando el soporte de módulos de Jest: en la terminal, NODE_OPTIONS=--experimental-vm-modules npx jest; en IntelliJ, escribe --experimental-vm-modules en el campo Node options de tu configuración de Jest. Node avisa de que es una función experimental.

Si el proyecto es nuevo, ahórrate el lío y usa solo el expect de Jest.

Tests a un atajo, también cuando programas con IA

Tener los tests a una combinación de teclas cambia cuántas veces los lanzas. Y eso importa todavía más si un asistente de IA te escribe parte del código: el criterio del enfoque IA Limpia es no dar por bueno nada que no pase por tus tests. Cuanto menos cuesta comprobarlo, más a menudo lo compruebas.

Tu chuleta

Qué Dónde o cómo
Ver si tienes Node y npm node --version y npm --version
Instalar Node nvm install --lts
Elegir el Node de IntelliJ Settings › Languages & Frameworks › JavaScript Runtime
Instalar Jest en el proyecto npm install --save-dev jest
Lanzar el test del cursor Ctrl + Shift + F10⌃ + ⇧ + R
Autocompletado de Jest Settings › Languages & Frameworks › JavaScript › Libraries › Download
Chai No hace falta: usa el expect de Jest

Fuentes

Comprobado en noviembre de 2026:

Ejecutado: el proyecto de ejemplo con Jest 30.5.2 y npm 11.19.0 en Node 24.21.0 (Ubuntu 26.04); las equivalencias de la tabla con Chai 6.3.0 dentro de Jest, que fallan sin --experimental-vm-modules y pasan con él; y la instalación con nvm 0.41.0, que instala Node 26.13.0 (LTS) y npm 11.20.0, en un contenedor ubuntu:24.04. Los pasos de la interfaz de IntelliJ salen de su ayuda oficial; las capturas son de IntelliJ IDEA 2018.1.