Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje