Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

encodeURI() — codificare un URI completo

encodeURI() codifica i caratteri di un URI completo lasciando invariati alcuni delimitatori. Restituisce una nuova stringa con codifica percentuale UTF-8; non è pensata per codificare singoli valori di parametri.

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

encodeURI(uri)

encodeURI(uri) è una funzione globale ECMAScript, non un’API del browser. Converte il proprio argomento in una stringa e restituisce una nuova stringa, sostituendo alcuni caratteri con sequenze %HH che rappresentano byte UTF-8. Uno spazio diventa %20, non +.

Lascia senza modifiche le lettere ASCII, le cifre e -_.!~*'();/?:@&=+$,#. I caratteri &, = e # mantengono quindi il loro significato speciale, ma la funzione non preserva la struttura di tutti gli URI validi. Per esempio, applica la codifica percentuale alle parentesi quadre che racchiudono un indirizzo IPv6 letterale: http://[::1]/ diventa http://%5B::1%5D/, un URL con un host non valido. Per un singolo valore di parametro, usa encodeURIComponent(), che codifica anche &, = e #.

Se usi encodeURIComponent() per codificare un singolo segmento di percorso, rifiuta prima della codifica i valori che corrispondono esattamente a . o ... La funzione li lascia invariati, quindi un parser di URL può interpretarli come segmenti punto durante la normalizzazione del percorso, anziché conservarli come dati letterali. Un segmento .. può rimuovere il segmento di percorso precedente.

La funzione non verifica la validità o la sicurezza di un indirizzo. Codifica % come %25, quindi una nuova codifica modifica le sequenze di escape esistenti: %20 diventa %2520. Un surrogato UTF-16 non appaiato causa URIError; una coppia valida viene codificata come un unico punto di codice.

L’esempio mostra quali delimitatori rimangono invariati nell’URL indicato, come vengono codificati é e gli spazi e la differenza tra codificare un URI completo e codificarne un componente.

Esempi

const uri = "https://example.com/café menu?q=tea&size=large#top";
console.log(encodeURI(uri));
console.log(encodeURIComponent("tea&size=large"));
console.log(encodeURI("%20"));

Risultato

https://example.com/caf%C3%A9%20menu?q=tea&size=large#top
tea%26size%3Dlarge
%2520

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