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

CKTIS / JavaScript

Location.hash y Location.href: fragmento frente a URL completa

`Location.hash` lee o modifica el fragmento de la URL. `Location.href` devuelve la URL completa o solicita navegar a un destino.

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

Sintaxis

const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;

window.location da acceso al objeto Location asociado al documento. Es una API del navegador definida por el estándar HTML, no por ECMAScript 2024. No des por hecho que existe fuera del contexto de una ventana del navegador.

Al leer hash, obtienes el fragmento no vacío con un # inicial, sin decodificar las secuencias con porcentaje. Si no hay fragmento o está vacío, obtienes "". href devuelve la URL completa como cadena, incluida la consulta y el fragmento si existen. href puede terminar en un # sin texto detrás aunque hash sea "".

Asignar un valor a hash cambia solo el fragmento; el # inicial es opcional. Si el fragmento resultante no cambia, no hay navegación. Asignar "" establece un fragmento vacío en vez de eliminarlo. Cambiarlo mediante una navegación dentro del mismo documento dispara hashchange sin recargar el documento.

Asignar un valor a href indica un destino de navegación. Una URL relativa se resuelve con respecto a la URL base del entorno que realiza la asignación. Si el análisis falla, el navegador lanza una DOMException llamada SyntaxError. Las reglas de origen restringen la lectura de ambas propiedades y la escritura de hash. Escribir en href puede estar permitido entre orígenes distintos, pero siguen aplicándose las restricciones de navegación.

Ejemplos

(async () => {
  const show = address => console.log(JSON.stringify([address.hash, address.href]));

  if (typeof document === 'undefined') {
    // Node.js: URL serialization only, without navigation or hashchange.
    const url = new URL('about:blank');
    show(url);
    url.hash = 'details';
    show(url);
    url.href = 'about:blank#summary';
    show(url);
    return;
  }

  const frame = document.createElement('iframe');
  frame.hidden = true;
  document.body.append(frame);

  try {
    const child = frame.contentWindow;
    const location = child.location;
    const nextHashChange = () => new Promise(resolve => {
      child.addEventListener('hashchange', resolve, { once: true });
    });

    show(location);
    const firstChange = nextHashChange();
    location.hash = 'details';
    await firstChange;
    show(location);

    const secondChange = nextHashChange();
    location.href = 'about:blank#summary';
    await secondChange;
    show(location);
  } finally {
    frame.remove();
  }
})();

Resultado

["","about:blank"]
["#details","about:blank#details"]
["#summary","about:blank#summary"]

Ejecuta el código en la consola de una página HTTP(S) normal, ya cargada, que permita un iframe sin restricciones `sandbox`. Cada línea muestra `[hash, href]`. Las dos asignaciones cambian la URL del iframe, no la de la página principal. En Node.js, el ejemplo usa un objeto `URL` en lugar de `Location` para mostrar solo la serialización de la URL, sin navegación ni eventos `hashchange`.

Lecciones relacionadas

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

Fuentes