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

CKTIS / JavaScript

Location.href — четене на адреса и навигация

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

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

window.location.href
window.location.href = url

Location.href е свойство на API на браузъра, достъпно чрез window.location.href. При прочитане връща сериализирания URL адрес на документа, включително заявката и фрагмента, ако са налични.

Задаването на window.location.href = url започва навигация. При задаване на стойност относителният адрес се разрешава спрямо базовия URL адрес на API на входния обект с настройки (entry settings object). При синхронно извикване между рамки това може да е базовият URL адрес на рамката, която е започнала извикването, а не на рамката, чийто код извършва присвояването. Невалиден адрес може да предизвика DOMException от тип SyntaxError.

Четенето на адреса на друг прозорец е подчинено на ограниченията за произход и може да предизвика SecurityError. Примерът само прочита адреса; страницата не се напуска.

Примери

const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());

Резултат

string
true

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

Източници