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

CKTIS / JavaScript

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

Използвай `hash`, за да прочетеш или промениш фрагмента, и `href`, за да прочетеш или замениш целия URL адрес. Само по `hash` не личи дали фрагментът е празен, или липсва.

Версия: Current web platform; runtime support varies

Синтаксис

const url = new URL(input, base); // Omit base for an absolute input.
url.hash;                        // Fragment string
url.hash = fragment;
url.href;                        // Full serialized URL
url.href = absoluteUrl;

hash и href са свойства на екземпляр на URL, а не методи или статични свойства. url.hash връща непразния фрагмент с началния знак # или "", ако фрагментът е празен или липсва. url.href връща целия сериализиран URL адрес, включително низа на заявката, ако има такъв. Завършващият знак # в href отличава празния фрагмент от липсващия.

Можеш да зададеш текст на фрагмента в url.hash със или без начален #. Символи като интервалите се кодират с проценти при нужда, но не се декодират автоматично при четене. url.hash = "" премахва фрагмента, а url.hash = "#" оставя празен фрагмент. Фрагментът е отделен от низа на заявката: url.searchParams работи с параметрите на заявката, а фрагментът не се изпраща автоматично до сървъра при HTTP заявка.

Присвояването на стойност на url.href анализира новата стойност и заменя целия URL адрес в същия обект. Ако анализът е неуспешен, се хвърля TypeError. Сетерът не разрешава относителни препратки спрямо текущия URL адрес; за целта използвай new URL(relative, base).href с валиден базов адрес.

Промяната на обект URL не предизвиква навигация, за разлика от присвояването на стойност на window.location.href. Преди да отвориш ненадежден URL адрес, провери дали схемата и произходът му са разрешени: успешният анализ не прави адреса безопасен. URL е API на уеб платформата, а не част от ECMAScript 2024; наличността му зависи от средата за изпълнение.

Примери

{
  const url = new URL("https://example.com/guide?lang=en");
  const show = () => console.log(JSON.stringify([url.hash, url.href]));

  url.hash = "quick start";
  show();

  url.hash = "#";
  show();

  url.hash = "";
  show();

  url.href = "https://example.org/start#intro";
  show();
}

Резултат

["#quick%20start","https://example.com/guide?lang=en#quick%20start"]
["","https://example.com/guide?lang=en#"]
["","https://example.com/guide?lang=en"]
["#intro","https://example.org/start#intro"]

Всеки ред показва `[hash, href]`. Обърни внимание на `%20`, на знака `#` в края само на втория ред и на замяната на целия URL адрес в последния ред.

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

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

Източници