CKTIS / JavaScript
URL — analizar y modificar direcciones
URL descompone una dirección en componentes, resuelve referencias relativas y permite modificar los parámetros de consulta.
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
new URL(url, base?)URL es una API de WHATWG, no de ECMAScript. new URL(url, base?) analiza una dirección; las referencias relativas requieren una base. Si el análisis falla, se lanza un TypeError.
href proporciona la dirección serializada completa, mientras que pathname proporciona su ruta. En HTTP(S), origin contiene el esquema, el host y, si lo hay, el puerto, pero no la ruta. Resolver con respecto a una base no es concatenar: la / final importa.
searchParams es un objeto URLSearchParams vinculado: sus modificaciones actualizan la dirección. Pasa los valores sin codificarlos previamente; los espacios se serializan como +. Que el análisis se complete correctamente no significa que la dirección sea segura: comprueba que protocol y origin estén permitidos.
Ejemplos
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Resultado
/app/items https://example.com/app/items?q=red+shoes
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.