База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

referrerpolicy — управление на информацията за препращащата страница

Атрибутът referrerpolicy определя колко информация за адреса на препращащата страница може браузърът да изпрати в заглавката Referer при навигация или извличане на ресурс. Прилага се за конкретен елемент; не е глобален атрибут или настройка на CORS.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

referrerpolicy е изброим атрибут за елементите a, area, img, iframe, script и link. Той управлява информацията, изпращана в HTTP заглавката Referer — името на заглавката умишлено запазва историческия си правопис. За a и area се отнася за навигация, за img — за извличане на изображение, за iframe — за навигация на рамка, а за link — за извличане и обработване на външен ресурс.

Стойности: no-referrer пропуска заглавката; same-origin изпраща адреса само към същия origin; origin изпраща само origin; origin-when-cross-origin изпраща адреса в рамките на същия origin, а другаде — само origin. Origin се състои от схема, хост и порт; той не означава просто същия домейн. Тук „адрес“ означава URL без фрагмента и данните за вход, но все още може да включва пътя и параметрите на заявката.

no-referrer-when-downgrade изпраща адреса, освен при преминаване от защитен към по-малко защитен контекст, например HTTPS → HTTP. strict-origin изпраща само origin и го пропуска при такова понижаване на защитата. strict-origin-when-cross-origin изпраща адреса в рамките на същия origin, само origin между различни origin-и и нищо при такова понижаване. unsafe-url изпраща адреса дори при понижаване на защитата: така могат да бъдат разкрити чувствителни пътища и параметри на заявката.

Липсващ атрибут, празен низ и неразпозната стойност означават празно състояние на политиката, а не no-referrer; прилага се политиката, предоставена от контекста на документа. rel="noreferrer" има предимство пред политиката на хипервръзката. За script настройката обхваща първоначалното извличане и импортирането на модули, включително import(), но не и обикновените извиквания на fetch() в кода му. Атрибутът не предоставя разрешения за CORS и не изключва бисквитките.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници