Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

ping — audit des hyperliens

L’attribut ping des éléments a et area répertorie les URL auxquelles une notification peut être envoyée lorsqu’un hyperlien est suivi. Il ne modifie pas la destination href, et le navigateur peut supprimer les notifications.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

ping="URL [URL ...]"

ping permet l’audit des hyperliens sur les éléments a et area. href indique la destination de la navigation, tandis que ping désigne les destinataires des notifications. Sans href, l’élément ne crée pas d’hyperlien.

Sa valeur est une liste d’URL séparées par des espaces blancs ASCII, et non par des virgules. Chaque élément doit être une URL valide et non vide dont le schéma est HTTP(S). Les URL relatives sont résolues par rapport au document.

Lorsque l’utilisateur suit l’hyperlien, le navigateur peut envoyer à chaque destinataire une requête POST avec Content-Type: text/ping et le corps PING, indépendamment du résultat de la navigation. Le contenu des réponses est ignoré.

Il s’agit d’un mécanisme de suivi de l’activité : selon les préférences de l’utilisateur, le navigateur peut supprimer toutes les notifications ou seulement certaines. Ne considérez pas ping comme une preuve garantie de visite et ne faites pas dépendre le bon fonctionnement de l’application de cet attribut.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources