Node iki modül sistemini destekler: CommonJS (CJS) — orijinal, require/module.exports kullanan — ve ES Modules (ESM) — standart, import/ kullanan. Sözdizimi, yükleme davranışı ve interop açısından farklılık gösterirler.
Node iki modül sistemini destekler: CommonJS (CJS) — orijinal, require/module.exports kullanan — ve ES Modules (ESM) — standart, import/ kullanan. Sözdizimi, yükleme davranışı ve interop açısından farklılık gösterirler.
export// math.js
function add(a, b) { return a + b; }
module.exports = { add };
// app.js
const { add } = require("./math"); // synchronous, runtime
// math.mjs (or .js with "type": "module")
export function add(a, b) { return a + b; }
export default something;
// app.mjs
import { add } from "./math.mjs"; // static, hoisted
CommonJS ES Modules
Syntax require/module.exports import/export
Loading synchronous, runtime static, hoisted
Top-level await no yes
Tree-shaking hard yes (statically analyzable)
File extension .cjs / .js (default) .mjs / .js with "type":"module"
__dirname/__filename available not available (use import.meta.url)
// package.json
{ "type": "module" } // now .js files are treated as ESM
Veya .mjs uzantısını açıkça kullanın. Bunu yapmazsa, Node .js dosyalarını varsayılan olarak CommonJS olarak ayarlar.
// ESM can import CommonJS:
import pkg from "some-cjs-lib"; // works (default import)
// CommonJS CANNOT require() a pure-ESM package (it's async):
const esm = require("esm-only-pkg"); // ❌ ERR_REQUIRE_ESM
// must use dynamic import: const esm = await import("esm-only-pkg");
En çetrefilli kısım: CJS, ESM-only paketleri require() yapamaz — yaygın bir göç sorunu. Ayrıca ESM'in __dirname eksik olduğunu unutmayın (import.meta.url kullanın).
Gerçek Node işleri için her iki sistemi bilmek gerekir: ESM geleceğin sistemi (standart, tree-shakeable, top-level await, tarayıcı uyumlu) ve yeni projeler için doğru seçim, ancak npm ekosisteminin ve mevcut kodun büyük bir bölümü CommonJS'dir.
Sözdizimi farklarını, ESM'i nasıl etkinleştireceğinizi ("type": "module"), ve interop sınırlamalarını (özellikle CJS-can't-require-ESM) anlamak, bunları karıştırırken ortaya çıkan sık hatalar ve kafa karışıklığını önler.
Junior'dan Senior'a detaylı cevaplarla bir BT mülakat soruları kütüphanesi.
Bağış Yap