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

CKTIS / JavaScript

Componentes de la URL de la página: origin, pathname, search, hash y href

El objeto window.location expone la URL completa de la página actual y sus componentes. Descubre en qué se diferencian origin, pathname, search, hash y href, y por qué escribir en Location puede iniciar una navegación.

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

window.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location es un objeto Location asociado al documento actual; también está disponible como document.location. Sus propiedades describen la URL de la página y devuelven cadenas. Es una API web del navegador, no una función de ECMAScript en sí. La presencia de Node 24 en un repositorio no demuestra que sea compatible con el Location del navegador.

Location.origin es de solo lectura. Para HTTP(S), contiene el esquema, //, el nombre de host y el puerto si no es el predeterminado; no incluye la ruta. Para file:, el resultado depende del navegador, así que no generalices las reglas de HTTP(S) a todos los esquemas. Location.pathname contiene la ruta sin la consulta ni el fragmento; para HTTP(S), empieza por /.

Location.search devuelve la consulta, si no está vacía, con el ? inicial. Si no hay consulta o está vacía, devuelve "", incluso cuando la URL termina en un ? sin contenido a continuación. Al leerla no se decodifican las secuencias porcentuales: %20 sigue siendo %20. Usa new URLSearchParams(window.location.search) para leer parámetros individuales. Location.hash devuelve el fragmento, si no está vacío, con el # inicial. Si no hay fragmento o está vacío, devuelve "", incluso cuando la URL termina en un # sin contenido a continuación. Location.href devuelve la URL completa, incluida la consulta y el fragmento.

Leer estas propiedades no cambia la página, pero escribir en href inicia una navegación. Cambiar pathname o search también puede cargar un documento; cambiar solo hash suele significar una navegación dentro del mismo documento. Para inspeccionar de forma segura una dirección arbitraria, usa URL en vez de modificar window.location. El ejemplo usa un objeto URL independiente con nombres de propiedades correspondientes: el resultado es fijo y no redirige la página. No es una prueba del comportamiento de navegación de Location.

Ejemplos

const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
  console.log(`${key}: ${url[key]}`);
}

Resultado

origin: https://example.org:8443
pathname: /docs/start
search: ?q=web%20api
hash: #intro
href: https://example.org:8443/docs/start?q=web%20api#intro

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