...
Eroare Node.js · Proces, terminal și intrare de la tastatură

TypeError: process.stdout.clearLine is not a function

Pe scurt

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

Greșit
JavaScript
process.stdout.clearLine(0);
process.stdout.cursorTo(0);
process.stdout.write(`Progres: ${p}%`);
Corect
JavaScript
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

Greșit
JavaScript
process.stdin.setRawMode(true);
Corect
JavaScript
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

Greșit
JavaScript
process.stdout.cursorTo(0);
Corect
JavaScript
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ă tu

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

Codul care dă eroarea
JavaScript
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");
După reparație, programul afișează
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.

Alte forme ale mesajului

  • TypeError: process.stdout.cursorTo is not a function
  • TypeError: process.stdin.setRawMode is not a function
  • TypeError: process.stdout.moveCursor is not a function
  • TypeError: 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 -it dacă 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

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