CKTIS / HTML
referrerpolicy — upravljanje informacijama o stranici upućivanja
Atribut referrerpolicy određuje koliko informacija o adresi stranice koja upućuje preglednik smije poslati u zaglavlju Referer tijekom navigacije ili dohvaćanja resursa. Primjenjuje se na određeni element; nije globalni atribut ni postavka CORS-a.
Verzija: 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 enumerirani atribut elemenata a, area, img, iframe, script i link. Upravlja informacijama koje se šalju u HTTP zaglavlju Referer — naziv zaglavlja namjerno zadržava povijesni pravopis. Za a i area primjenjuje se na navigaciju, za img na dohvaćanje slike, za iframe na navigaciju okvira, a za link na dohvaćanje i obradu vanjskog resursa.
Vrijednosti: no-referrer izostavlja zaglavlje; same-origin šalje adresu samo istom originu; origin šalje samo origin; origin-when-cross-origin šalje adresu unutar istog origina, a drugdje samo origin. Origin se sastoji od sheme, hosta i porta; ne znači jednostavno istu domenu. „Adresa” ovdje znači URL bez fragmenta i vjerodajnica za prijavu, ali i dalje može sadržavati putanju i parametre upita.
no-referrer-when-downgrade šalje adresu osim pri prijelazu iz sigurnog u manje siguran kontekst, primjerice HTTPS → HTTP. strict-origin šalje samo origin i izostavlja ga pri takvom snižavanju sigurnosti. strict-origin-when-cross-origin šalje adresu unutar istog origina, samo origin između originâ, a pri takvom snižavanju ne šalje ništa. unsafe-url šalje adresu čak i pri snižavanju sigurnosti: time se mogu otkriti osjetljive putanje i parametri upita.
Izostavljen atribut, prazan niz i neprepoznata vrijednost znače prazno stanje pravila, a ne no-referrer; primjenjuje se pravilo koje pruža kontekst dokumenta. rel="noreferrer" ima prednost pred pravilom hiperveze. Za script postavka obuhvaća početno dohvaćanje i uvoze modula, uključujući import(), ali ne i uobičajene pozive fetch() u njegovu kodu. Atribut ne dodjeljuje dopuštenja CORS-a niti onemogućuje kolačiće.
Primjeri
<!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: ""
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.