coderef

HTMLGeolocationElement initialPermissionStatusLimited availability

The initialPermissionStatus property of the HTMLGeolocationElement API represents whether geolocation was previously granted, denied, or neither, when the page first loads.

Not yet supported in all major browsers — check the table and provide a fallback.

Discouraged: The value of the property can be miscomputed and the sole implementer, Chromium, intends to remove it.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–143Not supported
144+Supportedsince Jan 13, 2026
Current: 155
Edge
12–143Not supported
144+Supportedsince Jan 21, 2026
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
18–143Not supported
144+Supportedsince Jan 13, 2026
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Firefox, Safari, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: initialPermissionStatus.

Feature detection

JS · check before using
if ("HTMLGeolocationElement" in globalThis && "initialPermissionStatus" in HTMLGeolocationElement.prototype) {
  // HTMLGeolocationElement.initialPermissionStatus is available
}

Documentation (MDN)

Specification