TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'append'
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
fs.writeFileSync("jurnal.log", linie, { flag: "append" });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
const fd = fs.openSync("date.json", "rw");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
fs.createWriteStream("export.csv", { flags: "add" });fs.createWriteStream("export.csv", { flags: "a" });Stream-urile folosesc aceleași coduri, sub cheia flags.
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.
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;
}pornire server comandă nouă #1042 plată confirmată #1042
Indiciu
Codul pentru „adaugă la final” este o singură literă: "a".
Reparația
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: "a" });
}
console.log(fs.readFileSync("jurnal.log", "utf8").trim());
} catch (err) {
console.error(`Jurnal indisponibil: ${err.message}`);
process.exitCode = 1;
}De ce merge
Flagurile lui fs sunt coduri fixe, nu cuvinte: "a" deschide fișierul pentru adăugare la final și îl creează dacă nu există. Cu el, fiecare apel păstrează liniile scrise înainte. Dacă ai fi lăsat flagul implicit "w", fiecare apel ar fi golit fișierul și ar fi rămas doar ultimul eveniment.
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 primiEEXISTdacă fișierul există deja. - Verifică numele cheii:
flaglawriteFileSync,flagsla 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
Error: EEXIST: file already exists, mkdir 'rapoarte' Încerci să creezi un dosar care există deja. mkdirSync fără opțiuni dă eroare dacă dosarul e acolo. Folosește fs.mkdirSync("rapoarte", { recursive: true }), care nu aruncă eroare când dosarul există. TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Object Încerci să scrii în fișier un obiect sau un tablou direct, dar writeFileSync și appendFileSync acceptă doar text sau Buffer. Transformă datele în text: JSON.stringify(date, null, 2) pentru JSON, sau String(numar) pentru numere. TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64 Numele codificării dat lui Buffer.from, toString sau unei funcții din fs nu e recunoscut de Node: de obicei e scris cu cratimă sau greșit, de exemplu "base-64" sau "utf-16". Folosește numele acceptate: "utf8", "base64", "base64url", "hex", "latin1", "utf16le", "ascii". Î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.
