Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

referrerpolicy — controllare le informazioni sul referrer

L’attributo referrerpolicy specifica quante informazioni sull’indirizzo della pagina di provenienza un browser può inviare nell’header Referer durante una navigazione o il recupero di una risorsa. Si applica a un elemento specifico; non è un attributo globale né un’impostazione CORS.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

referrerpolicy="no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|same-origin|strict-origin|strict-origin-when-cross-origin|unsafe-url"

referrerpolicy è un attributo enumerato di a, area, img, iframe, script e link. Controlla le informazioni inviate nell’header HTTP Referer — il nome dell’header conserva intenzionalmente la sua grafia storica. Per a e area si applica alla navigazione; per img al recupero delle immagini; per iframe alla navigazione del frame; e per link al recupero e all’elaborazione di una risorsa esterna.

Valori: no-referrer omette l’header; same-origin invia l’indirizzo solo allo stesso origin; origin invia solo l’origin; origin-when-cross-origin invia l’indirizzo all’interno dello stesso origin e solo l’origin negli altri casi. Un origin è composto da schema, host e porta; non significa semplicemente lo stesso dominio. Qui, «indirizzo» indica l’URL senza frammento e credenziali di accesso, ma che può ancora includere percorso e parametri di query.

no-referrer-when-downgrade invia l’indirizzo tranne quando si passa da un contesto sicuro a uno meno sicuro, ad esempio HTTPS → HTTP. strict-origin invia solo l’origin e lo omette in caso di tale downgrade. strict-origin-when-cross-origin invia l’indirizzo all’interno dello stesso origin, solo l’origin tra origin diversi e nulla in caso di tale downgrade. unsafe-url invia l’indirizzo anche in caso di downgrade: può esporre percorsi e parametri di query sensibili.

Attributo omesso, stringa vuota e valore non riconosciuto indicano tutti lo stato di policy vuota, non no-referrer; si applica la policy fornita dal contesto del documento. rel="noreferrer" ha precedenza sulla policy di un collegamento ipertestuale. Per script, l’impostazione comprende il recupero iniziale e gli import dei moduli, incluso import(), ma non le normali chiamate a fetch() nel codice. L’attributo non concede autorizzazioni CORS né disabilita i cookie.

Esempi

<!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>

Risultato

Explicit link policy: no-referrer
Other link policy override: ""

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti