HTMLGeolocationElement: promptdismiss event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}{{SeeCompatTable}}

The **promptdismiss** event of the {{domxref("HTMLGeolocationElement")}} interface is fired whenever the user activates the <geolocation> element and dismisses the resulting dialog, by pressing the "close" button or the <kbd>Esc</kbd> key.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("promptdismiss", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
onpromptdismiss = (event) => { }

Event type

An {{domxref("Event")}}.

Examples

Using promptdismiss to respond to user permission dismissal

In our Embedded map demo (source code), we use a promptdismiss event handler to respond to the user dismissing the <geolocation> permission prompt:

js
geo.addEventListener("promptdismiss", notifyUserRetrySelection);

In the notifyUserRetrySelection() function, we ask the user to press the button again and allow location.

js
function notifyUserRetrySelection() {
  statusElem.textContent =
    'Please press the "Use location" button again and allow location for this site.';
}

See the main {{domxref("HTMLGeolocationElement")}} page for a full walkthrough of this example.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{htmlelement("geolocation")}} element