HTMLAnchorElement: свойство referrerPolicy

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

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

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

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

Значение

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

no-referrer: Заголовок Referer будет полностью опущен. Никакая информация о referrer не отправляется вместе с запросами.
no-referrer-when-downgrade: URL отправляется в качестве referrer, когда уровень безопасности протокола остается неизменным (например, HTTP→HTTP, HTTPS→HTTPS), но не отправляется в менее безопасное место назначения (например, HTTPS→HTTP).
origin: Во всех случаях отправлять только источник документа в качестве referrer. Документ https://example.com/page.html отправит referrer https://example.com/.
origin-when-cross-origin: Отправлять полный URL при выполнении запроса с одинаковым источником, но только отправлять источник документа для других случаев.
same-origin: Referrer будет отправлен для сайтов с одинаковым источником, но запросы с разными источниками не будут содержать информацию о referrer.
strict-origin: Отправлять только источник документа в качестве referrer, когда уровень безопасности протокола остается неизменным (например, HTTPS→HTTPS), но не отправлять его в менее безопасное место назначения (например, HTTPS→HTTP).
strict-origin-when-cross-origin (по умолчанию): Это поведение по умолчанию для пользователя, если политика не указана. Отправлять полный URL при выполнении запроса с одинаковым источником, отправлять только источник при сохранении уровня безопасности протокола (например, HTTPS→HTTPS) и не отправлять заголовок в менее безопасное место назначения (например, HTTPS→HTTP).
unsafe-url: Отправлять полный URL при выполнении запроса с одинаковым или разным источником. Эта политика может раскрыть источники и пути от защищенных TLS ресурсов к небезопасным источникам. Внимательно рассмотрите влияние этого параметра.

Примеры

const elt = document.createElement("a");
const linkText = document.createTextNode("My link");
elt.appendChild(linkText);
elt.href = "https://developer.mozilla.org/en-US/";
elt.referrerPolicy = "no-referrer";

const div = document.getElementById("divAround");
div.appendChild(elt); // When clicked, the link will not send a referrer header.

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

Спецификация
HTML # dom-a-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	5251–52	50	41	14	6.05.0–6.0	5251–52
`no-referrer-when-downgrade`	52	79	61–92	39	14	52	61–92	41	14	6.0	52
`origin-when-cross-origin`	52	79	61–92	39	14	52	61–92	41	14	6.0	52
`unsafe-url`	52	79	61–92	39	14	52	61–92	41	14	6.0	52

См. также

HTMLImageElement.referrerPolicy, HTMLAreaElement.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/HTMLAnchorElement/referrerPolicy