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.