CKTIS / JavaScript
`URL.origin`, `URL.pathname` y `URL.search`
Distingue el origen, la ruta y la consulta de una URL ya analizada y lee parámetros individuales sin dividir la dirección a mano.
Versión: Current web platform; runtime support varies
Sintaxis
const url = new URL(input);
const resolved = new URL(input, base);
url.origin;
url.pathname;
url.search;
url.pathname = "/catalog";
url.search = "page=2";origin, pathname y search son propiedades de una instancia de URL, no métodos. URL es una API de la plataforma web, no parte de ECMAScript 2024, así que comprueba que tu entorno de ejecución la ofrece. Usa new URL(input) para una URL absoluta y proporciona una base adecuada con new URL(input, base) para una referencia relativa. Si la base proporcionada no es válida o falla el análisis, el constructor lanza TypeError. Modificar el objeto URL no provoca una navegación.
origin es de solo lectura. Para HTTP(S) contiene el esquema y el nombre de host, más el puerto si no es el predeterminado. No incluye credenciales, ruta, consulta ni fragmento. Un origen opaco, como el de una URL data:, se serializa como la cadena "null", no como el valor null. Dos cadenas iguales de este tipo no prueban que el origen sea el mismo. El resultado para file: depende de la implementación.
pathname es la ruta serializada, sin la consulta ni el fragmento. En HTTP(S) empieza por / y la ruta raíz es /. Las secuencias con codificación porcentual, como %20, no se descodifican de forma automática. Puedes asignar una nueva ruta HTTP(S). Otros esquemas pueden tener una ruta opaca sin / inicial.
search devuelve la consulta con su ? inicial, sin el fragmento y sin descodificar las secuencias porcentuales. Devuelve "" si la consulta no existe o está vacía, incluso cuando solo hay un ?. Puedes asignar una consulta nueva con o sin el ? inicial; asignar "" la elimina.
Usa url.searchParams.get("q") para leer el valor descodificado de un parámetro. Modificar searchParams actualiza el mismo objeto URL y puede cambiar cómo se serializan los valores existentes: un espacio escrito como %20 puede pasar a ser +. Usa href para leer la URL completa, incluido el fragmento.
Ejemplos
{
const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
console.log(url.origin);
console.log(url.pathname);
console.log(url.search);
console.log(url.searchParams.get("q"));
url.searchParams.set("page", "2");
console.log(url.href);
}Resultado
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
La normalización elimina el puerto predeterminado `443` y el segmento de ruta `.`. `search` conserva `%20`, `get("q")` devuelve un valor con un espacio y, al añadir `page=2`, ese espacio pasa a representarse como `+` en la consulta.
Lecciones relacionadas
- JavaScript · Lección 38 · Avanzado · Versión: 4