Kodėl vartoti path modulį vietoj eilutės susiejimo?

Question

Accepted Answer

Įmontuotas **`path`** modulis kuria ir manipuliuoja failų keliais **teisingai visose operacinėse sistemose**. Rankiniu būdu kelių eilutes sujungti su `/` sugeda Windows (kuriame naudojamas `\`) ir neteisingai tvarko kraštinius atvejus — `path` viską tvarko patikimai.

## Problemos su eilutės sujimu

```js
// ❌ fragile, OS-dependent, error-prone
const filePath = baseDir + "/" + "sub" + "/" + fileName;
// breaks on Windows (\), doubles slashes if baseDir ends in /, etc.
```

## Sprendimas: path.join

```js
import path from "path";

// ✅ uses the correct separator for the OS, normalizes slashes
const filePath = path.join(baseDir, "sub", fileName);
// Linux/Mac: baseDir/sub/file.txt   Windows: baseDir\sub\file.txt
```

`path.join` įterpia teisingą skyriklį, sutraukia pasikartojančius/baigiamųjų šlašus ir išsprendžia `..`/`.` segmentus.

## Kiti esminiai path funkcijos

```js
path.resolve("src", "app.js");  // → ABSOLUTE path from the cwd
path.basename("/a/b/file.txt");  // "file.txt"
path.dirname("/a/b/file.txt");   // "/a/b"
path.extname("file.txt");        // ".txt"
path.parse("/a/b/file.txt");     // { dir, base, name, ext }
path.sep;                         // "/" or "\" depending on OS
```

## Esamojo failo katalogo gavimas

```js
// CommonJS — built-in globals
const configPath = path.join(__dirname, "config.json");

// ES Modules — __dirname doesn't exist; derive it from import.meta.url
import { fileURLToPath } from "url";
const __dirname = path.dirname(fileURLToPath(import.meta.url));
```

Kelių sudarymas santykinai su esamu failu (naudojant `__dirname` arba jos ESM ekvivalentą) yra saugus būdas nuorodos į failus — nepriklausomai nuo to, kur buvo paleistas procesas.

## join vs resolve

```text
path.join    → just joins segments (relative stays relative)
path.resolve → produces an ABSOLUTE path (resolves from cwd / right-to-left)
```

## Kodėl tai svarbu

Vartojant `path` vietoj eilutės sujungimo failų tvarkymo kodas tampa **tarpplatforminis ir patikimas** — dažnas klaidų šaltinis, kai Mac/Linux sistemoje parašytas kodas sugenda Windows, arba kai sujungimas sukuria pažeistus kelius.

Tai maža mažumėlė, duodanti dideles patikimumo naudas, o žinojus `join` prieš `resolve`, ir kaip gauti `__dirname` ESM, padengiami kasdienio kelio poreikiai bet kuriame Node projekte, kuris liečia failų sistemą.