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

CKTIS / JavaScript

Location: fragmento, origen, ruta, consulta y URL completa

Lee las cinco propiedades de la URL de un documento y distingue las asignaciones que pueden iniciar una navegación.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location devuelve el objeto Location asociado al documento. Pertenece a una API web del navegador, no a ECMAScript 2024. El objeto refleja la URL actual del documento, pero una cadena que ya hayas leído no se actualiza. Usa new URL(window.location.href) para examinar o modificar una URL aparte sin navegar.

href es la URL completa serializada. pathname solo contiene la ruta, sin la consulta ni el fragmento. En HTTP(S) empieza por /, incluso en la raíz. Una ruta opaca como blank en about:blank no necesita una barra inicial. search devuelve una consulta no vacía precedida de ?, y hash un fragmento no vacío precedido de #. Si falta el componente o está vacío, su propiedad devuelve "", aunque href aún muestre el delimitador. La lectura no descodifica la codificación porcentual. Usa new URLSearchParams(window.location.search) para leer los parámetros de consulta por separado.

origin es de solo lectura y describe el origen de la URL. En HTTP(S), incluye el esquema, el nombre de host y el puerto si no es el predeterminado. Un origen de URL opaco se serializa como la cadena "null", no como el valor null. En cambio, self.origin describe el origen del entorno de ejecución: un documento about:blank puede heredarlo. Dos cadenas "null" iguales no demuestran que los orígenes coincidan.

Asignar a href puede iniciar la navegación a otra URL, incluso relativa. Si no se puede analizar, se lanza una DOMException llamada SyntaxError. Asignar a pathname o search puede iniciar la navegación con una ruta o consulta distinta. Asignar a pathname no tiene efecto si la ruta es opaca. Los prefijos ? y # son opcionales al escribir en search y hash, respectivamente. search = "" elimina la consulta, pero hash = "" puede dejar un # al final. Cambiar solo el fragmento normalmente no carga otro documento.

Leer cualquiera de estas cinco propiedades en una ventana de otro origen puede lanzar una DOMException llamada SecurityError. Escribir en href es una excepción: puede estar permitido sin acceso de lectura, pero siguen vigentes las restricciones de navegación del navegador.

Ejemplos

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Resultado

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Ejecuta el código en Node.js. Lee los mismos componentes de la URL de un objeto `URL` en lugar de un objeto `Location` del navegador, sin iniciar una navegación. En el resultado, `"null"` es una cadena y `blank` no empieza por `/`.

Lecciones relacionadas

  • JavaScript · Lección 38 · Avanzado · Versión: 4

Fuentes