...
Eroare Node.js · Module CommonJS: require și module.exports

Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:fs/promise

Pe scurt

Ai cerut cu prefixul node: un modul de bază care nu există, aproape mereu din cauza unei greșeli de scriere: node:fs/promise în loc de node:fs/promises, node:paths în loc de node:path. Corectează numele; lista exactă e în require("module").builtinModules.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Prefixul node: îi spune lui Node că vrei un modul de bază (node:fs, node:path, node:crypto), nu un pachet din node_modules sau un fișier al tău. Pentru că știe sigur unde să caute, Node nu mai încearcă alte variante: dacă numele de după node: nu e în lista modulelor de bază, primești imediat ERR_UNKNOWN_BUILTIN_MODULE.

Cauza e aproape întotdeauna o literă în plus sau în minus: node:fs/promise (corect node:fs/promises), node:paths (corect node:path), node:event (corect node:events), node:http2s. Mai rar, codul e scris pentru o versiune mai nouă de Node decât cea instalată, iar modulul (de exemplu node:sqlite) încă nu există la tine.

Fără prefix, aceeași greșeală dă Cannot find module 'fs/promise', pentru că Node caută apoi și în node_modules.

De ce apare: cauzele frecvente

1Greșeală de scriere în numele modulului

Greșit
JavaScript
const fs = require("node:fs/promise");
Corect
JavaScript
const fs = require("node:fs/promises");

Modulul cu promisiuni se numește fs/promises, la plural.

2Nume ghicit în loc de numele real

Greșit
JavaScript
import { EventEmitter } from "node:event";
import path from "node:paths";
Corect
JavaScript
import { EventEmitter } from "node:events";
import path from "node:path";

Numele modulelor de bază sunt fixe (events, path, child_process, readline). Când nu ești sigur, verifică în require("module").builtinModules.

3Modul care nu există în versiunea ta de Node

Greșit
JavaScript
// Node 20
const { DatabaseSync } = require("node:sqlite");
Corect
JavaScript
// verifică versiunea
console.log(process.version);
// actualizează Node sau folosește un pachet npm

Modulele noi apar doar în versiunile noi. Codul copiat din documentația celei mai noi versiuni poate cere un modul pe care Node-ul tău nu îl are.

Repară tu

Repară eroarea, direct în pagină

Programul citește două fișiere de note cu API-ul de promisiuni al modulului fs, dar numele modulului e scris greșit și Node se oprește cu Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:fs/promise. Corectează numele modulului, ca programul să afișeze câte note are fiecare fișier și media lor.

Codul care dă eroarea
JavaScript
const fs = require("node:fs/promise");

async function main() {
  for (const fisier of ["note-mate.txt", "note-info.txt"]) {
    const note = (await fs.readFile(fisier, "utf8")).trim().split("\n").map(Number);
    const media = note.reduce((s, n) => s + n, 0) / note.length;
    console.log(`${fisier}: ${note.length} note, media ${media.toFixed(2)}`);
  }
}

main();
După reparație, programul afișează
note-mate.txt: 3 note, media 8.67
note-info.txt: 4 note, media 9.25
Indiciu

Modulul cu promisiuni pentru fișiere se scrie la plural.

Alte forme ale mesajului

  • Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:paths
  • Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:event
  • Error: Cannot find module 'node:fs/promise'
  • Error: Cannot find module 'fs/promise'

Cum o eviți pe viitor

  • Lasă editorul să completeze importurile: VS Code îți propune numele exacte ale modulelor de bază.
  • Ține minte pluralele: fs/promises, timers/promises, readline/promises, events.
  • Când copiezi cod de pe internet, verifică ce versiune de Node cere și compar-o cu node -v.
  • Folosește prefixul node: pentru modulele de bază: greșelile apar imediat și nu se confundă cu pachete din node_modules.

Întrebări frecvente

Trebuie să pun prefixul node: peste tot?

Nu e obligatoriu (require("fs") merge la fel), dar e recomandat: se vede imediat că e un modul de bază și nimeni nu îl poate înlocui cu un pachet cu același nume.

Cum văd lista modulelor de bază?

Rulează node -p "require('module').builtinModules". Lista diferă puțin de la o versiune de Node la alta.

Erori înrudite

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.