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.