HTMLGeolocationElement: isValid 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 isValid read-only property of the HTMLGeolocationElement interface returns a boolean value indicating whether the associated <geolocation> element is valid or invalid (blocked).

When a blocker is active on a <geolocation> element, it is prevented from functioning (invalid), either temporarily or permanently, depending on the reason.

You can return the reason why it is invalid via the HTMLGeolocationElement.invalidReason property — see that page for a full list of possible reasons.

Value

A boolean value:

If true, the <geolocation> element is valid and functional, meaning that it can be used to request location data.
If false, the <geolocation> element is invalid and non-functional, meaning that it can't be used to request location data.

Defaults to false.

Examples

Basic usage

html

js
const geo = document.querySelector("geolocation");
console.log(geo.isValid);
// true, provided the `<geolocation>` element is not blocked in some way

See the HTMLGeolocationElement.invalidReason page for a more complete example involving isValid.