Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti