Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

encodeURI() — encoder un URI complet

encodeURI() encode les caractères d’un URI complet en laissant certains séparateurs inchangés. Elle renvoie une nouvelle chaîne avec un encodage en pourcentage UTF-8 ; elle n’est pas destinée à encoder des valeurs de paramètre individuelles.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

encodeURI(uri)

encodeURI(uri) est une fonction globale ECMAScript, et non une API de navigateur. Elle convertit son argument en chaîne et renvoie une nouvelle chaîne, où certains caractères sont remplacés par des séquences %HH représentant des octets UTF-8. Un espace devient %20, et non +.

Les lettres ASCII, les chiffres et -_.!~*'();/?:@&=+$,# restent inchangés. Les caractères &, = et # conservent donc leur rôle particulier, mais la fonction ne préserve pas la structure de tous les URI valides. Par exemple, elle applique l’encodage en pourcentage aux crochets qui entourent une adresse IPv6 littérale : http://[::1]/ devient http://%5B::1%5D/, une URL dont l’hôte est invalide. Pour encoder une valeur de paramètre individuelle, utilisez encodeURIComponent(), qui encode également &, = et #.

Si vous utilisez encodeURIComponent() pour encoder un seul segment de chemin, rejetez avant l’encodage les valeurs qui sont exactement . ou ... La fonction les laisse inchangées : un analyseur d’URL peut donc les traiter comme des segments à points lors de la normalisation du chemin au lieu de les conserver comme données littérales. Un segment .. peut supprimer le segment de chemin précédent.

La fonction ne vérifie ni la validité ni la sûreté d’une adresse. Elle encode % sous la forme %25 ; un nouvel encodage modifie donc les séquences d’échappement existantes : %20 devient %2520. Un substitut UTF-16 isolé provoque une URIError ; une paire de substituts valide est encodée comme un seul point de code.

L’exemple montre quels séparateurs restent inchangés dans l’URL donnée, comment é et les espaces sont encodés, et la différence entre l’encodage d’un URI complet et celui de l’un de ses composants.

Exemples

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"));

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources