Node.js ve JavaScript Arasındaki Fark Nedir?

JavaScript bir programlama dilidir; Node.js ise bir runtime, yani JavaScript'i tarayıcının dışında çalıştıran bir programdır. Sözdizimi, tipler ve standart nesneler (Array, Promise, JSON) ikisinde de aynıdır. Değişen, kodunun etrafındaki ortamdır: tarayıcı bir web sayfasıyla çalışman için sana window ve document verir, Node.js ise dosyalar, sunucular ve işletim sistemiyle çalışman için global, process, require ve fs gibi modüller verir.

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

Tarayıcı global'leri undefined, Node.js olanları object ya da function yazdırdı; son satır da true yazdırdı, çünkü Node.js'te globalThis ve global aynı nesnedir. İlk altı satırı bir tarayıcı konsoluna yapıştırırsan sonuçlar tersine döner.

Tek tabloda fark

İnsanların en çok takıldığı satır modüller satırıdır. Node.js iki sistemi de, require ve import'u destekler, tarayıcılar ise yalnızca import'u anlar. Hangisini seçeceğini CommonJS vs ES modules sayfası açıklıyor.

Dil aynı

Yalnızca dili kullanan bir fonksiyon her yerde çalışır. Bu blokta Node'a özgü hiçbir şey yok ve bir tarayıcıda da aynı satırları yazdırırdı:

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

Program {"best":95,"average":85} ve Passed: 2 of 3 yazdırdı. Spread sözdizimi, reduce, template string'ler ve JSON dile aittir ve ECMAScript standardında tanımlıdır, bu yüzden her runtime'da vardır.

Yalnızca Node.js'te olanlar

Node'a özgü kısım, işletim sistemiyle konuşan yerleşik modüller ve global'lerdir:

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

Program bir dosya yazdı, onu geri okudu ve .txt 2 lines yazdırdı, ardından boş bir argüman listesi yazdırdı. Ne dosya erişimi ne de process.argv tarayıcıda vardır; orada bir sayfa diskine dokunamaz.

Hangi dil özelliklerini kullanabilirsin

Dilin sürümleri vardır (ES2015, ES2020, ES2024 ve diğerleri) ve her motor yeni özellikleri kendi hızında ekler. Node.js her sürümünde belirli bir V8 motoru getirir, yani hangi özelliklerin çalışacağına Node.js sürümün karar verir: örneğin Object.groupBy ve Array.prototype.findLast yeni bir sürüm ister. Bu yüzden tarayıcı özellik tabloları Node.js'i Chrome, Firefox ve Safari'nin yanında bir sütun daha olarak gösterir. Yeni bir sözdizimi SyntaxError ile patladığında ya da bir metot undefined çıktığında node --version çalıştır ve polyfill'e uzanmadan önce sürümünü yükselt.

İki ortamda da çalışan kod yazmak

Kütüphane yazarları bazen ortama özgü bir API'yi kullanmadan önce kodlarının nerede çalıştığını kontrol eder:

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

Mümkünse ortamın adını değil, ihtiyacın olan özelliği kontrol et: typeof fetch === 'function' "bu Node mu" sorusundan daha çok şey söyler. Bugün ikisinde de fetch, URL, TextEncoder, setTimeout ve structuredClone var, yani birkaç yıl öncesine göre daha az kod kontrole ihtiyaç duyuyor.

Sık yapılan hatalar

Bir Node.js script'inde document ya da window kullanmak. ReferenceError: document is not defined alırsın. O kodun yeri tarayıcıdır.

Tarayıcıda require kullanmak. Tarayıcılarda yoktur. import kullan ya da require çağrılarını tek bir dosyaya çeviren bir bundler kullan.

Node.js'in ayrı bir dil olduğunu düşünmek. Değildir. Bir JavaScript eğitimi bir şeyi öğretiyorsa, DOM kullanmadığı sürece o şey Node.js'te de çalışır.