TypeError: process.stdout.clearLine is not a function
process.stdout.clearLine, cursorTo și setRawMode există doar când ieșirea (sau intrarea) e un terminal. Când rulezi prin pipe, în CI, în Docker fără -t sau în unele editoare, stdout e un flux simplu și metodele lipsesc. Verifică process.stdout.isTTY și afișează altfel când e false.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când programul scrie direct într-un terminal, process.stdout e un tty.WriteStream, care are metode pentru controlul cursorului: clearLine, cursorTo, moveCursor, plus columns și rows. Cu ele se fac barele de progres care se actualizează pe aceeași linie.
Când ieșirea nu e un terminal, de exemplu node index.js > log.txt, node index.js | grep x, un job de CI, docker run fără -t, consola de output a unui editor sau un proces pornit de alt program, process.stdout e un flux obișnuit (fișier sau pipe), fără aceste metode. Apelul dă is not a function, iar process.stdout.isTTY e undefined.
La fel pentru intrare: process.stdin.setRawMode există doar dacă stdin e terminal. De aceea un program care merge perfect în terminalul tău pică în pipeline-ul de CI.
De ce apare: cauzele frecvente
1Bară de progres fără verificarea terminalului
process.stdout.clearLine(0);
process.stdout.cursorTo(0);
process.stdout.write(`Progres: ${p}%`);if (process.stdout.isTTY) {
process.stdout.clearLine(0);
process.stdout.cursorTo(0);
process.stdout.write(`Progres: ${p}%`);
} else {
console.log(`Progres: ${p}%`);
}În terminal actualizezi linia; altfel scrii linii normale, care arată bine și într-un fișier de log.
2setRawMode când intrarea nu e terminal
process.stdin.setRawMode(true);if (process.stdin.isTTY) process.stdin.setRawMode(true);Modul „raw” (tastă cu tastă, fără Enter) are sens doar pentru un terminal real.
3Folosește funcțiile din readline
process.stdout.cursorTo(0);const readline = require("readline");
readline.cursorTo(process.stdout, 0);readline.cursorTo și readline.clearLine nu aruncă eroare când fluxul nu e terminal; pur și simplu nu fac nimic.
Repară eroarea, direct în pagină
Scriptul afișează progresul unui import cu o bară care se actualizează pe aceeași linie, dar rulează fără terminal (ca în CI), iar process.stdout.clearLine nu există: TypeError: process.stdout.clearLine is not a function. Folosește actualizarea pe aceeași linie doar când process.stdout.isTTY e adevărat, iar altfel afișează fiecare pas pe o linie nouă.
import process from "node:process";
const pasi = ["clienți", "produse", "comenzi", "facturi"];
pasi.forEach((pas, i) => {
const procent = Math.round(((i + 1) / pasi.length) * 100);
process.stdout.clearLine(0);
process.stdout.cursorTo(0);
process.stdout.write(`Import ${pas}: ${procent}%`);
});
console.log("\nImport terminat");Import clienți: 25% Import produse: 50% Import comenzi: 75% Import facturi: 100% Import terminat
Indiciu
Pune apelurile clearLine, cursorTo și write într-un if (process.stdout.isTTY), cu console.log pe ramura else.
Reparația
import process from "node:process";
const pasi = ["clienți", "produse", "comenzi", "facturi"];
pasi.forEach((pas, i) => {
const procent = Math.round(((i + 1) / pasi.length) * 100);
if (process.stdout.isTTY) {
process.stdout.clearLine(0);
process.stdout.cursorTo(0);
process.stdout.write(`Import ${pas}: ${procent}%`);
} else {
console.log(`Import ${pas}: ${procent}%`);
}
});
console.log("Import terminat");De ce merge
clearLine și cursorTo sunt metode ale terminalului, nu ale oricărui flux de ieșire. Când ieșirea e capturată (CI, fișier, pipe, consola editorului), process.stdout nu le are, iar isTTY nu e true. Cu verificarea isTTY, programul păstrează bara pe aceeași linie în terminal, iar în celelalte medii scrie câte o linie pentru fiecare pas, ușor de citit într-un log.
Alte forme ale mesajului
TypeError: process.stdout.cursorTo is not a functionTypeError: process.stdin.setRawMode is not a functionTypeError: process.stdout.moveCursor is not a functionTypeError: process.stdout.getWindowSize is not a function
Cum o eviți pe viitor
- Verifică
process.stdout.isTTYînainte de orice efect de terminal (progres, culori, curățarea ecranului). - Pentru
process.stdout.columns, pune o valoare implicită:process.stdout.columns || 80. - Testează scripturile și cu ieșirea redirecționată:
node index.js > log.txt. - În Docker, pornește containerele interactive cu
-itdacă ai nevoie de terminal.
Întrebări frecvente
De ce merge la mine și pică în CI?
Pe calculatorul tău rulezi într-un terminal, deci stdout are metodele de terminal. În CI ieșirea e capturată într-un fișier sau pipe, iar metodele lipsesc.
Pachetele de bare de progres au aceeași problemă?
Cele bune verifică singure isTTY și trec pe afișare simplă sau se opresc. Dacă vezi eroarea dintr-un pachet, caută o opțiune pentru medii fără terminal.
Erori înrudite
Error [ERR_USE_AFTER_CLOSE]: readline was closed Ai apelat rl.question() (sau alt apel readline) după ce interfața s-a închis: fie ai apelat rl.close() prea devreme, fie intrarea s-a terminat (Ctrl+D sau date trimise prin pipe), iar readline s-a închis singur. Pune rl.close() după ultima întrebare și nu mai întreba nimic în handler-ul close. 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). TypeError: calcule.totalCos is not a function Modulul nu exportă funcția pe care o apelezi, așa că require îți dă un obiect fără ea. Cauza clasică în Node: ai scris exports = { totalCos } în loc de module.exports = { totalCos }, ai uitat exportul sau numele diferă. Exportă cu module.exports. Î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.
