CKTIS / HTML
ping — Hyperlink-Auditing
Das ping-Attribut von a- und area-Elementen enthält URLs, an die beim Aufrufen eines Hyperlinks eine Benachrichtigung gesendet werden kann. Es ändert nicht das href-Ziel, und der Browser kann Benachrichtigungen unterdrücken.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ping="URL [URL ...]"ping ermöglicht das Auditing von Hyperlinks bei a- und area-Elementen. href gibt das Navigationsziel an, während ping die Empfänger der Benachrichtigung festlegt. Ohne href erzeugt das Element keinen Hyperlink.
Der Wert ist eine Liste von URLs, die durch ASCII-Leerraum und nicht durch Kommas getrennt werden. Jedes Token muss eine gültige, nicht leere URL mit einem HTTP(S)-Schema sein. Relative URLs werden relativ zum Dokument aufgelöst.
Wenn Nutzerinnen oder Nutzer dem Hyperlink folgen, kann der Browser an jeden Empfänger eine POST-Anfrage mit Content-Type: text/ping und dem Inhalt PING senden, unabhängig vom Ergebnis der Navigation. Antwortinhalte werden ignoriert.
Dies ist ein Mechanismus zur Aktivitätsverfolgung: Der Browser kann abhängig von den Nutzereinstellungen alle oder einzelne Benachrichtigungen unterdrücken. Betrachte ping nicht als garantierten Nachweis eines Besuchs und mache die korrekte Funktion der Anwendung nicht davon abhängig.
Beispiele
<!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>Ergebnis
Ping targets: ./audit-one, ./audit-two Link destination: #destination
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.