Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Location.hash et Location.href : fragment ou URL complète

`Location.hash` lit ou modifie le fragment de l’URL. `Location.href` renvoie l’URL complète ou demande une navigation vers une destination.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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

window.location donne accès à l’objet Location associé au document. Il s’agit d’une API de navigateur définie par le standard HTML, et non par ECMAScript 2024. Sa présence n’est pas garantie hors du contexte d’une fenêtre de navigateur.

En lecture, hash renvoie un fragment non vide précédé de #, sans décoder les séquences d’échappement en pourcentage. Si le fragment est absent ou vide, la valeur est "". href renvoie l’URL complète sous forme de chaîne, avec la requête et le fragment s’ils sont présents. Un # seul en fin d’URL peut apparaître dans href alors que hash vaut "".

Une affectation à hash ne modifie que le fragment ; le # initial est facultatif. Si le fragment obtenu est identique, aucune navigation n’a lieu. Affecter "" définit un fragment vide au lieu de le supprimer. Un changement de fragment par navigation dans le même document déclenche hashchange sans recharger le document.

Une affectation à href indique une destination de navigation. Une URL relative est résolue par rapport à l’URL de base de l’environnement appelant. Si l’analyse échoue, le navigateur lève une DOMException nommée SyntaxError. Les règles d’origine restreignent la lecture des deux propriétés et l’écriture de hash. L’écriture de href peut être autorisée entre origines différentes, mais reste soumise aux restrictions de navigation.

Exemples

(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();
  }
})();

Résultat

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

Exécutez le code dans la console d’une page HTTP(S) ordinaire, entièrement chargée et autorisant une iframe sans restrictions `sandbox`. Chaque ligne affiche `[hash, href]`. Les deux affectations modifient l’URL de l’iframe, pas celle de la page parente. Dans Node.js, l’exemple utilise un objet `URL` plutôt que `Location` pour montrer uniquement la sérialisation de l’URL, sans navigation ni événement `hashchange`.

Leçons associées

  • JavaScript · Leçon 30 · Avancé · Version : 4

Sources