MDN self-hosted library · e01.org

HTMLGeolocationElement: promptaction event

HTML DOM

HTML DOM

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 addEventListener():

addEventListener("promptaction", (event) => { })

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

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

Browser compatibility

See also

  • geolocation element