CKTIS / HTML
ping — hyperlinkauditing
Het ping-attribuut van a- en area-elementen bevat URL’s waarnaar een melding kan worden gestuurd wanneer een hyperlink wordt gevolgd. Het verandert de href-bestemming niet en de browser kan meldingen onderdrukken.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ping="URL [URL ...]"ping maakt hyperlinkauditing mogelijk op a- en area-elementen. href geeft de navigatiebestemming aan, terwijl ping de ontvangers van meldingen vermeldt. Zonder href maakt het element geen hyperlink.
De waarde is een lijst URL’s die met ASCII-witruimte van elkaar zijn gescheiden, niet met komma’s. Elk token moet een geldige, niet-lege URL met een HTTP(S)-schema zijn. Relatieve URL’s worden ten opzichte van het document opgelost.
Wanneer de gebruiker de hyperlink volgt, kan de browser naar elke ontvanger een POST-verzoek sturen met Content-Type: text/ping en de inhoud PING, onafhankelijk van het resultaat van de navigatie. De inhoud van antwoorden wordt genegeerd.
Dit is een mechanisme voor het volgen van activiteit: afhankelijk van de voorkeuren van de gebruiker kan de browser alle meldingen of een selectie ervan onderdrukken. Beschouw ping niet als gegarandeerd bewijs van een bezoek en laat de correcte werking van de toepassing er niet van afhangen.
Voorbeelden
<!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>Resultaat
Ping targets: ./audit-one, ./audit-two Link destination: #destination
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.