Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes