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

CKTIS / JavaScript

Location: фрагмент, произход, път, заявка и пълен URL

Прочети петте свойства на URL адреса на документа и различавай присвояванията, които могат да задействат навигация.

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

Синтаксис

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location връща обекта Location, свързан с документа. Това е уеб API на браузъра, а не част от ECMAScript 2024. Обектът отразява текущия URL адрес на документа, но вече прочетеният низ не се обновява. Използвай new URL(window.location.href), за да разгледаш или редактираш отделен URL адрес без навигация.

href е пълният сериализиран URL адрес. pathname съдържа само пътя, без заявката и фрагмента. При HTTP(S) той започва с /, дори за кореновия път. Непрозрачен път като blank в about:blank може да няма начална наклонена черта. search връща непразната заявка с начално ?, а hash — непразния фрагмент с начално #. Ако съответната част липсва или е празна, резултатът е "", дори разделителят още да присъства в href. При четене процентното кодиране не се декодира. Използвай new URLSearchParams(window.location.search), за да прочетеш отделните параметри на заявката.

origin е само за четене и описва произхода на URL адреса. При HTTP(S) включва схемата, името на хоста и порта, ако той не е по подразбиране. Непрозрачният произход на URL адреса се сериализира като низа "null", а не като стойността null. За разлика от него, self.origin описва произхода на средата за изпълнение: документ about:blank може да го наследи. Два еднакви низа "null" не доказват, че произходът е един и същ.

Присвояване на href може да задейства навигация към друг URL адрес, включително относителен. Ако разчитането на адреса е неуспешно, се хвърля DOMException с име SyntaxError. Присвояване на pathname или search може да задейства навигация с променен път или заявка. При непрозрачен път присвояването на pathname няма ефект. Началните ? и # не са задължителни при запис съответно в search и hash. search = "" премахва заявката, но hash = "" може да остави # накрая. Промяната само на фрагмента обикновено не зарежда нов документ.

Четенето на което и да е от тези пет свойства в прозорец с различен произход може да доведе до DOMException с име SecurityError. Записът в href е изключение: може да е разрешен без достъп за четене, но ограниченията на браузъра за навигация остават в сила.

Примери

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Резултат

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Изпълни кода в Node.js. Той чете същите части на URL адреса от обект `URL`, а не от обект `Location` на браузъра, без да задейства навигация. В резултата `"null"` е низ, а `blank` не започва с `/`.

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

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

Източници