From 021ad5ee8540b92d9533b55de12bfa064afca1d1 Mon Sep 17 00:00:00 2001 From: shubham oulkar <91728992+ShubhamOulkar@users.noreply.github.com> Date: Thu, 25 Jan 2024 07:45:30 +0000 Subject: [PATCH 1/5] document for HTMLAreaElement.ping --- .../web/api/htmlareaelement/ping/index.md | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 files/en-us/web/api/htmlareaelement/ping/index.md diff --git a/files/en-us/web/api/htmlareaelement/ping/index.md b/files/en-us/web/api/htmlareaelement/ping/index.md new file mode 100644 index 000000000000000..d32dfe25fd6aee7 --- /dev/null +++ b/files/en-us/web/api/htmlareaelement/ping/index.md @@ -0,0 +1,43 @@ +--- +title: "HTMLAreaElement: ping property" +short-title: ping +slug: Web/API/HTMLAreaElement/ping +page-type: web-api-instance-property +browser-compat: api.HTMLAreaElement.ping +--- + +{{ApiRef("HTML DOM")}} + +The **`ping`** property of the {{domxref("HTMLAreaElement")}} interface is a space-separated list of 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 + + example + +``` + +```js +const areaCollection = document.getElementsByTagName("map")[0].areas; +console.log(areaCollection[0].ping); // Output: "https://example-tracking.com" +``` + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{domxref("HTMLAnchorElement.ping")}} property From f6c07e2a34a2a00e5f322b499dfbae7d5864e3b5 Mon Sep 17 00:00:00 2001 From: shubham oulkar <91728992+ShubhamOulkar@users.noreply.github.com> Date: Thu, 25 Jan 2024 07:50:28 +0000 Subject: [PATCH 2/5] property list update --- files/en-us/web/api/htmlareaelement/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/files/en-us/web/api/htmlareaelement/index.md b/files/en-us/web/api/htmlareaelement/index.md index cd63124209318b9..de73f886be0e743 100644 --- a/files/en-us/web/api/htmlareaelement/index.md +++ b/files/en-us/web/api/htmlareaelement/index.md @@ -37,6 +37,8 @@ _Inherits properties from its parent {{domxref("HTMLElement")}}._ - : A string containing the password specified before the domain name. - {{domxref("HTMLAreaElement.pathname")}} - : A string containing the path name component, if any, of the referenced URL. +- {{domxref("HTMLAreaElement.ping")}} + - : A space-separated list of URLs. - {{domxref("HTMLAreaElement.port")}} - : A string containing the port component, if any, of the referenced URL. - {{domxref("HTMLAreaElement.protocol")}} From 988e13e53eedafa26466f77b2e9c248c6a28d76b Mon Sep 17 00:00:00 2001 From: shubham oulkar <91728992+ShubhamOulkar@users.noreply.github.com> Date: Fri, 26 Jan 2024 13:14:43 +0000 Subject: [PATCH 3/5] content and example update --- files/en-us/web/api/htmlareaelement/index.md | 2 +- files/en-us/web/api/htmlareaelement/ping/index.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/files/en-us/web/api/htmlareaelement/index.md b/files/en-us/web/api/htmlareaelement/index.md index de73f886be0e743..29628ff12ecaa44 100644 --- a/files/en-us/web/api/htmlareaelement/index.md +++ b/files/en-us/web/api/htmlareaelement/index.md @@ -38,7 +38,7 @@ _Inherits properties from its parent {{domxref("HTMLElement")}}._ - {{domxref("HTMLAreaElement.pathname")}} - : A string containing the path name component, if any, of the referenced URL. - {{domxref("HTMLAreaElement.ping")}} - - : A space-separated list of URLs. + - : A space-separated list of URLs. When the link is followed, the browser will send POST requests with the body PING to the URLs. - {{domxref("HTMLAreaElement.port")}} - : A string containing the port component, if any, of the referenced URL. - {{domxref("HTMLAreaElement.protocol")}} diff --git a/files/en-us/web/api/htmlareaelement/ping/index.md b/files/en-us/web/api/htmlareaelement/ping/index.md index d32dfe25fd6aee7..ed2b8d4f6b8748c 100644 --- a/files/en-us/web/api/htmlareaelement/ping/index.md +++ b/files/en-us/web/api/htmlareaelement/ping/index.md @@ -8,7 +8,7 @@ browser-compat: api.HTMLAreaElement.ping {{ApiRef("HTML DOM")}} -The **`ping`** property of the {{domxref("HTMLAreaElement")}} interface is a space-separated list of URLs. +The **`ping`** property of the {{domxref("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 {{HTMLElement("area")}} element. @@ -20,14 +20,14 @@ It reflects the `ping` attribute of the {{HTMLElement("area")}} element. example ``` ```js const areaCollection = document.getElementsByTagName("map")[0].areas; -console.log(areaCollection[0].ping); // Output: "https://example-tracking.com" +console.log(areaCollection[0].ping); // Output: "https://example-tracking.com https://example-analytics.com" ``` ## Specifications From 195f0e6a328c05ce57ba54244566d9e1473d8543 Mon Sep 17 00:00:00 2001 From: shubham oulkar <91728992+ShubhamOulkar@users.noreply.github.com> Date: Sat, 27 Jan 2024 12:06:34 +0530 Subject: [PATCH 4/5] Update files/en-us/web/api/htmlareaelement/ping/index.md Co-authored-by: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> --- files/en-us/web/api/htmlareaelement/ping/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/htmlareaelement/ping/index.md b/files/en-us/web/api/htmlareaelement/ping/index.md index ed2b8d4f6b8748c..98f1541d50e893a 100644 --- a/files/en-us/web/api/htmlareaelement/ping/index.md +++ b/files/en-us/web/api/htmlareaelement/ping/index.md @@ -8,7 +8,7 @@ browser-compat: api.HTMLAreaElement.ping {{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 POST requests with the body PING to the URLs. +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. From 4b100e108419cca12f02ebc4965a1209cb70029b Mon Sep 17 00:00:00 2001 From: shubham oulkar <91728992+ShubhamOulkar@users.noreply.github.com> Date: Sat, 27 Jan 2024 12:06:47 +0530 Subject: [PATCH 5/5] Update files/en-us/web/api/htmlareaelement/index.md Co-authored-by: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> --- files/en-us/web/api/htmlareaelement/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/htmlareaelement/index.md b/files/en-us/web/api/htmlareaelement/index.md index 29628ff12ecaa44..52c910f2f223210 100644 --- a/files/en-us/web/api/htmlareaelement/index.md +++ b/files/en-us/web/api/htmlareaelement/index.md @@ -38,7 +38,7 @@ _Inherits properties from its parent {{domxref("HTMLElement")}}._ - {{domxref("HTMLAreaElement.pathname")}} - : A string containing the path name component, if any, of the referenced URL. - {{domxref("HTMLAreaElement.ping")}} - - : A space-separated list of URLs. When the link is followed, the browser will send POST requests with the body PING to the URLs. + - : 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. - {{domxref("HTMLAreaElement.port")}} - : A string containing the port component, if any, of the referenced URL. - {{domxref("HTMLAreaElement.protocol")}}