CKTIS / HTML
referrerpolicy — riadenie informácií o odkazujúcej stránke
Atribút referrerpolicy určuje, koľko informácií o adrese odkazujúcej stránky môže prehliadač odoslať v hlavičke Referer pri navigácii alebo načítavaní zdroja. Platí pre konkrétny prvok; nejde o globálny atribút ani nastavenie CORS.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
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ý atribút prvkov a, area, img, iframe, script a link. Riadi informácie odosielané v HTTP hlavičke Referer — názov hlavičky si zámerne zachováva historický pravopis. Pri a a area sa vzťahuje na navigáciu, pri img na načítavanie obrázka, pri iframe na navigáciu rámca a pri link na načítavanie a spracovanie externého zdroja.
Hodnoty: no-referrer vynechá hlavičku; same-origin odošle adresu iba na rovnaký origin; origin odošle iba origin; origin-when-cross-origin odošle adresu v rámci rovnakého originu a inde iba origin. Origin sa skladá zo schémy, hostiteľa a portu; neznamená jednoducho rovnakú doménu. „Adresa“ tu znamená URL bez fragmentu a prihlasovacích údajov, môže však stále obsahovať cestu a parametre dopytu.
no-referrer-when-downgrade odošle adresu okrem prechodu zo zabezpečeného do menej zabezpečeného kontextu, napríklad HTTPS → HTTP. strict-origin odošle iba origin a pri takomto znížení úrovne zabezpečenia ho vynechá. strict-origin-when-cross-origin odošle adresu v rámci rovnakého originu, medzi originmi iba origin a pri takomto znížení nič. unsafe-url odošle adresu aj pri znížení úrovne zabezpečenia: môže odhaliť citlivé cesty a parametre dopytu.
Chýbajúci atribút, prázdny reťazec aj nerozpoznaná hodnota znamenajú prázdny stav politiky, nie no-referrer; uplatní sa politika poskytnutá kontextom dokumentu. rel="noreferrer" má prednosť pred politikou hypertextového odkazu. Pri script nastavenie zahŕňa počiatočné načítanie a importy modulov vrátane import(), ale nie bežné volania fetch() v jeho kóde. Atribút neudeľuje oprávnenia CORS ani nevypína cookies.
Prí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ýsledok
Explicit link policy: no-referrer Other link policy override: ""
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.