CKTIS / JavaScript
encodeURIComponent — codifica un componente URI
encodeURIComponent codifica un singolo componente URI, per esempio il valore di un parametro di query. Converte i caratteri speciali e quelli non ASCII in sequenze percentuali che rappresentano byte UTF-8.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) è una funzione globale di ECMAScript, non un’API disponibile soltanto nei browser. Converte il proprio argomento in una stringa e restituisce una stringa codificata. Usala per un singolo valore, non per un intero indirizzo.
Lascia invariati le lettere A–Z, a–z, le cifre 0–9 e - _ . ! ~ * ' ( ). Gli altri caratteri diventano byte UTF-8 scritti come %HH. Uno spazio diventa %20, non +; un + letterale diventa %2B.
A differenza di encodeURI, codifica anche separatori come &, =, /, ? e #. Una volta codificati, questi caratteri non fungono da delimitatori quando si compone un URI. Apostrofi e parentesi, invece, rimangono invariati e possono ancora fungere da delimitatori in alcune sintassi degli URI, per esempio negli URL OData. Tuttavia, non è né un escape HTML né una convalida dell’indirizzo. Codificando di nuovo il risultato, % diventa %25.
decodeURIComponent inverte la codifica di dati validi. Un surrogato UTF-16 non appaiato nell’argomento di encodeURIComponent causa un URIError; la funzione non lo sostituisce automaticamente. L’esempio mostra la codifica di un carattere Unicode, di uno spazio e di separatori, e poi verifica la reversibilità.
Esempi
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Risultato
%C5%BC%20%26%2B%2F true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.