Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

referrerpolicy — controlar as informações de referência

O atributo referrerpolicy especifica quanta informação sobre o endereço da página de referência um navegador pode enviar no cabeçalho Referer durante uma navegação ou a obtenção de um recurso. Aplica-se a um elemento específico; não é um atributo global nem uma definição CORS.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

referrerpolicy é um atributo enumerado de a, area, img, iframe, script e link. Controla a informação enviada no cabeçalho HTTP Referer — o nome do cabeçalho mantém deliberadamente a grafia histórica. Em a e area, aplica-se à navegação; em img, à obtenção de imagens; em iframe, à navegação do frame; e em link, à obtenção e ao processamento de um recurso externo.

Valores: no-referrer omite o cabeçalho; same-origin envia o endereço apenas para a mesma origem; origin envia apenas a origem; origin-when-cross-origin envia o endereço dentro da mesma origem e apenas a origem nos restantes casos. Uma origem é composta pelo esquema, anfitrião e porta; não significa simplesmente o mesmo domínio. Aqui, «endereço» significa o URL sem o fragmento e as credenciais de início de sessão, mas pode ainda incluir o caminho e os parâmetros de consulta.

no-referrer-when-downgrade envia o endereço, exceto ao passar de um contexto seguro para outro menos seguro, como HTTPS → HTTP. strict-origin envia apenas a origem e omite-a durante esse tipo de transição. strict-origin-when-cross-origin envia o endereço dentro da mesma origem, apenas a origem entre origens e nada durante essa transição. unsafe-url envia o endereço mesmo durante uma transição para um contexto menos seguro: pode expor caminhos e parâmetros de consulta sensíveis.

A ausência do atributo, uma cadeia vazia e um valor não reconhecido significam todos o estado de política vazia, não no-referrer; aplica-se a política fornecida pelo contexto do documento. rel="noreferrer" tem precedência sobre a política de uma hiperligação. Em script, a definição abrange a obtenção inicial e as importações de módulos, incluindo import(), mas não as chamadas normais a fetch() no respetivo código. O atributo não concede permissões CORS nem desativa cookies.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes