...
Eroare Node.js · EventEmitter și stream-uri

TypeError [ERR_STREAM_NULL_VALUES]: May not write null values to stream

Pe scurt

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 de ws.end();
  • scrii valori dintr-o listă și una e null (un câmp lipsă din baza de date, un rezultat de la map fără return pe o ramură care întoarce null).

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

Greșit
JavaScript
const ws = fs.createWriteStream("raport.txt");
ws.write("linia 1\n");
ws.write(null); // „gata”
Corect
JavaScript
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

Greșit
JavaScript
for (const c of clienti) ws.write(c.telefon); // unele sunt null
Corect
JavaScript
for (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ă

Greșit
JavaScript
rs.on("data", (b) => ws.write(b));
rs.on("end", () => ws.write(null));
Corect
JavaScript
rs.pipe(ws); // sau: rs.on("end", () => ws.end());

pipe închide singur stream-ul de scriere când se termină cel de citire.

Repară tu

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.

Codul care dă eroarea
JavaScript
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());
});
După reparație, programul afișează
Lapte: 12
Paine: 30
Cafea: 7
Indiciu

Stream-ul de scriere se termină cu ws.end().

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 stream
  • code: '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 pipe sau stream.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

← 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.