HTMLLinkElement: свойство referrerPolicy

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

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

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

Свойство referrerPolicy интерфейса HTMLLinkElement отражает атрибут HTML referrerpolicy элемента <link>, определяющий, какой отправитель (referrer) отправляется при получении ресурса.

Подробную информацию см. в заголовке HTTP Referrer-Policy.

Значение

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

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

Примеры

const links = document.getElementsByTagName("link");
links[0].referrerPolicy; // "no-referrer"

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`referrerPolicy`	58	79	50	45	14.1	58	50	43	14.5	7.0	58
`no-referrer-when-downgrade`	58	79	50–92	45	14.1	58	50–92	43	14.5	7.0	58
`origin-when-cross-origin`	58	79	50–92	45	14.1	58	50–92	43	14.5	7.0	58
`unsafe-url`	58	79	50–92	45	14.1	58	50–92	43	14.5	7.0	58

См. также

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