HTMLImageElement: свойство referrerPolicy

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

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

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

Свойство HTMLImageElement.referrerPolicy отражает атрибут HTML referrerpolicy элемента <img>, определяющий, какой 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 img = new Image();
img.src = "img/logo.png";
img.referrerPolicy = "origin";

const div = document.getElementById("divAround");
div.appendChild(img); // Fetch the image using the origin as the referrer

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

Спецификация
HTML # dom-img-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

См. также

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