Cad an difríochtaí idir CommonJS agus ES Modules i Node?

Question

Accepted Answer

Tacaíonn Node **dhá chóras modúl**: **CommonJS (CJS)** — an bunaidh, ag úsáid `require`/`module.exports` — agus **ES Modules (ESM)** — an caighdeán, ag úsáid `import`/`export`. Bíonn difríochtaí acu i gcomhréir, iompraíocht ualú, agus idirghaolmhaireacht.

## CommonJS — an bunaidh de Node

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

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

## ES Modules — an caighdeán

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

## Príomhdifríochtaí

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

## ESM a Chumasclóiriú

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

Nó úsáid an síneadh `.mjs` go soiléir. Gan seo, úsáideann Node go réamhshocrú `.js` mar CommonJS.

## Droichimíochtaí idirghaolmhaireachta

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

An imeall garbh: Ní féidir le CJS a `require()` pacáistí ESM-amháin — pian inathraithe coitianta. Fréamh freisin nach bhfuil `__dirname` ag ESM (úsáid `import.meta.url`).

## Cén fáth a bheidh dúil aici

Tá eolas ar an dá chóras riachtanach do fhíor-shaothar Node: Is é ESM an todhchaí (caighdeán, tree-shakeable, top-level await, ailínithe ar an bhforghaoir) agus an rogha cheart do thionscadail nua, ach is CommonJS a bhíonn i gcodanna móra den éiceolaíocht npm agus an chód atá ann.

An difríochtaí i gcomhréir, conas ESM a chumasclóiriú (`"type": "module"`), agus na teorainneacha idirghaolmhaireachta (go háirithe ní féidir le CJS ESM a éileamh) a thuiscint stopann sé an mearbhall agus na hearráidí a bhíonn ann nuair a dhéantar iad a mheascadh.