Añadir Node.js, Jest y Chai a IntelliJ IDEA
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.
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:
- Abre los ajustes con Ctrl + Alt + S⌘ + ,.
- Ve a Languages & Frameworks › JavaScript Runtime.
- 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.
- 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:
Después aparecía la página Languages & Frameworks › Node.js and NPM, con el intérprete de Node y los paquetes instalados:
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,
--watchpara 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:
- Descargar los tipos de Jest. En Settings › Languages & Frameworks › JavaScript › Libraries, pulsa Download, busca
jesty pulsa Download and Install. También puedes ponerte sobre elrequirey pulsar Alt + Enter⌥ + ⏎ para que te lo ofrezca. - 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:
¿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, elrequire('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-modulesen 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:
- Ayuda oficial de IntelliJ IDEA 2026.3: Node.js, JavaScript Runtime, Jest, librerías de JavaScript, JavaScript e IntelliJ IDEA como producto unificado.
- Blog de JetBrains: Core JavaScript and TypeScript Features Become Free in IntelliJ IDEA (versión 2026.1), para qué es gratuito y qué queda en Ultimate.
- Documentación de Jest 30.5: Globals y ECMAScript Modules.
- Descarga de Node.js y nvm (v0.41.0).
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.