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

CKTIS / JavaScript

Location.href — leer la dirección y navegar

Location.href proporciona la URL del documento como una cadena de texto. Asignar un valor inicia una navegación, en lugar de limitarse a cambiar una variable normal.

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.href
window.location.href = url

Location.href es una propiedad de la API del navegador a la que se accede mediante window.location.href. Al leerla, devuelve la URL serializada del documento, incluida la consulta y el fragmento, si los hay.

Asignar window.location.href = url inicia una navegación. Al asignar un valor, una dirección relativa se resuelve con respecto a la URL base de la API del objeto de configuración de entrada (entry settings object). En una llamada síncrona entre marcos, puede tratarse de la URL base del marco que inició la llamada, en lugar de la del marco cuyo código realiza la asignación. Una dirección no válida puede provocar una DOMException de tipo SyntaxError.

La lectura de la dirección de otra ventana está sujeta a restricciones de origen y puede provocar un SecurityError. El ejemplo solo lee la dirección; no se sale de la página.

Ejemplos

const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());

Resultado

string
true

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