HTMLGeolocationElement: error property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The error read-only property of the HTMLGeolocationElement interface returns a GeolocationPositionError object representing error information, in the event of a failure to retrieve location data.

If location data retrieval is successful, the data is available in the HTMLGeolocationElement.position property.

Value

A GeolocationPositionError object, or null if location data was successfully retrieved.

Examples

Basic usage

html

js
const geo = document.querySelector("geolocation");
geo.addEventListener("location", () => {
  if (geo.position) {
    console.log(
      `(${geo.position.coords.latitude},${geo.position.coords.longitude})`,
    );
  } else if (geo.error) {
    console.log(geo.error.message);
  }
});

See our Embedded map example walkthrough for a real-world example that includes error.