TypeError [ERR_INVALID_ARG_VALUE]: The argument 'format' must be one of: 'reset', 'bold', 'dim', 'italic', 'underline', 'blink', 'inverse', 'hidden', 'strikethrough', 'doubleunderline', 'black', 'red', 'green', ... Received 'rosu'
util.styleText(format, text) acceptă doar numele de stiluri cunoscute de Node, în engleză: "red", "green", "yellow", "bold", "underline", "bgRed" și altele. Ai scris un nume inexistent (de exemplu "rosu" sau "Red"). Corectează numele; pentru mai multe stiluri dă un tablou: styleText(["bold", "green"], text).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
util.styleText, din Node 20.12 / 21.7, colorează textul din terminal fără pachete externe ca chalk. Primul argument e un stil sau un tablou de stiluri, iar Node verifică fiecare nume. Dacă unul nu e în listă, eroarea afișează toată lista de nume acceptate, apoi valoarea primită (Received 'rosu'). Lista e lungă, așa că uită-te direct la finalul mesajului.
Numele sunt sensibile la majuscule și seamănă cu cele din chalk: culori (red, green, yellow, blue, magenta, cyan, white, gray), variante luminoase (redBright), fundaluri (bgRed, bgGreen) și modificatori (bold, dim, italic, underline, inverse).
În versiunile noi, styleText verifică și dacă ieșirea suportă culori: când rulezi prin pipe, în CI sau cu NO_COLOR, textul iese fără coduri de culoare, deci logurile rămân curate.
De ce apare: cauzele frecvente
1Numele culorii tradus
console.log(styleText("rosu", "Stoc epuizat"));console.log(styleText("red", "Stoc epuizat"));Numele stilurilor sunt fixe, în engleză.
2Majuscule sau formă greșită
styleText("Bold", titlu);
styleText("bg-red", alerta);styleText("bold", titlu);
styleText("bgRed", alerta);Numele se scriu exact ca în listă, în stil camelCase pentru cele compuse.
3Mai multe stiluri într-un singur text
styleText("bold green", "OK");styleText(["bold", "green"], "OK");Pentru mai multe stiluri, dai un tablou; un text cu spații e tratat ca un singur nume (inexistent).
Repară eroarea, direct în pagină
Scriptul afișează stocul produselor colorat: verde pentru produsele în stoc, roșu pentru cele epuizate. Programul dă TypeError [ERR_INVALID_ARG_VALUE]: The argument 'format' must be one of: ... Received 'rosu'. Folosește numele corecte ale stilurilor, ca scriptul să afișeze toate produsele.
const { styleText } = require("util");
const stoc = [
{ produs: "Cafea", bucati: 12 },
{ produs: "Ceai verde", bucati: 0 },
{ produs: "Cană", bucati: 5 },
];
for (const s of stoc) {
const culoare = s.bucati > 0 ? "verde" : "rosu";
console.log(styleText(culoare, `${s.produs}: ${s.bucati} buc.`));
}Cafea: 12 buc. Ceai verde: 0 buc. Cană: 5 buc.
Indiciu
Numele stilurilor sunt în engleză: "green" și "red".
Reparația
const { styleText } = require("util");
const stoc = [
{ produs: "Cafea", bucati: 12 },
{ produs: "Ceai verde", bucati: 0 },
{ produs: "Cană", bucati: 5 },
];
for (const s of stoc) {
const culoare = s.bucati > 0 ? "green" : "red";
console.log(styleText(culoare, `${s.produs}: ${s.bucati} buc.`));
}De ce merge
styleText acceptă doar stilurile din lista lui Node, cu numele lor în engleză, iar "verde" și "rosu" nu există, de aceea apelul era refuzat. Cu "green" și "red", fiecare linie primește culoarea potrivită în terminal. Aici ieșirea nu e un terminal, așa că styleText întoarce textul fără coduri de culoare și vezi doar liniile simple, exact cum ar apărea într-un fișier de log.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_VALUE]: The argument 'format' must be one of: 'reset', 'bold', 'dim', ... Received 'Bold'TypeError [ERR_INVALID_ARG_VALUE]: The argument 'format' must be one of: 'reset', 'bold', 'dim', ... Received 'bold green'TypeError [ERR_INVALID_ARG_TYPE]: The "text" argument must be of type string. Received type number (42)
Cum o eviți pe viitor
- Ține stilurile folosite într-un singur loc (
const STIL = { ok: "green", eroare: "red" }) și refolosește-le. - Dă tablouri pentru combinații de stiluri.
- Convertește numerele în text înainte (
String(total)): și argumentultexttrebuie să fie șir de caractere. - Când nu ești sigur de un nume, caută-l în lista afișată chiar de eroare, la începutul mesajului.
Întrebări frecvente
Merită styleText în loc de chalk?
Pentru scripturi și unelte simple, da: e inclus în Node, deci nu mai ai o dependență. chalk rămâne util dacă ai nevoie de culori RGB sau de suport pentru versiuni vechi de Node.
De ce nu văd culori când rulez în CI?
styleText verifică dacă ieșirea e un terminal care suportă culori și ține cont de variabile ca NO_COLOR și FORCE_COLOR. Dacă nu e cazul, întoarce textul simplu.
Erori înrudite
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. 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 [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.
