La manipulació de dades de text per a la seva transmissió o representació en entorns web requereix formats de codificació específics. El "Codificador/Descodificador d'URL + Entitats HTML" és una eina dissenyada per a desenvolupadors, editors de contingut i personal de suport que necessiten integrar text de manera segura en fragments d'URL o en documents HTML. Aquesta utilitat permet transformar cadenes de caràcters mitjançant la codificació i descodificació d'URL, així com l'escapament i la reversió de l'escapament d'entitats HTML.
El processament de les dades es realitza de manera local. El vostre text d'URL i HTML es converteix al vostre navegador i no es puja res a BroBroGo. Això garanteix que la informació es processi exclusivament en el dispositiu de l'usuari.
Funcionament de la codificació i descodificació d'URL
La codificació d'URL, sovint coneguda com a codificació de percentatges, és un mecanisme per a traduir caràcters no permesos o amb significats especials en una adreça web a un format universalment admès per la sintaxi de l'URL.
L'eina opera sota dos àmbits de conversió diferents segons la necessitat de l'usuari:
- Component d'URL: Aquesta opció utilitza internament les funcions
encodeURIComponentidecodeURIComponent. S'aplica quan es vol codificar un valor individual que formarà part d'una consulta, un fragment de ruta o un valor de formulari. Per exemple, el caràcter&o l'espai es convertiran completament per a evitar que el navegador els interpreti com a delimitadors de paràmetres. - URL completa: Aquesta modalitat utilitza les funcions
encodeURIidecodeURI. Està pensada per a processar adreces web senceres sense trencar-ne l'estructura, mantenint llegibles caràcters de control com ara:,/,?,&i=.
Un exemple pràctic de codificació d'URL amb el text d'entrada hello world & city=上海 genera com a resultat hello%20world%20%26%20city%3D%E4%B8%8A%E6%B5%B7. En el procés invers de descodificació, la cadena codificada torna a recuperar el seu estat original amb els caràcters d'espai, el símbol de l'ampersand i els caràcters xinesos.
Requisits de les seqüències UTF-8 i errors de descodificació
Durant la descodificació d'URL, els caràcters especials i no ASCII es representen mitjançant seqüències de bytes codificades en UTF-8, on cada byte s'indica amb un signe de percentatge % seguit de dos dígits hexadecimals.
Perquè la descodificació es completi correctament, els escapaments de percentatge han de ser seqüències UTF-8 completes. Si l'eina detecta una seqüència incompleta o malmesa, el procés s'interromp per a evitar interpretacions errònies de les dades. Per exemple, una seqüència trencada com %E0%A4%A no es pot descodificar i l'eina mostrarà el missatge d'error: "Aquest text d'URL té un escapament de percentatge trencat.".
Escapament i reversió d'entitats HTML
L'escapament d'entitats HTML és el procés de substituir caràcters especials que tenen un significat reservat en el llenguatge de marcatge per les seves referències de caràcter corresponents. Això evita que el navegador interpreti dades de text com a codi executable o etiquetes estructurals.
L'eina transforma caràcters com <, >, &, cometes simples o dobles, i text no ASCII en les seves respectives entitats HTML. En el mode d'escapament, una entrada com 保存 es converteix en una entitat HTML; en el mode de desescapament, una entrada com <button title="Save & close">保存</button> es torna a convertir en <button title="Save & close">保存</button>.
Cal destacar que l'escapament d'entitats HTML i la codificació d'URL són mètodes de format de dades per a la seva correcta representació i transmissió, i es diferencien conceptualment de les tasques de desinfecció de seguretat (sanitization), les quals tenen com a objectiu eliminar activament codi maliciós d'entrades no depurades.
Interfície i límits de processament
L'aplicació disposa d'un panell de control on es defineixen els paràmetres de la conversió. Quan se selecciona el mode d'entitats HTML, el control d'àmbit de la URL s'oculta automàticament de la interfície, ja que la distinció entre component i URL completa només s'aplica a les adreces web.
L'eina compta amb regles de validació i límits operatius per a garantir l'estabilitat del navegador:
- Mida màxima d'entrada: El text a convertir té un límit de 2.000.000 de caràcters. Si se supera aquest límit, es mostra el missatge: "Aquesta entrada és massa llarga per a aquesta eina. Mantingueu-la per sota de
{max}caràcters.". - Control de temps d'espera: Si una conversió és excessivament complexa o triga massa a processar-se, es mostra l'avís: "Aquesta conversió està trigant massa. Proveu amb una entrada més petita.".
- Gestió d'errors generals: En cas de fallada imprevista en la conversió, es mostra el missatge: "No s'ha pogut convertir aquesta entrada.".
- Camps buits: Si s'intenta realitzar una acció sense text, el sistema indica: "Primer enganxeu alguna entrada.".
L'usuari disposa de botons per a carregar un exemple ("S'ha carregat l'exemple."), netejar els camps de treball ("S'ha netejat l'entrada i la sortida.") o moure el resultat obtingut directament al camp d'entrada per a realitzar conversions consecutives ("El resultat s'ha mogut a l'entrada."). L'eina també mostra dinàmicament la mida de l'entrada i la mida de la sortida en caràcters.
Preguntes freqüents
He de triar component d'URL o URL completa?
Utilitzeu "Component" per a valors de consulta, fragments de ruta o valors de formulari. Utilitzeu "URL completa" quan vulgueu mantenir llegibles caràcters com : / ? & =.
Què canvia l'escapament d'entitats HTML?
Converteix caràcters com <, >, &, cometes i text no ASCII en entitats que es poden enganxar de manera segura en text o atributs HTML.
Per què de vegades falla la descodificació d'URL?
Els escapaments de percentatge han de ser seqüències UTF-8 completes. Una seqüència trencada com %E0%A4%A no es pot descodificar sense fer suposicions.