...
Eroare JavaScript · Șiruri, expresii regulate și URI

URIError: URI malformed

Pe scurt

`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

Greșit
JavaScript
const titlu = "Reducere 50%";
console.log(decodeURIComponent(titlu));
Corect
JavaScript
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ă

Greșit
JavaScript
const q = decodeURIComponent("50%2525"); // "50%25"
const dublu = decodeURIComponent(decodeURIComponent(q));
Corect
JavaScript
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

Greșit
JavaScript
const cautare = decodeURIComponent(parametruDinUrl);
Corect
JavaScript
let cautare;
try {
  cautare = decodeURIComponent(parametruDinUrl);
} catch {
  cautare = parametruDinUrl;
}

URL-urile pot fi scrise greșit de oricine; try...catch împiedică oprirea paginii.

Repară tu

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

Codul care dă eroarea
JavaScript
const titlu = "Reducere 50%";
const url = `/cauta?q=${titlu}`;

console.log(`URL: ${url}`);
const citit = decodeURIComponent(url.split("q=")[1]);
console.log(`Titlu: ${citit}`);
După reparație, programul afișează
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.

Alte forme ale mesajului

  • URIError: malformed URI sequence
  • URIError: URI malformed at decodeURIComponent
  • URIError: URI malformed at decodeURI
  • URIError: URI malformed at encodeURIComponent

Cum o eviți pe viitor

  • Construiește URL-urile cu encodeURIComponent pentru fiecare valoare sau, mai bine, cu URL și URLSearchParams, 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

← Toate erorile JavaScript

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