Node.js vs JavaScript: ¿cuál es la diferencia?

JavaScript es un lenguaje de programación; Node.js es un runtime, un programa que ejecuta JavaScript fuera del navegador. La sintaxis, los tipos y los objetos estándar (Array, Promise, JSON) son los mismos en los dos. Lo que cambia es el entorno que rodea tu código: un navegador te da window y document para trabajar con una página web, mientras que Node.js te da global, process, require y módulos como fs para trabajar con archivos, servidores y el sistema operativo.

console.log('window:', typeof window);
console.log('document:', typeof document);

console.log('global:', typeof global);
console.log('process:', typeof process);
console.log('require:', typeof require);
console.log('Buffer:', typeof Buffer);

console.log('globalThis is global:', globalThis === global);

Los globales del navegador imprimieron undefined, los de Node.js object o function, y la última línea true, porque en Node.js globalThis y global son el mismo objeto. Pega las seis primeras líneas en la consola de un navegador y los resultados se invierten.

La diferencia en una tabla

La fila de módulos es la que más confunde. Node.js soporta los dos sistemas, require e import, mientras que los navegadores solo entienden import. La página CommonJS vs ES modules explica cuál elegir.

El lenguaje es el mismo

Una función que solo usa el lenguaje funciona en cualquier sitio. Este bloque no tiene nada específico de Node, e imprimiría las mismas líneas en un navegador:

const scores = [72, 95, 88];

const best = Math.max(...scores);
const average = scores.reduce((sum, s) => sum + s, 0) / scores.length;

console.log(JSON.stringify({ best, average }));
console.log(`Passed: ${scores.filter((s) => s >= 80).length} of ${scores.length}`);

Imprimió {"best":95,"average":85} y Passed: 2 of 3. El spread, reduce, los template strings y JSON son parte del lenguaje, definidos por el estándar ECMAScript, así que todos los runtimes los tienen.

Lo que solo tiene Node.js

La parte específica de Node es el conjunto de módulos integrados y globales que hablan con el sistema operativo:

const fs = require('fs');
const path = require('path');

fs.writeFileSync('report.txt', 'line one\nline two\n');
const lines = fs.readFileSync('report.txt', 'utf8').trim().split('\n');

console.log(path.extname('report.txt'), lines.length, 'lines');
console.log('arguments after the script:', process.argv.slice(2));

Escribió un archivo, lo volvió a leer e imprimió .txt 2 lines, y después una lista vacía de argumentos. Ni el acceso a archivos ni process.argv existen en un navegador, donde una página no puede tocar tu disco.

Qué funcionalidades del lenguaje tienes

El lenguaje tiene versiones (ES2015, ES2020, ES2024, etc.), y cada motor añade las novedades a su propio ritmo. Node.js incluye un motor V8 concreto en cada release, así que tu versión de Node.js decide qué funcionalidades van: Object.groupBy y Array.prototype.findLast, por ejemplo, necesitan una reciente. Por eso una tabla de compatibilidad de navegadores muestra Node.js como una columna más junto a Chrome, Firefox y Safari. Ejecuta node --version cuando una sintaxis nueva falle con un SyntaxError o un método sea undefined, y actualiza antes de recurrir a un polyfill.

Escribir código que funcione en los dos

Los autores de librerías a veces comprueban dónde se ejecuta su código antes de usar una API propia de un entorno:

const isNode = typeof process !== 'undefined' && process.versions?.node != null;
const isBrowser = typeof window !== 'undefined';

Cuando puedas, comprueba la funcionalidad que necesitas, no el nombre del entorno: typeof fetch === 'function' dice más que "¿esto es Node?". Hoy los dos tienen fetch, URL, TextEncoder, setTimeout y structuredClone, así que hace falta comprobar menos código que hace unos años.

Errores comunes

Usar document o window en un script de Node.js. Obtienes ReferenceError: document is not defined. Ese código pertenece al navegador.

Usar require en un navegador. Los navegadores no lo tienen. Usa import, o un bundler que convierta las llamadas a require en un solo archivo.

Pensar que Node.js es otro lenguaje. No lo es. Si un tutorial de JavaScript lo enseña, funciona en Node.js, salvo que use el DOM.