რა განსხვავება არის CommonJS-სა და ES Modules-ს შორის Node-ში?

Question

Accepted Answer

Node-ი მხარს უჭერს **ორი მოდულის სისტემას**: **CommonJS (CJS)** — ორიგინალური, `require`/`module.exports`-ის გამოყენებით — და **ES Modules (ESM)** — სტანდარტი, `import`/`export`-ის გამოყენებით. ისინი განსხვავდებიან სინტაქსით, დატვირთვის ქცევით და ურთიერთოპერაბილურობით.

## CommonJS — Node-ის ორიგინალური

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

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

## ES Modules — სტანდარტი

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

## ძირითადი განსხვავებები

```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-ის ჩართვა

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

ან გამოიყენეთ `.mjs` გაფართოება ცალსახად. ამის გარეშე, Node-ი `.js`-ს CommonJS-ზე ნაგულისხმევად დააყენებს.

## ურთიერთოპერაბილურობის ხელის კიდეები

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

თავის მტკივნეული ნაწილი: CJS არ შეუძლია `require()` ESM-only პაკეტებს — მიგრაციის ჩვეულებრივი პრობლემა. ასევე გაითვალისწინეთ, რომ ESM-ს არ აქვს `__dirname` (გამოიყენეთ `import.meta.url` სამაგიეროდ).

## რატომ არის ეს მნიშვნელოვანი

ორივე სისტემის ცოდნა აუცილებელია რეალური Node-ის სამუშაოსთვის: ESM არის მომავალი (სტანდარტი, tree-shakeable, top-level await, ბრაუზერთან გასწორებული) და ახალი პროექტების სწორი არჩევანი, მაგრამ npm ეკოსისტემის დიდი ნაწილი და არსებული კოდი CommonJS-ია.

სინტაქსის განსხვავებების გაგება, ESM-ის ჩართვის ხერხი (`"type": "module"`), და ურთიერთოპერაბილურობის შეზღუდვები (განსაკუთრებით CJS-არ-შეუძლია-require-ESM) აკრძალავს ხშირ დაბნევას და შეცდომებს, რომლებიც ისინი შერევის დროს წარმოიქმნება.