CKTIS / HTML
ping — auditování hypertextových odkazů
Atribut ping prvků a a area obsahuje URL, na které lze odeslat oznámení při přechodu přes hypertextový odkaz. Nemění cíl href a prohlížeč může oznámení potlačit.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
ping="URL [URL ...]"ping umožňuje auditovat hypertextové odkazy u prvků a a area. href určuje cíl navigace, zatímco ping označuje příjemce oznámení. Bez href prvek hypertextový odkaz nevytváří.
Hodnota je seznam URL oddělených ASCII bílými znaky, nikoli čárkami. Každý token musí být platná neprázdná URL se schématem HTTP(S). Relativní URL se vyhodnocují vzhledem k dokumentu.
Když uživatel přejde přes hypertextový odkaz, prohlížeč může každému příjemci odeslat požadavek POST s Content-Type: text/ping a tělem PING, a to nezávisle na výsledku navigace. Těla odpovědí se ignorují.
Jde o mechanismus sledování aktivity: prohlížeč může podle preferencí uživatele potlačit všechna oznámení nebo jen některá. Nepovažujte ping za zaručený důkaz návštěvy a nezakládejte na něm správné fungování aplikace.
Příklady
<!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>Výsledek
Ping targets: ./audit-one, ./audit-two Link destination: #destination
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.