Sensor
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Sensor interface of the Sensor APIs is the base class for all the other sensor interfaces. This interface cannot be used directly. Instead it provides properties, event handlers, and methods accessed by interfaces that inherit from it.
This feature may be blocked by a Permissions Policy set on your server.
When initially created, the Sensor object is idle, meaning it does not take measures. Once the start() method is called, it prepares itself to read data and, once ready, the activate event is sent and the sensor becomes activated. It then sends a reading event each time new data is available.
In case of an error, the error event is sent, reading stops, and the Sensor object becomes idle again. The start() method needs to be called again before it can read further data.
Interfaces based on Sensor
Below is a list of interfaces based on the Sensor interface.
Instance properties
Sensor.activatedRead only-
Returns a boolean value indicating whether the sensor is active.
Sensor.hasReadingRead only-
Returns a boolean value indicating whether the sensor has a reading.
Sensor.timestampRead only-
Returns the timestamp of the latest sensor reading.
Instance methods
Sensor.start()-
Activates one of the sensors based on
Sensor. Sensor.stop()-
Deactivates one of the sensors based on
Sensor.
Events
Specifications
| Specification |
|---|
| Generic Sensor API # the-sensor-interface |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Sensor
|
|
|
|
|
|
|
|
|
|
|
|
|
activate event
|
|
|
|
|
|
|
|
|
|
|
|
|
activated
|
|
|
|
|
|
|
|
|
|
|
|
|
error event
|
|
|
|
|
|
|
|
|
|
|
|
|
hasReading
|
|
|
|
|
|
|
|
|
|
|
|
|
reading event
|
|
|
|
|
|
|
|
|
|
|
|
|
start
|
|
|
|
|
|
|
|
|
|
|
|
|
stop
|
|
|
|
|
|
|
|
|
|
|
|
|
timestamp
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.