Back to Content

HTMLAreaElement: ping property

files/en-us/web/api/htmlareaelement/ping/index.md

latest972 B
Original Source

{{ApiRef("HTML DOM")}}

The ping property of the {{domxref("HTMLAreaElement")}} interface is a space-separated list of URLs. When the link is followed, the browser will send {{HTTPMethod("POST")}} requests with the body PING to the URLs.

It reflects the ping attribute of the {{HTMLElement("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 name="example-map" id="example-map">
  <area
    href="https://example.com"
    ping="https://example-tracking.com https://example-analytics.com"
    alt="example" />
</map>
js
const areaCollection = document.getElementById("example-map").areas;
console.log(areaCollection[0].ping); // Output: "https://example-tracking.com https://example-analytics.com"

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("HTMLAnchorElement.ping")}} property