Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła