CKTIS / HTML
referrerpolicy — управление на информацията за препращащата страница
Атрибутът referrerpolicy определя колко информация за адреса на препращащата страница може браузърът да изпрати в заглавката Referer при навигация или извличане на ресурс. Прилага се за конкретен елемент; не е глобален атрибут или настройка на CORS.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
referrerpolicy="no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|same-origin|strict-origin|strict-origin-when-cross-origin|unsafe-url"referrerpolicy е изброим атрибут за елементите a, area, img, iframe, script и link. Той управлява информацията, изпращана в HTTP заглавката Referer — името на заглавката умишлено запазва историческия си правопис. За a и area се отнася за навигация, за img — за извличане на изображение, за iframe — за навигация на рамка, а за link — за извличане и обработване на външен ресурс.
Стойности: no-referrer пропуска заглавката; same-origin изпраща адреса само към същия origin; origin изпраща само origin; origin-when-cross-origin изпраща адреса в рамките на същия origin, а другаде — само origin. Origin се състои от схема, хост и порт; той не означава просто същия домейн. Тук „адрес“ означава URL без фрагмента и данните за вход, но все още може да включва пътя и параметрите на заявката.
no-referrer-when-downgrade изпраща адреса, освен при преминаване от защитен към по-малко защитен контекст, например HTTPS → HTTP. strict-origin изпраща само origin и го пропуска при такова понижаване на защитата. strict-origin-when-cross-origin изпраща адреса в рамките на същия origin, само origin между различни origin-и и нищо при такова понижаване. unsafe-url изпраща адреса дори при понижаване на защитата: така могат да бъдат разкрити чувствителни пътища и параметри на заявката.
Липсващ атрибут, празен низ и неразпозната стойност означават празно състояние на политиката, а не no-referrer; прилага се политиката, предоставена от контекста на документа. rel="noreferrer" има предимство пред политиката на хипервръзката. За script настройката обхваща първоначалното извличане и импортирането на модули, включително import(), но не и обикновените извиквания на fetch() в кода му. Атрибутът не предоставя разрешения за CORS и не изключва бисквитките.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Per-link referrer policy</title>
</head>
<body>
<p><a id="private-link" href="#destination" referrerpolicy="no-referrer">Destination with no referrer</a></p>
<p><a id="default-link" href="#destination">Destination without a policy override</a></p>
<p id="destination">Destination</p>
<script>
const privateLink = document.getElementById('private-link');
const defaultLink = document.getElementById('default-link');
for (const link of [privateLink, defaultLink]) {
for (const type of ['click', 'auxclick']) {
link.addEventListener(type, event => event.preventDefault());
}
}
console.log('Explicit link policy: ' + privateLink.referrerPolicy);
console.log('Other link policy override: ' + JSON.stringify(defaultLink.referrerPolicy));
</script>
</body>
</html>Резултат
Explicit link policy: no-referrer Other link policy override: ""
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.