Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Location.hash a Location.href: fragment verzus celá adresa URL

`Location.hash` číta alebo mení fragment adresy URL. `Location.href` vracia celú adresu alebo požiada prehliadač o navigáciu na zadaný cieľ.

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

Syntax

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

window.location sprístupňuje objekt Location spojený s dokumentom. Ide o rozhranie prehliadača definované štandardom HTML, nie o súčasť ECMAScriptu 2024. Mimo kontextu okna prehliadača sa na jeho dostupnosť nespoliehaj.

Pri čítaní hash vracia neprázdny fragment s úvodným znakom # bez dekódovania percentového kódovania. Ak fragment chýba alebo je prázdny, vráti "". href vracia celú adresu URL ako reťazec vrátane dopytovej časti a fragmentu, ak sú prítomné. Na konci href môže byť samotný znak #, aj keď hash vracia "".

Priradenie do hash mení len fragment; úvodný # je nepovinný. Ak je výsledný fragment rovnaký, navigácia sa nevykoná. Priradenie "" nastaví prázdny fragment namiesto toho, aby ho odstránilo. Zmena fragmentu pri navigácii v rámci toho istého dokumentu vyvolá udalosť hashchange bez opätovného načítania dokumentu.

Priradením do href určíš cieľ navigácie. Relatívna adresa sa vyhodnotí voči základnej adrese URL volajúceho prostredia. Ak sa adresu nepodarí spracovať, prehliadač vyvolá výnimku DOMException s názvom SyntaxError. Pravidlá pôvodu obmedzujú čítanie oboch vlastností aj zápis do hash. Zápis do href môže byť povolený aj medzi rôznymi pôvodmi, ale stále platia obmedzenia navigácie.

Príklady

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

Výsledok

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

Kód spusti v konzole bežnej plne načítanej stránky HTTP(S), ktorá povoľuje iframe bez obmedzení `sandbox`. Každý riadok ukazuje `[hash, href]`. Obe priradenia menia URL rámca, nie URL nadradenej stránky. V Node.js príklad používa objekt `URL` namiesto `Location` a ukazuje iba serializáciu adresy URL, bez navigácie či udalostí `hashchange`.

Súvisiace lekcie

  • JavaScript · Lekcia 30 · Pokročilá · Verzia: 4

Zdroje