GravitySensor

The GravitySensor interface of the Sensor APIs provides on each reading the gravity applied to the device along all three axes.

To use this sensor, the user must grant permission to the 'accelerometer' device sensor through the Permissions API.

Constructor

GravitySensor()

Creates a new GravitySensor object.

Properties

Inherits properties from its ancestor, Accelerometer.

Example

Gravity is typically read in the Sensor.onreading event callback. In the example below this occurs sixty times a second.

let gravitySensor = new GravitySensor({frequency: 60});

gravitySensor.addEventListener("reading", e => {
  console.log(`Gravity along the X-axis ${gravitySensor.x}`);
  console.log(`Gravity along the Y-axis ${gravitySensor.y}`);
  console.log(`Gravity along the Z-axis ${gravitySensor.z}`);
});

gravitySensor.start();

Specifications

Specification
Accelerometer
# gravitysensor-interface

Browser compatibility

BCD tables only load in the browser