CKTIS / JavaScript
encodeURI() — codificación de un URI completo
encodeURI() codifica los caracteres de un URI completo y deja algunos delimitadores sin cambios. Devuelve una nueva cadena con codificación porcentual UTF-8; no está pensada para codificar valores de parámetros individuales.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
encodeURI(uri)encodeURI(uri) es una función global de ECMAScript, no una API del navegador. Convierte su argumento en una cadena y devuelve otra nueva, sustituyendo algunos caracteres por secuencias %HH que representan bytes UTF-8. Un espacio se convierte en %20, no en +.
Deja sin cambios las letras ASCII, los dígitos y -_.!~*'();/?:@&=+$,#. Por tanto, &, = y # conservan su significado especial, pero la función no conserva la estructura de todos los URI válidos. Por ejemplo, aplica la codificación porcentual a los corchetes que encierran una dirección IPv6 literal: http://[::1]/ pasa a ser http://%5B::1%5D/, una URL con un host no válido. Para un valor de parámetro individual, usa encodeURIComponent(), que también codifica &, = y #.
Si usas encodeURIComponent() para codificar un solo segmento de ruta, rechaza antes de codificar los valores que sean exactamente . o ... La función los deja sin cambios, así que un analizador de URL puede tratarlos como segmentos de punto al normalizar la ruta, en vez de conservarlos como datos literales. Un segmento .. puede eliminar el segmento anterior de la ruta.
La función no comprueba si una dirección es válida ni si es segura. Codifica % como %25, por lo que volver a codificar modifica las secuencias de escape existentes: %20 pasa a ser %2520. Un sustituto UTF-16 sin pareja provoca URIError; una pareja válida se codifica como un único punto de código.
El ejemplo muestra qué delimitadores quedan sin cambios en la URL dada, cómo se codifican é y los espacios, y la diferencia entre codificar un URI completo y codificar uno de sus componentes.
Ejemplos
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"));Resultado
https://example.com/caf%C3%A9%20menu?q=tea&size=large#top tea%26size%3Dlarge %2520
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.