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

CKTIS / HTML

ping — auditoria de hiperligações

O atributo ping dos elementos a e area lista os URL para os quais pode ser enviada uma notificação quando uma hiperligação é seguida. Não altera o destino href e o navegador pode suprimir as notificações.

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

Sintaxe

ping="URL [URL ...]"

ping permite auditar hiperligações nos elementos a e area. href especifica o destino da navegação, enquanto ping identifica os destinatários das notificações. Sem href, o elemento não cria uma hiperligação.

O valor é uma lista de URL separados por espaços em branco ASCII, não por vírgulas. Cada elemento tem de ser um URL válido e não vazio com um esquema HTTP(S). Os URL relativos são resolvidos em relação ao documento.

Quando o utilizador segue a hiperligação, o navegador pode enviar a cada destinatário um pedido POST com Content-Type: text/ping e o corpo PING, independentemente do resultado da navegação. O conteúdo das respostas é ignorado.

Este é um mecanismo de rastreio de atividade: de acordo com as preferências do utilizador, o navegador pode suprimir todas as notificações ou apenas algumas. Não considere ping uma prova garantida de uma visita nem faça depender dele o correto funcionamento da aplicação.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="Content-Security-Policy" content="connect-src 'none'">
  <title>Hyperlink auditing targets</title>
</head>
<body>
  <a id="continue" href="#destination" ping="./audit-one ./audit-two">Continue</a>
  <p id="destination">Destination</p>
  <script>
    const link = document.getElementById('continue');
    for (const type of ['click', 'auxclick']) {
      link.addEventListener(type, event => event.preventDefault());
    }
    const targets = link.ping.match(/[^\t\n\f\r ]+/g) ?? [];
    console.log('Ping targets: ' + targets.join(', '));
    console.log('Link destination: ' + link.hash);
  </script>
</body>
</html>

Resultado

Ping targets: ./audit-one, ./audit-two
Link destination: #destination

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