URIError: URI malformed
`decodeURIComponent` sau `decodeURI` a primit un text cu un `%` care nu e urmat de două cifre hexazecimale valide (de exemplu „50%” sau „%E2%82”). Decodează doar texte codate corect, codează cu `encodeURIComponent` și pune decodarea într-un `try...catch` când textul vine din exterior.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În URL-uri, caracterele speciale se scriu cu percent-encoding: %20 e spațiu, %25 e semnul %, %C4%83 e „ă” în UTF-8. decodeURIComponent și decodeURI transformă aceste secvențe înapoi în text. Dacă găsesc un % care nu e urmat de două cifre hexazecimale, sau o secvență UTF-8 incompletă ori invalidă, aruncă URIError: URI malformed.
Cauze tipice: un text care conține % simplu („Reducere 50%”) e decodat, deși nu a fost niciodată codat; un text e decodat de două ori; un URL e tăiat la mijlocul unei secvențe (%C4 fără %83); un parametru a fost codat în alt set de caractere (Latin-1 în loc de UTF-8).
În Firefox mesajul e URIError: malformed URI sequence.
De ce apare: cauzele frecvente
1Text cu % decodat fără să fi fost codat
const titlu = "Reducere 50%";
console.log(decodeURIComponent(titlu));const titlu = "Reducere 50%";
const inUrl = encodeURIComponent(titlu); // Reducere%2050%25
console.log(decodeURIComponent(inUrl));Decodezi doar ce a fost codat. Codat corect, % devine %25, iar decodarea îl readuce.
2Decodare dublă
const q = decodeURIComponent("50%2525"); // "50%25"
const dublu = decodeURIComponent(decodeURIComponent(q));const q = decodeURIComponent("50%2525");
console.log(q);Fiecare decodare elimină un nivel de codare; a doua sau a treia ajunge la un % simplu și aruncă.
3Parametru din URL tratat fără protecție
const cautare = decodeURIComponent(parametruDinUrl);let cautare;
try {
cautare = decodeURIComponent(parametruDinUrl);
} catch {
cautare = parametruDinUrl;
}URL-urile pot fi scrise greșit de oricine; try...catch împiedică oprirea paginii.
Repară eroarea, direct în pagină
Programul de mai jos pune un titlu într-un URL și apoi îl citește înapoi, dar se oprește cu URIError: URI malformed, pentru că titlul nu a fost codat. Repară construcția URL-ului (lasă decodarea neschimbată) ca programul să afișeze URL: /cauta?q=Reducere%2050%25 și Titlu: Reducere 50%.
const titlu = "Reducere 50%";
const url = `/cauta?q=${titlu}`;
console.log(`URL: ${url}`);
const citit = decodeURIComponent(url.split("q=")[1]);
console.log(`Titlu: ${citit}`);URL: /cauta?q=Reducere%2050%25 Titlu: Reducere 50%
Indiciu
Valoarea pusă în URL trebuie codată cu encodeURIComponent, ca semnul % și spațiul să devină secvențe valide.
Reparația
const titlu = "Reducere 50%";
const url = `/cauta?q=${encodeURIComponent(titlu)}`;
console.log(`URL: ${url}`);
const citit = decodeURIComponent(url.split("q=")[1]);
console.log(`Titlu: ${citit}`);De ce merge
Necodat, textul Reducere 50% se termina cu un % fără cele două cifre hexazecimale, iar decodeURIComponent nu are ce secvență să decodeze. encodeURIComponent transformă spațiul în %20 și % în %25, deci URL-ul conține doar secvențe valide, iar decodarea readuce exact titlul original.
Alte forme ale mesajului
URIError: malformed URI sequenceURIError: URI malformed at decodeURIComponentURIError: URI malformed at decodeURIURIError: URI malformed at encodeURIComponent
Cum o eviți pe viitor
- Construiește URL-urile cu
encodeURIComponentpentru fiecare valoare sau, mai bine, cuURLșiURLSearchParams, care codează și decodează automat. - Decodează o singură dată, în locul în care citești valoarea.
- Pune decodarea textelor venite din exterior într-un
try...catch.
Întrebări frecvente
Poate și encodeURIComponent să dea URI malformed?
Da, rar: când textul conține o jumătate de pereche surogat (un caracter Unicode tăiat la mijloc, de exemplu un emoji tăiat cu slice). Textele normale se codează fără probleme.
URLSearchParams aruncă la fel?
Nu. new URLSearchParams("q=50%").get("q") întoarce "50%" fără eroare, lăsând secvențele invalide neschimbate. De aceea e varianta mai sigură pentru parametri.
Erori înrudite
SyntaxError: Invalid Unicode escape sequence Într-un șir ai un backslash urmat de `u` care nu formează un cod Unicode valid, cel mai des într-o cale Windows ca `"C:\users\ana"`. Backslash-ul începe o secvență escape. Dublează-l (`\\`), folosește `/` sau `String.raw`. SyntaxError: "undefined" is not valid JSON Ai dat lui `JSON.parse` valoarea `undefined` în loc de un text JSON, de obicei o variabilă goală, o proprietate scrisă greșit sau un rezultat lipsă. `JSON.parse` o transformă în textul „undefined”, care nu e JSON. Verifică de unde vine valoarea și tratează cazul în care lipsește. RangeError: Invalid count value: -1 Metoda `repeat` a primit un număr negativ sau `Infinity`: `"*".repeat(-1)`. Numărul de repetări trebuie să fie între 0 și o limită finită. Verifică calculul (de multe ori o diferență care iese negativă) și folosește `Math.max(0, n)`. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
