CKTIS / HTML
ping — audyt użycia hiperłączy
Atrybut ping elementów a i area wskazuje adresy otrzymujące powiadomienie o użyciu hiperłącza. Nie zmienia celu href, a przeglądarka może pominąć powiadomienia.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
ping="URL [URL ...]"ping służy do audytu użycia hiperłączy w elementach a i area. href określa cel przejścia, natomiast ping wskazuje odbiorców powiadomień. Bez href element nie tworzy hiperłącza.
Wartością jest lista adresów URL rozdzielonych białymi znakami ASCII, nie przecinkami. Każdy token musi być poprawnym, niepustym adresem URL o schemacie HTTP(S). Adresy względne są rozwiązywane względem dokumentu.
Gdy użytkownik podąża za hiperłączem, przeglądarka może wysłać do każdego odbiorcy żądanie POST z Content-Type: text/ping i treścią PING, niezależnie od wyniku nawigacji. Treść odpowiedzi jest ignorowana.
To mechanizm śledzenia aktywności: przeglądarka może pominąć wszystkie lub wybrane powiadomienia zgodnie z preferencjami użytkownika. Nie traktuj ping jako gwarantowanego potwierdzenia odwiedzin ani warunku poprawnego działania aplikacji.
Przykłady
<!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>Wynik
Ping targets: ./audit-one, ./audit-two Link destination: #destination
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.