HTMLGeolocationElement: promptaction event
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The promptaction event of the HTMLGeolocationElement interface is fired whenever the user activates the <geolocation> element and selects an option from the resulting dialog, either to grant or deny geolocation permission.
Syntax
Use the event name in methods like addEventListener(), or set an event handler property.
addEventListener("promptaction", (event) => { })
onpromptaction = (event) => { }
Event type
An Event.
Examples
>Using promptaction to respond to user permission choices
In our Embedded map demo (source code), we use a promptaction event handler to respond to the user making a choice in the <geolocation> permission prompt:
geo.addEventListener("promptaction", notifyUserGrantPermission);
In the notifyUserGrantPermission() function, we use the HTMLGeolocationElement.permissionStatus property to check whether the permission status is denied or prompt and if so, we ask the user to press the button again and allow location. We don't need to ask this if they already granted permission.
function notifyUserGrantPermission() {
if (geo.permissionStatus === "denied" || geo.permissionStatus === "prompt") {
statusElem.textContent =
'Please press the "Use location" button again and allow location for this site.';
}
}
See the main HTMLGeolocationElement page for a full walkthrough of this example.
Specifications
| Specification |
|---|
| The HTML Permission Elements> # dom-inpagepermissionmixin-onpromptaction> |
Browser compatibility
See also
<geolocation>element