CKTIS / HTML
referrerpolicy — nadzor podatkov o napotitelju
Atribut referrerpolicy določa, koliko podatkov o naslovu napotitvene strani sme brskalnik poslati v glavi Referer med navigacijo ali pridobivanjem vira. Velja za določen element; ni globalni atribut niti nastavitev CORS.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
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 našteti atribut elementov a, area, img, iframe, script in link. Nadzira podatke, poslane v glavi HTTP Referer — ime glave namenoma ohranja zgodovinski zapis. Pri a in area velja za navigacijo, pri img za pridobivanje slike, pri iframe za navigacijo okvirja, pri link pa za pridobivanje in obdelavo zunanjega vira.
Vrednosti: no-referrer izpusti glavo; same-origin pošlje naslov samo istemu izvoru; origin pošlje samo izvor; origin-when-cross-origin pošlje naslov znotraj istega izvora, drugje pa samo izvor. Izvor sestavljajo shema, gostitelj in vrata; ne pomeni preprosto iste domene. »Naslov« tukaj pomeni URL brez fragmenta in poverilnic za prijavo, lahko pa še vedno vključuje pot in parametre poizvedbe.
no-referrer-when-downgrade pošlje naslov, razen pri prehodu iz varnega v manj varen kontekst, na primer HTTPS → HTTP. strict-origin pošlje samo izvor in ga pri takem poslabšanju varnosti izpusti. strict-origin-when-cross-origin pošlje naslov znotraj istega izvora, med izvori samo izvor, pri takem poslabšanju pa ničesar. unsafe-url pošlje naslov tudi pri poslabšanju varnosti: razkrije lahko občutljive poti in parametre poizvedbe.
Manjkajoč atribut, prazen niz in neprepoznana vrednost pomenijo prazno stanje pravilnika, ne no-referrer; uporabi se pravilnik, ki ga določa kontekst dokumenta. rel="noreferrer" ima prednost pred pravilnikom hiperpovezave. Pri script nastavitev zajema začetni prenos in uvoze modulov, vključno z import(), ne pa običajnih klicev fetch() v njegovi kodi. Atribut ne podeljuje dovoljenj CORS in ne onemogoča piškotkov.
Primeri
<!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>Rezultat
Explicit link policy: no-referrer Other link policy override: ""
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.