KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

referrerpolicy — referrerinformatie beheren

Het kenmerk referrerpolicy bepaalt hoeveel informatie over het adres van de verwijzende pagina een browser tijdens navigatie of het ophalen van een bron in de Referer-header mag verzenden. Het geldt voor een specifiek element; het is geen globaal kenmerk en geen CORS-instelling.

Versie: 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 is een enumeratief kenmerk voor a, area, img, iframe, script en link. Het bepaalt welke informatie wordt verzonden in de HTTP-header Referer — de naam van de header behoudt bewust de historische spelling. Voor a en area geldt het voor navigatie, voor img voor het ophalen van afbeeldingen, voor iframe voor framenavigatie en voor link voor het ophalen en verwerken van een externe bron.

Waarden: no-referrer laat de header weg; same-origin verzendt het adres alleen naar dezelfde origin; origin verzendt alleen de origin; origin-when-cross-origin verzendt het adres binnen dezelfde origin en elders alleen de origin. Een origin bestaat uit schema, host en poort; het betekent niet simpelweg hetzelfde domein. ‘Adres’ betekent hier de URL zonder fragment en inloggegevens, maar kan nog wel het pad en queryparameters bevatten.

no-referrer-when-downgrade verzendt het adres, behalve bij een overgang van een veilige naar een minder veilige context, zoals HTTPS → HTTP. strict-origin verzendt alleen de origin en laat die bij zo’n downgrade weg. strict-origin-when-cross-origin verzendt het adres binnen dezelfde origin, alleen de origin tussen origins en niets bij zo’n downgrade. unsafe-url verzendt het adres zelfs bij een downgrade: hierdoor kunnen gevoelige paden en queryparameters worden blootgesteld.

Een ontbrekend kenmerk, een lege tekenreeks en een onbekende waarde betekenen allemaal de lege beleidsstatus, niet no-referrer; het beleid van de documentcontext is van toepassing. rel="noreferrer" gaat vóór het beleid van een hyperlink. Voor script omvat de instelling de eerste ophaalactie en module-imports, waaronder import(), maar geen gewone fetch()-aanroepen in de code. Het kenmerk verleent geen CORS-machtigingen en schakelt cookies niet uit.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen