HTMLGeolocationElement: error property

Limited availability

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

See full compatibility

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

<geolocation autolocate></geolocation>

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.

Specifications

Specification
The HTML Geolocation Element # dom-htmlgeolocationelement-error

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`error` Experimental	Chrome – Full support Chrome 144 (Release date: 2026-01-13) footnote Full support	Edge – Full support Edge 144 (Release date: 2026-01-21) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 128 (Release date: 2026-02-26) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 144 (Release date: 2026-01-13) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 95 (Release date: 2026-02-11) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – No support Samsung Internet footnote No support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: Experimental. Expect behavior to change in the future.