Node.js vs. JavaScript: Was ist der Unterschied?

JavaScript ist eine Programmiersprache; Node.js ist eine Runtime, ein Programm, das JavaScript außerhalb des Browsers ausführt. Syntax, Typen und Standardobjekte (Array, Promise, JSON) sind in beiden gleich. Was sich ändert, ist die Umgebung um deinen Code: Ein Browser gibt dir window und document, um mit einer Webseite zu arbeiten, während Node.js dir global, process, require und Module wie fs gibt, um mit Dateien, Servern und dem Betriebssystem zu arbeiten.

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);

Die Browser-Globals haben undefined ausgegeben, die von Node.js object oder function, und die letzte Zeile true, weil globalThis und global in Node.js dasselbe Objekt sind. Füg die ersten sechs Zeilen in eine Browser-Konsole ein, und die Ergebnisse drehen sich um.

Der Unterschied in einer Tabelle

Die Zeile zu Modulen bringt die meisten Leute durcheinander. Node.js unterstützt beide Systeme, require und import, während Browser nur import verstehen. Die Seite CommonJS vs. ES-Module erklärt, welches du nehmen solltest.

Die Sprache ist dieselbe

Eine Funktion, die nur die Sprache nutzt, läuft überall. Dieser Block enthält nichts Node-Spezifisches und würde in einem Browser dieselben Zeilen ausgeben:

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}`);

Es hat {"best":95,"average":85} und Passed: 2 of 3 ausgegeben. Spread-Syntax, reduce, Template Strings und JSON gehören zur Sprache, die der ECMAScript-Standard definiert, deshalb hat jede Runtime sie.

Was nur Node.js hat

Der Node-spezifische Teil sind die eingebauten Module und Globals, die mit dem Betriebssystem sprechen:

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));

Es hat eine Datei geschrieben, sie zurückgelesen und .txt 2 lines ausgegeben, dann eine leere Liste von Argumenten. Weder Dateizugriff noch process.argv gibt es im Browser, wo eine Seite deine Festplatte nicht anfassen kann.

Welche Sprachfeatures du bekommst

Die Sprache hat Versionen (ES2015, ES2020, ES2024 und so weiter), und jede Engine führt neue Features in ihrem eigenen Tempo ein. Node.js bringt pro Release eine bestimmte V8-Engine mit, deine Node.js-Version entscheidet also, welche Features funktionieren: Object.groupBy und Array.prototype.findLast zum Beispiel brauchen eine aktuelle. Eine Kompatibilitätstabelle für Browser führt Node.js deshalb als weitere Spalte neben Chrome, Firefox und Safari. Führ node --version aus, wenn eine neuere Syntax mit einem SyntaxError fehlschlägt oder eine Methode undefined ist, und aktualisier, bevor du zu einem Polyfill greifst.

Code, der in beiden läuft

Autoren von Bibliotheken prüfen manchmal, wo ihr Code läuft, bevor sie eine umgebungsspezifische API nutzen:

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

Prüf nach Möglichkeit auf das Feature, das du brauchst, nicht auf den Namen der Umgebung: typeof fetch === 'function' sagt mehr als "ist das Node". Beide haben heute fetch, URL, TextEncoder, setTimeout und structuredClone, es braucht also weniger Code eine Prüfung als noch vor ein paar Jahren.

Häufige Fehler

document oder window in einem Node.js-Skript verwenden. Du bekommst ReferenceError: document is not defined. Dieser Code gehört in einen Browser.

require im Browser verwenden. Browser haben es nicht. Nimm import oder einen Bundler, der require-Aufrufe in eine Datei verwandelt.

Glauben, Node.js sei eine andere Sprache. Ist es nicht. Was ein JavaScript-Tutorial beibringt, funktioniert in Node.js, außer es nutzt das DOM.