CKTIS / HTML
ping — auditovanie hypertextových odkazov
Atribút ping prvkov a a area obsahuje URL, na ktoré možno odoslať oznámenie pri použití hypertextového odkazu. Nemení cieľ href a prehliadač môže oznámenia potlačiť.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ping="URL [URL ...]"ping umožňuje auditovať hypertextové odkazy v prvkoch a a area. href určuje cieľ navigácie, zatiaľ čo ping označuje príjemcov oznámení. Bez href prvok nevytvára hypertextový odkaz.
Hodnota je zoznam URL oddelených ASCII bielymi znakmi, nie čiarkami. Každý token musí byť platná neprázdna URL so schémou HTTP(S). Relatívne URL sa vyhodnocujú vzhľadom na dokument.
Keď používateľ nasleduje hypertextový odkaz, prehliadač môže každému príjemcovi odoslať požiadavku POST s Content-Type: text/ping a telom PING, nezávisle od výsledku navigácie. Telá odpovedí sa ignorujú.
Ide o mechanizmus sledovania aktivity: prehliadač môže podľa preferencií používateľa potlačiť všetky oznámenia alebo len niektoré. Nepovažujte ping za zaručený dôkaz návštevy a nezakladajte od neho správne fungovanie aplikácie.
Prí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ýsledok
Ping targets: ./audit-one, ./audit-two Link destination: #destination
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.