TypeError [ERR_STREAM_NULL_VALUES]: May not write null values to stream
Ai apelat write(null) pe un stream de scriere, de obicei crezând că null îl închide (asta se face doar la push(null) pe stream-urile de citire). Pentru a termina un stream de scriere apelează stream.end(); dacă null vine din date, sari peste valorile lipsă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un stream de scriere (fs.createWriteStream, process.stdout, răspunsul HTTP) primește bucăți de text sau Buffer. Valoarea null are un rol special în stream-uri: la stream-urile de citire, push(null) înseamnă „gata, nu mai vin date”. Ca să nu existe confuzii, la stream-urile de scriere write(null) e interzis, iar Node aruncă ERR_STREAM_NULL_VALUES.
Două situații tipice:
- vrei să închizi stream-ul și scrii
ws.write(null)în loc dews.end(); - scrii valori dintr-o listă și una e
null(un câmp lipsă din baza de date, un rezultat de lamapfărăreturnpe o ramură care întoarcenull).
Linia din stivă cu fișierul tău arată apelul write. Pentru undefined mesajul e altul: The "chunk" argument must be of type string or an instance of Buffer....
De ce apare: cauzele frecvente
1null folosit ca semnal de final
const ws = fs.createWriteStream("raport.txt");
ws.write("linia 1\n");
ws.write(null); // „gata”const ws = fs.createWriteStream("raport.txt");
ws.write("linia 1\n");
ws.end();end() termină stream-ul de scriere și golește datele rămase; null are sens doar la push pe stream-urile de citire.
2Valori lipsă în date
for (const c of clienti) ws.write(c.telefon); // unele sunt nullfor (const c of clienti) {
if (c.telefon != null) ws.write(c.telefon + "\n");
}Sari peste valorile lipsă sau înlocuiește-le cu un text (c.telefon ?? "-").
3Copiere dintr-un stream de citire scrisă de mână
rs.on("data", (b) => ws.write(b));
rs.on("end", () => ws.write(null));rs.pipe(ws); // sau: rs.on("end", () => ws.end());pipe închide singur stream-ul de scriere când se termină cel de citire.
Repară eroarea, direct în pagină
Scriptul scrie lista de produse în stoc.txt cu fs.createWriteStream, apoi vrea să închidă stream-ul cu ws.write(null) și primește May not write null values to stream. Închide stream-ul corect, ca după terminare să se afișeze conținutul fișierului.
const fs = require("fs");
const produse = ["Lapte: 12", "Paine: 30", "Cafea: 7"];
const ws = fs.createWriteStream("stoc.txt");
for (const p of produse) ws.write(p + "\n");
ws.write(null); // gata, închidem fișierul
ws.on("finish", () => {
console.log(fs.readFileSync("stoc.txt", "utf8").trim());
});Lapte: 12 Paine: 30 Cafea: 7
Indiciu
Stream-ul de scriere se termină cu ws.end().
Reparația
const fs = require("fs");
const produse = ["Lapte: 12", "Paine: 30", "Cafea: 7"];
const ws = fs.createWriteStream("stoc.txt");
for (const p of produse) ws.write(p + "\n");
ws.end(); // gata, închidem fișierul
ws.on("finish", () => {
console.log(fs.readFileSync("stoc.txt", "utf8").trim());
});De ce merge
write(null) e interzis la stream-urile de scriere, pentru că null are alt rol (marchează finalul la stream-urile de citire). ws.end() anunță că nu mai urmează date. După ce tot ce era în buffer ajunge pe disc, stream-ul emite finish, iar abia atunci citim fișierul complet.
Alte forme ale mesajului
TypeError [ERR_STREAM_NULL_VALUES]: May not write null values to stream at _write (node:internal/streams/writable:460:11)Error [ERR_STREAM_NULL_VALUES]: May not write null values to streamcode: 'ERR_STREAM_NULL_VALUES'
Cum o eviți pe viitor
- Reține: stream de citire →
push(null)la final; stream de scriere →end()la final. - Pentru copiere folosește
pipesaustream.pipeline, care închid totul corect. - Când scrii date dintr-o listă, filtrează sau înlocuiește valorile
null/undefinedînainte.
Întrebări frecvente
Pot scrie un string gol în loc de null?
Da, ws.write("") e permis, dar nu închide stream-ul. Pentru închidere folosește ws.end(), eventual cu ultima bucată: ws.end("ultima linie\n").
Eroarea apare și la res.write(null) într-un server?
Da, răspunsul HTTP e tot un stream de scriere. Termină răspunsul cu res.end().
Erori înrudite
Error [ERR_STREAM_WRITE_AFTER_END]: write after end Ai scris într-un stream (fișier sau răspuns HTTP) după ce l-ai închis cu end(). După end() nu mai poți scrie. Scrie toate datele întâi și apelează end() o singură dată, la final; ca să faci ceva după scriere, ascultă evenimentul 'finish'. TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received type number (235) Ai dat lui res.write sau res.end (sau unui stream) un număr, un obiect ori un tablou, dar acceptă doar text sau Buffer. Transformă valoarea: res.end(String(total)) pentru numere, res.end(JSON.stringify(date)) pentru obiecte; în Express folosește res.json(date). Error: EBADF: bad file descriptor, write Încerci să scrii (sau să citești) printr-un descriptor de fișier care a fost deja închis. De obicei fs.closeSync(fd) e pus în buclă sau înainte de ultima scriere. Închide fișierul o singură dată, după ce ai terminat toate operațiile, ideal într-un finally. Î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.
