Koja je razlika između CommonJS-a i ES Modula u Node-u?

Question

Accepted Answer

Node podržava **dva modula sustava**: **CommonJS (CJS)** — originalni, korištenjem `require`/`module.exports` — i **ES Moduli (ESM)** — standard, korištenjem `import`/`export`. Razlikuju se u sintaksi, ponašanju učitavanja i interoperabilnosti.

## CommonJS — Nodeov original

```js
// math.js
function add(a, b) { return a + b; }
module.exports = { add };

// app.js
const { add } = require("./math"); // synchronous, runtime
```

## ES Moduli — standard

```js
// 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
```

## Ključne razlike

```text
                 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)
```

## Omogućavanje ESM-a

```json
// package.json
{ "type": "module" }  // now .js files are treated as ESM
```

Ili eksplicitno koristite `.mjs` nastavak. Bez ovoga, Node默认 `.js` na CommonJS.

## Problemi interoperabilnosti

```js
// 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");
```

Groba granica: CJS ne može `require()` ESM-only pakete — česti problem pri migraciji. Također imajte na umu da ESM nema `__dirname` (koristite `import.meta.url`).

## Zašto je to važno

Poznavanje oba sustava je bitno za pravi Node rad: ESM je budućnost (standard, tree-shakeable, top-level await, poravnano s preglednikom) i pravi izbor za nove projekte, ali ogromna količina npm ekosustava i postojećeg koda je CommonJS.

Razumijevanje razlika u sintaksi, kako omogućiti ESM (`"type": "module"`), i ograničenja interoperabilnosti (posebno CJS-ne-može-require-ESM) sprječava česte zbunjenosti i greške koje se pojavljuju pri miješanju njih.