Accelerometer

Experimental

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The Accelerometer interface of the Sensor APIs provides on each reading the acceleration 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.

If a feature policy blocks the use of a feature, it is because your code is inconsistent with the policies set on your server. This is not something that would ever be shown to a user. See Feature-Policy for implementation instructions.

Constructor

Accelerometer.Accelerometer()
Creates a new Accelerometer object.

Properties

Accelerometer.x Read only
Returns a double containing the acceleration of the device along the device's x axis.
Accelerometer.y Read only
Returns a double containing the acceleration of the device along the device's y axis.
Accelerometer.z Read only
Returns a double containing the acceleration of the device along the device's z axis.

Example

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

let acl = new Accelerometer({frequency: 60});

acl.addEventListener('reading', () => {
  console.log("Acceleration along the X-axis " + acl.x);
  console.log("Acceleration along the Y-axis " + acl.y);
  console.log("Acceleration along the Z-axis " + acl.z);
});

acl.start();

Specifications

Specification Status Comment
Generic Sensor API Candidate Recommendation Defines sensors in general.
Accelerometer
The definition of 'Accelerometer' in that specification.
Candidate Recommendation

Browser compatibility

BCD tables only load in the browser