Spec-Zone.ru › Web APIs

HTMLAreaElement: свойство referrerPolicy

Базовая Широко поддерживается *

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

* Некоторые части этой функции могут иметь различный уровень поддержки.

  • Узнать больше
  • Полная совместимость
  • Отправить обратную связь

Свойство HTMLAreaElement.referrerPolicy отражает атрибут HTML referrerpolicy элемента <area>, определяющего, какой referrer отправляется при получении ресурса.

Значение

Строка; одна из следующих:

no-referrer

Заголовок Referer будет полностью опущен. Никакая информация о referrer не отправляется вместе с запросами.

no-referrer-when-downgrade

URL отправляется как referrer, когда уровень безопасности протокола остается неизменным (например, HTTP→HTTP, HTTPS→HTTPS), но не отправляется в менее безопасное место назначения (например, HTTPS→HTTP).

origin

В любом случае отправлять только начало URL документа как referrer. Документ https://example.com/page.html будет отправлять referrer https://example.com/.

origin-when-cross-origin

Отправлять полный URL при выполнении запроса в рамках одного происхождения, но только отправлять начало URL документа в других случаях.

same-origin

Referrer будет отправлен для происхождений одного сайта, но запросы с разными происхождениями не будут содержать информацию о referrer.

strict-origin

Отправлять только начало URL документа как referrer, когда уровень безопасности протокола остается неизменным (например, HTTPS→HTTPS), но не отправлять его в менее безопасное место назначения (например, HTTPS→HTTP).

strict-origin-when-cross-origin (по умолчанию)

Это стандартное поведение браузера, если политика не указана. Отправлять полный URL при выполнении запроса в рамках одного происхождения, только начало URL при сохранении уровня безопасности протокола (например, HTTPS→HTTPS) и не отправлять заголовок в менее безопасное место назначения (например, HTTPS→HTTP).

unsafe-url

Отправлять полный URL при выполнении запроса в рамках одного происхождения или с другим происхождением. Эта политика может раскрывать начала и пути из защищенных TLS ресурсов в незащищенные. Внимательно рассмотрите влияние этого параметра.

Примеры

<img usemap="#mapAround" width="100" height="100" src="/img/logo@2x.png" />
<map id="myMap" name="mapAround" />>
const elt = document.createElement("area");
elt.href = "/img2.png";
elt.shape = "rect";
elt.referrerPolicy = "no-referrer";
elt.coords = "0,0,100,100";
const map = document.getElementById("myMap");

map.appendChild(elt);
// When clicked, the area's link will not send a referrer header.

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

Спецификация
HTML
# dom-area-referrerpolicy

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
referrerPolicy 5251–52 79 50 3938–39 14.1 5251–52 50 41 14.5 6.05.0–6.0 5251–52
no-referrer-when-downgrade 52 79 61–92 39 14.1 52 61–92 41 14.5 6.0 52
origin-when-cross-origin 52 79 61–92 39 14.1 52 61–92 41 14.5 6.0 52
unsafe-url 52 79 61–92 39 14.1 52 61–92 41 14.5 6.0 52

См. также

  • HTMLImageElement.referrerPolicy, HTMLAnchorElement.referrerPolicy и HTMLIFrameElement.referrerPolicy.

© 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/HTMLAreaElement/referrerPolicy

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API