CKTIS / JavaScript
encodeURI() — een volledige URI coderen
encodeURI() codeert tekens in een volledige URI en laat sommige scheidingstekens ongewijzigd. De functie retourneert een nieuwe tekenreeks met UTF-8-percentcodering en is niet bedoeld voor afzonderlijke parameterwaarden.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
encodeURI(uri)encodeURI(uri) is een globale ECMAScript-functie, geen browser-API. De functie zet het argument om in een tekenreeks en retourneert een nieuwe tekenreeks waarin geselecteerde tekens worden vervangen door %HH-reeksen die UTF-8-bytes voorstellen. Een spatie wordt %20, niet +.
ASCII-letters, cijfers en -_.!~*'();/?:@&=+$,# blijven ongewijzigd. De tekens &, = en # behouden daardoor hun speciale betekenis, maar de functie behoudt niet de structuur van elke geldige URI. Zo past ze percentcodering toe op de vierkante haken rond een letterlijk IPv6-adres: http://[::1]/ wordt http://%5B::1%5D/, een URL met een ongeldige host. Gebruik voor één parameterwaarde encodeURIComponent(), dat ook &, = en # codeert.
Als je encodeURIComponent() gebruikt om één padsegment te coderen, wijs dan waarden die exact . of .. zijn af vóór het coderen. De functie laat ze ongewijzigd. Een URL-parser kan ze daardoor bij het normaliseren als puntsegmenten behandelen in plaats van ze als letterlijke gegevens in het pad te behouden. Een segment .. kan het voorafgaande padsegment verwijderen.
De functie controleert niet of een adres geldig of veilig is. Ze codeert % als %25, waardoor opnieuw coderen bestaande escape-reeksen verandert: %20 wordt %2520. Een ongepaard UTF-16-surrogaat veroorzaakt URIError; een geldig surrogaatpaar wordt als één codepunt gecodeerd.
Het voorbeeld laat zien welke scheidingstekens in de gegeven URL ongewijzigd blijven, hoe é en spaties worden gecodeerd en wat het verschil is tussen het coderen van een volledige URI en een afzonderlijk onderdeel daarvan.
Voorbeelden
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"));Resultaat
https://example.com/caf%C3%A9%20menu?q=tea&size=large#top tea%26size%3Dlarge %2520
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.