HTMLAreaElement: ping property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The ping
property of the HTMLAreaElement
interface is a space-separated list of URLs. When the link is followed, the browser will send POST
requests with the body PING to the URLs.
It reflects the ping
attribute of the <area>
element.
Note: This property is not effective in Firefox and its usage may be limited due to privacy and security concerns.
Example
html
<map>
<area
href="https://example.com"
ping="https://example-tracking.com https://example-analytics.com"
alt="example" />
</map>
js
const areaCollection = document.getElementsByTagName("map")[0].areas;
console.log(areaCollection[0].ping); // Output: "https://example-tracking.com https://example-analytics.com"
Specifications
Specification |
---|
HTML Standard # dom-area-ping |
Browser compatibility
BCD tables only load in the browser
See also
HTMLAnchorElement.ping
property