Codificator / Decodificator URL

Un codificator URL convertește caracterele care nu pot fi utilizate direct într-un URL în secvențe codificate procentual. Un decodificator URL inversează procesul, transformând textul codificat procentual înapoi în caracterele originale. Această pagină face ambele lucruri, în ambele direcții, pentru o singură componentă URL sau un URL complet.

Instrumentul folosește cele patru funcții JavaScript standard:

• encodeURIComponent — pentru codificarea unei singure componente URL, cum ar fi valoarea unui parametru de interogare.
• encodeURI — pentru codificarea unui URL complet, păstrând caracterele rezervate cum ar fi : / ? # & = care au semnificație structurală.
• decodeURIComponent — pentru decodificarea unei singure componente URL înapoi la caracterele originale.
• decodeURI — pentru decodificarea unui URL complet fără a atinge caracterele rezervate.

Toate conversiile sunt compatibile cu UTF-8, astfel că literele accentuate, emoji-urile și caracterele din sisteme de scriere non-latine sunt procesate corect. Nimic nu este încărcat, nimic nu este stocat și nu se efectuează apeluri API.

Câteva exemple practice despre cum arată codificarea URL în practică:

• Un spațiu devine %20, deci bună ziua devine bun%C4%83%20ziua.
• O bară oblică într-o valoare de interogare devine %2F, deci a/b devine a%2Fb ca parametru.
• Un semn de întrebare într-o valoare devine %3F, deci ce? devine ce%3F.
• Un ampersand într-o valoare devine %26, evitând ruperea șirului de interogare înconjurător.
• Un diez într-o valoare devine %23, deci c# devine c%23.
• Caracterele non-ASCII folosesc secvențe UTF-8 multi-octet. De exemplu café devine caf%C3%A9 (é reprezintă doi octeți UTF-8).
• Emoji-urile folosesc de asemenea UTF-8 multi-octet: 😀 devine %F0%9F%98%80.

Comutați instrumentul pe Decodificare și inserați oricare dintre aceste șiruri codificate pentru a vedea textul original restaurat exact.

Alegerea modului corect este importantă deoarece cei doi encodere tratează diferit caracterele rezervate.

Utilizați modul Componentă (encodeURIComponent / decodeURIComponent) când codificați o singură valoare care va fi inserată într-un URL — de exemplu valoarea unui parametru de interogare, un segment de cale sau o valoare de fragment. Modul Componentă codifică procentual caracterele rezervate (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) astfel încât acestea să nu poată schimba accidental structura URL-ului înconjurător.

Utilizați modul URL Complet (encodeURI / decodeURI) când aveți un URL complet precum https://exemplu.ro/cale?interogare=valoare#fragment și doriți doar să escape-ați caracterele nesigure (de exemplu spații sau caractere non-ASCII), fără a atinge caracterele structurale rezervate.

O greșeală frecventă este utilizarea encodeURI pe o valoare care ar trebui să fie un parametru de interogare. Caracterele rezervate rămân intacte, ceea ce poate corupe URL-ul înconjurător. În caz de îndoială, codificați fiecare valoare de interogare cu encodeURIComponent și asamblați URL-ul după aceea.

Codificarea procentuală (numită și codificare URL) este o metodă de reprezentare în URL a caracterelor care sunt fie rezervate (au semnificație structurală) fie nu sunt deloc permise. Fiecare octet nesigur este scris ca un semn de procent urmat de două cifre hexazecimale — de exemplu %20 pentru un spațiu, %2F pentru o bară oblică sau %3F pentru un semn de întrebare.

Codificarea lucrează pe octeți, nu direct pe caractere. URL-urile moderne folosesc UTF-8 pentru a converti mai întâi caracterele în octeți, motiv pentru care o singură literă accentuată poate deveni doi octeți codificați procentual și un emoji poate deveni patru. Acest instrument folosește întotdeauna UTF-8, astfel că șirurile codificate sunt interoperabile cu restul web-ului.

Codificarea procentuală este definită de RFC 3986. Funcțiile JavaScript native utilizate aici implementează această specificație, astfel că o valoare codificată cu encodeURIComponent în orice browser modern este decodificată corect cu decodeURIComponent oriunde altundeva.

Acest codificator decodificator URL este util ori de câte ori trebuie să mutați text în siguranță într-un URL sau din acesta. Scenarii comune:

• Codificarea textului pentru un șir de interogare înainte de a-l insera într-o cerere API, o linie de jurnal sau bara de adrese a browserului.
• Decodificarea parametrilor URL dintr-un jurnal de cereri sau un export analitic pentru a citi valorile originale.
• Inspectarea unui URL lung codificat prin decodificarea lui și verificarea a ceea ce este transmis efectiv.
• Escape-area caracterelor speciale dintr-un URL înainte de a-l partaja în chat, documentație sau un payload JSON.
• Învățarea modului în care codificarea procentuală și secvențele de octeți UTF-8 se mapează la caractere.

Deoarece instrumentul rulează complet în browser, este potrivit și pentru URL-uri sensibile (link-uri interne, token-uri, URL-uri semnate) pe care preferați să nu le inserați într-un serviciu la distanță.

Codificarea URL și curățarea URL sunt două operații diferite care sunt adesea confundate.

Codificarea URL (acest instrument) transformă caracterele în formă codificată procentual și inversează operația. Structura URL-ului este păstrată; nimic nu este adăugat sau eliminat.

Curățarea URL (un tip separat de instrument) elimină parametrii de urmărire precum utm_source, utm_medium, fbclid, gclid și chei de interogare similare dintr-un URL, astfel încât link-ul rezultat să nu mai conțină metadate de urmărire. Curățarea URL modifică parametrii din URL — codificarea nu.

Dacă doriți să eliminați parametrii de urmărire, aveți nevoie de un instrument dedicat de curățare URL. Dacă doriți să codificați sau să decodificați text în/din formă codificată procentual, acesta este instrumentul potrivit.