HTMLGeolocationElement: validationstatuschange event

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

The validationstatuschange event of the {{domxref("HTMLGeolocationElement")}} interface is fired whenever the {{htmlelement("geolocation")}} element's {{domxref("HTMLGeolocationElement.isValid", "isValid")}} value changes.

This occurs as a result of a blocker being added to or removed from a <geolocation> element.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

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

onvalidationstatuschange = (event) => { }

Event type

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

Examples

Using validationstatuschange to report invalid reasons

In our Exploring invalid reasons demo (source code), we use a validationstatuschange event handler to report when a <geolocation> element becomes valid, and report the invalid reason when it becomes invalid:

geo.addEventListener("validationstatuschange", () => {
  if (geo.isValid) {
    reasonElem.textContent = `<geolocation> is valid`;
  } else {
    reasonElem.textContent = `Invalid reason: ${geo.invalidReason}`;
  }
});

Whenever the validation status changes, we check whether the <geolocation> element is valid using {{domxref("HTMLGeolocationElement.isValid")}}, and if so, print a message confirming this to the <p> element text content. If the <geolocation> element is invalid, we print the {{domxref("HTMLGeolocationElement.invalidReason")}} to the <p> element text content.

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

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