Расположение: метод assign()

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Метод assign() интерфейса Location вызывает загрузку и отображение документа по указанному URL. После навигации пользователь может вернуться на страницу, которая вызвала Location.assign(), нажав кнопку "назад".

Синтаксис

assign(url)

Параметры

url: Строка или любой другой объект со строковым представлением, такой как объект URL, содержащий URL страницы для перехода; например, абсолютный URL, такой как https://developer.mozilla.org/en-US/docs/Web/API/Location/reload, или относительный URL — например, /Web (только путь для перехода к другому документу в том же источнике) или #specifications (только фрагмент строки для перехода к определённой части той же страницы) и так далее.

Исключения

SecurityError DOMException: Выбрасывается, если источник скрипта, вызывающего метод, не совпадает с источником страницы, изначально описанной объектом Location, чаще всего, когда скрипт размещён на другом домене. Браузеры также ограничивают навигации и могут выбросить эту ошибку, сгенерировать предупреждение или проигнорировать вызов, если он вызывается слишком часто.
SyntaxError DOMException: Выбрасывается, если предоставленный параметр url не является допустимым URL.

Возвращаемое значение

None (undefined).

Примеры

// Navigate to the Location.reload article
window.location.assign(
  "https://developer.mozilla.org/en-US/docs/Web/API/Location/reload",
);

// Then navigate to its Specifications section
window.location.assign("#specifications");

// Eventually navigate to https://developer.mozilla.org/en-US/docs/Web
window.location.assign("/Web");

Спецификации

Спецификация
HTML # dom-location-assign-dev

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari в iOS	Samsung Internet	WebView Android
`assign`	1	12	1	3	3	18	4	10.1	1	1.0	4.4

См. также

Интерфейс Location, к которому он относится.
Похожие методы: Location.replace() и Location.reload().

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Location/assign