Node.js a JavaScript: czym się różnią?

JavaScript to język programowania; Node.js to środowisko uruchomieniowe, czyli program, który wykonuje JavaScript poza przeglądarką. Składnia, typy i standardowe obiekty (Array, Promise, JSON) są w obu takie same. Zmienia się otoczenie twojego kodu: przeglądarka daje ci window i document do pracy ze stroną, a Node.js daje global, process, require i moduły takie jak fs do pracy z plikami, serwerami i systemem operacyjnym.

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

Globalne obiekty przeglądarki wypisały undefined, te z Node.js object albo function, a ostatnia linia true, bo w Node.js globalThis i global to ten sam obiekt. Wklej sześć pierwszych linii do konsoli przeglądarki, a wyniki się odwrócą.

Różnica w jednej tabeli

Najwięcej zamieszania robi wiersz o modułach. Node.js obsługuje oba systemy, require i import, a przeglądarki rozumieją tylko import. Strona CommonJS vs moduły ES wyjaśnia, który wybrać.

Język jest ten sam

Funkcja, która używa tylko języka, działa wszędzie. Ten blok nie ma w sobie nic specyficznego dla Node i w przeglądarce wypisałby te same linie:

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

Wypisało {"best":95,"average":85} i Passed: 2 of 3. Składnia spread, reduce, template stringi i JSON należą do języka, zdefiniowanego przez standard ECMAScript, więc ma je każde środowisko.

Co ma tylko Node.js

Część specyficzna dla Node to zestaw wbudowanych modułów i obiektów globalnych, które rozmawiają z systemem operacyjnym:

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

Zapisało plik, odczytało go z powrotem i wypisało .txt 2 lines, a potem pustą listę argumentów. Ani dostęp do plików, ani process.argv nie istnieją w przeglądarce, gdzie strona nie może dotknąć twojego dysku.

Jakie funkcje języka dostajesz

Język ma wersje (ES2015, ES2020, ES2024 i tak dalej), a każdy silnik dodaje nowe funkcje we własnym tempie. Node.js w każdym wydaniu zawiera konkretny silnik V8, więc to twoja wersja Node.js decyduje, które funkcje działają: na przykład Object.groupBy i Array.prototype.findLast wymagają nowej wersji. Tabela kompatybilności przeglądarek pokazuje więc Node.js jako kolejną kolumnę obok Chrome, Firefox i Safari. Uruchom node --version, gdy nowsza składnia kończy się SyntaxError albo metoda jest undefined, i zaktualizuj Node, zanim sięgniesz po polyfill.

Kod, który działa w obu

Autorzy bibliotek czasem sprawdzają, gdzie działa ich kod, zanim użyją API specyficznego dla środowiska:

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

Jeśli możesz, sprawdzaj funkcję, której potrzebujesz, a nie nazwę środowiska: typeof fetch === 'function' mówi więcej niż "czy to Node". Oba mają dziś fetch, URL, TextEncoder, setTimeout i structuredClone, więc mniej kodu wymaga sprawdzania niż kilka lat temu.

Częste błędy

Używanie document albo window w skrypcie Node.js. Dostaniesz ReferenceError: document is not defined. Ten kod należy do przeglądarki.

Używanie require w przeglądarce. Przeglądarki go nie mają. Użyj import albo bundlera, który zamieni wywołania require w jeden plik.

Myślenie, że Node.js to inny język. To nie jest inny język. Jeśli tutorial JavaScript czegoś uczy, działa to w Node.js, chyba że używa DOM.