...
Eroare Node.js · Fișiere și căi: fs și path

TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'append'

Pe scurt

Ai dat o valoare greșită pentru modul de deschidere a fișierului (flag). Node acceptă doar coduri scurte: "r" citire, "w" scriere de la zero, "a" adăugare la final, "wx" scriere doar dacă fișierul nu există. Pentru adăugare scrie { flag: "a" } sau folosește fs.appendFileSync.

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

Ce înseamnă

Funcțiile din fs care deschid fișiere (openSync, writeFileSync, createWriteStream și variantele lor) primesc un flag care spune cum se deschide fișierul. Valorile sunt coduri moștenite din sistemele de operare: "r", "r+", "w", "w+", "wx", "a", "a+", "ax" și câteva rare. Cuvinte ca "append", "write", "rw" sau "wa" nu sunt valide, iar Node respinge apelul înainte să atingă fișierul.

Mesajul îți arată valoarea primită (Received 'append'). Uită-te în cod după flag: (la writeFileSync, readFileSync, appendFileSync), flags: (la createReadStream / createWriteStream) sau al doilea argument al lui fs.openSync / fs.open.

Atenție la nume: în opțiunile lui writeFileSync cheia e flag (singular), iar la stream-uri e flags (plural). O cheie scrisă greșit nu dă eroare, e ignorată, iar fișierul e suprascris în loc să fie completat.

De ce apare: cauzele frecvente

1Cuvânt în loc de cod

Greșit
JavaScript
fs.writeFileSync("jurnal.log", linie, { flag: "append" });
Corect
JavaScript
fs.writeFileSync("jurnal.log", linie, { flag: "a" });
// sau
fs.appendFileSync("jurnal.log", linie);

"a" înseamnă „deschide pentru adăugare la final, creează fișierul dacă lipsește”. appendFileSync face exact asta, fără flag.

2Combinație inventată pentru citire și scriere

Greșit
JavaScript
const fd = fs.openSync("date.json", "rw");
Corect
JavaScript
const fd = fs.openSync("date.json", "r+");

Pentru citire și scriere în același fișier existent, codul corect e "r+". "w+" face același lucru, dar golește fișierul la deschidere.

3Flag pentru stream scris greșit

Greșit
JavaScript
fs.createWriteStream("export.csv", { flags: "add" });
Corect
JavaScript
fs.createWriteStream("export.csv", { flags: "a" });

Stream-urile folosesc aceleași coduri, sub cheia flags.

Repară tu

Repară eroarea, direct în pagină

Programul scrie evenimentele într-un jurnal, câte o linie, și dă TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'append'. Folosește flagul corect pentru adăugare, ca toate cele trei evenimente să ajungă în jurnal.log, unul sub altul.

Codul care dă eroarea
JavaScript
const fs = require("fs");

const evenimente = ["pornire server", "comandă nouă #1042", "plată confirmată #1042"];

try {
  for (const e of evenimente) {
    fs.writeFileSync("jurnal.log", `${e}\n`, { flag: "append" });
  }
  console.log(fs.readFileSync("jurnal.log", "utf8").trim());
} catch (err) {
  console.error(`Jurnal indisponibil: ${err.message}`);
  process.exitCode = 1;
}
După reparație, programul afișează
pornire server
comandă nouă #1042
plată confirmată #1042
Indiciu

Codul pentru „adaugă la final” este o singură literă: "a".

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'rw'
  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'write'
  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'wa'

Cum o eviți pe viitor

  • Învață cele trei flaguri de bază: "r" (citire), "w" (scriere de la zero), "a" (adăugare).
  • Pentru adăugare preferă fs.appendFileSync, mai clar decât un flag.
  • Pentru „creează doar dacă nu există” folosește "wx"; vei primi EEXIST dacă fișierul există deja.
  • Verifică numele cheii: flag la writeFileSync, flags la stream-uri.

Întrebări frecvente

Care e diferența dintre "w" și "a"?

"w" golește fișierul (sau îl creează) și scrie de la început. "a" păstrează conținutul și scrie la final. Amândouă creează fișierul dacă lipsește.

Am scris { flags: "a" } la writeFileSync și fișierul tot se suprascrie. De ce?

Pentru writeFileSync cheia corectă este flag. Cheia flags e ignorată, deci se folosește valoarea implicită "w".

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.