Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

referrerpolicy — kontrola informacji o stronie odsyłającej

Atrybut referrerpolicy określa, ile informacji o adresie strony odsyłającej przeglądarka może wysłać w nagłówku Referer podczas nawigacji lub pobierania zasobu. Działa dla konkretnego elementu; nie jest atrybutem globalnym ani ustawieniem CORS.

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

Składnia

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

referrerpolicy to atrybut wyliczeniowy elementów a, area, img, iframe, script i link. Steruje informacją wysyłaną w nagłówku HTTP Referer — nazwa nagłówka celowo zachowuje historyczną pisownię. Dla a i area dotyczy nawigacji, dla img pobrania obrazu, dla iframe nawigacji ramki, a dla link pobierania i przetwarzania zasobu zewnętrznego.

Wartości: no-referrer nie wysyła nagłówka; same-origin wysyła adres tylko do tego samego originu; origin wysyła wyłącznie origin; origin-when-cross-origin wysyła adres dla tego samego originu, a poza nim tylko origin. Origin to schemat, host i port; nie jest to po prostu ta sama domena. „Adres” oznacza tutaj URL po usunięciu fragmentu i danych logowania, ale może nadal zawierać ścieżkę i parametry zapytania.

no-referrer-when-downgrade wysyła adres poza przejściem z bezpiecznego do mniej bezpiecznego kontekstu, np. HTTPS → HTTP. strict-origin wysyła tylko origin i pomija go przy takim przejściu. strict-origin-when-cross-origin wysyła adres w tym samym originie, tylko origin między originami i nic przy takim obniżeniu bezpieczeństwa. unsafe-url wysyła adres również przy obniżeniu bezpieczeństwa: może ujawnić poufne ścieżki i parametry.

Brak atrybutu, pusty ciąg i nieznana wartość oznaczają pusty stan polityki, a nie no-referrer; stosowana jest polityka wynikająca z kontekstu dokumentu. rel="noreferrer" ma pierwszeństwo przed polityką hiperłącza. Dla script ustawienie obejmuje początkowe pobranie i importy modułów, także import(), ale nie zwykłe wywołania fetch() w kodzie. Atrybut nie przyznaje uprawnień CORS ani nie wyłącza ciasteczek.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła