CKTIS / HTML
referrerpolicy — řízení informací o odkazující stránce
Atribut referrerpolicy určuje, kolik informací o adrese odkazující stránky může prohlížeč odeslat v hlavičce Referer při navigaci nebo načítání prostředku. Platí pro konkrétní prvek; nejde o globální atribut ani nastavení CORS.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
referrerpolicy="no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|same-origin|strict-origin|strict-origin-when-cross-origin|unsafe-url"referrerpolicy je výčtový atribut prvků a, area, img, iframe, script a link. Řídí informace odesílané v HTTP hlavičce Referer — název hlavičky si záměrně zachovává historický pravopis. U a a area se vztahuje na navigaci, u img na načítání obrázku, u iframe na navigaci rámce a u link na načítání a zpracování externího prostředku.
Hodnoty: no-referrer hlavičku vynechá; same-origin odešle adresu pouze na stejný origin; origin odešle jen origin; origin-when-cross-origin odešle adresu v rámci stejného originu a jinde pouze origin. Origin se skládá ze schématu, hostitele a portu; neznamená prostě stejnou doménu. „Adresa“ zde znamená URL bez fragmentu a přihlašovacích údajů, může však stále obsahovat cestu a parametry dotazu.
no-referrer-when-downgrade odešle adresu s výjimkou přechodu ze zabezpečeného do méně zabezpečeného kontextu, například HTTPS → HTTP. strict-origin odešle pouze origin a při takovém snížení úrovně zabezpečení jej vynechá. strict-origin-when-cross-origin odešle adresu v rámci stejného originu, mezi originy pouze origin a při takovém snížení nic. unsafe-url odešle adresu i při snížení úrovně zabezpečení: může odhalit citlivé cesty a parametry dotazu.
Chybějící atribut, prázdný řetězec i nerozpoznaná hodnota znamenají prázdný stav zásady, nikoli no-referrer; použije se zásada poskytovaná kontextem dokumentu. rel="noreferrer" má přednost před zásadou hypertextového odkazu. U script se nastavení vztahuje na počáteční načtení a importy modulů včetně import(), nikoli však na běžná volání fetch() v jeho kódu. Atribut neuděluje oprávnění CORS ani nevypíná cookies.
Příklady
<!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>Výsledek
Explicit link policy: no-referrer Other link policy override: ""
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.