Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje