База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Location.hash и Location.href: фрагмент или пълен URL адрес

`Location.hash` чете или променя фрагмента на URL адреса. `Location.href` връща пълния адрес или заявява навигация до зададена цел.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

window.location предоставя достъп до обекта Location, свързан с документа. Това е браузърен API, дефиниран в стандарта HTML, а не част от ECMAScript 2024. Не разчитай, че е наличен извън контекста на прозорец на браузъра.

При четене hash връща непразния фрагмент с началния знак #, без да декодира процентно кодираните последователности. Ако фрагментът липсва или е празен, резултатът е "". href връща целия URL адрес като низ, включително заявката и фрагмента, ако са налични. href може да завършва със самостоятелен знак #, въпреки че hash връща "".

Присвояването на стойност на hash променя само фрагмента; началният # не е задължителен. Ако полученият фрагмент е същият, не се извършва навигация. Присвояването на "" задава празен фрагмент, вместо да го премахва. Промяна на фрагмента чрез навигация в същия документ предизвиква събитието hashchange, без да презарежда документа.

Присвояването на стойност на href задава цел за навигация. Относителните URL адреси се разрешават спрямо базовия URL адрес на извикващата среда. Ако разчитането на адреса е неуспешно, браузърът хвърля DOMException с име SyntaxError. Правилата за произход ограничават четенето на двете свойства и записа в hash. Записът в href може да е разрешен между различни произходи, но ограниченията за навигация продължават да важат.

Примери

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

Резултат

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

Изпълни кода в конзолата на обикновена, напълно заредена HTTP(S) страница, която позволява iframe без ограниченията на `sandbox`. Всеки ред показва `[hash, href]`. И двете присвоявания променят адреса на рамката, а не на родителската страница. В Node.js примерът използва обект `URL` вместо `Location`, за да покаже само сериализацията на URL адреса, без навигация или събития `hashchange`.

Свързани уроци

  • JavaScript · Урок 30 · Напреднало · Версия: 4

Източници