Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

referrerpolicy — controlar la información del referente

El atributo referrerpolicy especifica cuánta información sobre la dirección de la página referente puede enviar un navegador en la cabecera Referer durante una navegación o la obtención de un recurso. Se aplica a un elemento concreto; no es un atributo global ni una configuración de CORS.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

referrerpolicy es un atributo enumerado de a, area, img, iframe, script y link. Controla la información que se envía en la cabecera HTTP Referer; el nombre de la cabecera conserva deliberadamente su grafía histórica. En a y area se aplica a la navegación; en img, a la obtención de imágenes; en iframe, a la navegación del marco; y en link, a la obtención y el procesamiento de un recurso externo.

Valores: no-referrer omite la cabecera; same-origin envía la dirección solo al mismo origen; origin envía únicamente el origen; origin-when-cross-origin envía la dirección dentro del mismo origen y solo el origen en los demás casos. Un origen consta de esquema, host y puerto; no significa simplemente el mismo dominio. Aquí, «dirección» significa la URL sin su fragmento ni las credenciales de inicio de sesión, aunque todavía puede incluir su ruta y sus parámetros de consulta.

no-referrer-when-downgrade envía la dirección salvo al pasar de un contexto seguro a otro menos seguro, como HTTPS → HTTP. strict-origin envía solo el origen y lo omite durante ese tipo de degradación. strict-origin-when-cross-origin envía la dirección dentro del mismo origen, solo el origen entre orígenes y nada durante esa degradación. unsafe-url envía la dirección incluso durante una degradación: puede exponer rutas y parámetros de consulta sensibles.

Si se omite el atributo, se usa una cadena vacía o se indica un valor no reconocido, el estado de la política es vacío, no no-referrer; se aplica la política proporcionada por el contexto del documento. rel="noreferrer" tiene prioridad sobre la política de un hipervínculo. En script, la configuración abarca la obtención inicial y las importaciones de módulos, incluido import(), pero no las llamadas normales a fetch() en su código. El atributo no concede permisos CORS ni desactiva las cookies.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes