Web/API/Gyroscope

The Gyroscope interface of the Sensor APIs provides on each reading the angular velocity of the device along all three axes.

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

If a feature policy blocks 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

Gyroscope.Gyroscope()

Creates a new Gyroscope object.

Properties

Gyroscope.x Read only

Returns a double, containing the angular velocity of the device along the device's x axis.

Gyroscope.y Read only

Returns a double, containing the angular velocity of the device along the device's y axis.

Gyroscope.z Read only

Returns a double, containing the angular velocity of the device along the device's z axis.

Example

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

let gyroscope = new Gyroscope({frequency: 60});

gyroscope.addEventListener('reading', e => {
  console.log("Angular velocity along the X-axis " + gyroscope.x);
  console.log("Angular velocity along the Y-axis " + gyroscope.y);
  console.log("Angular velocity along the Z-axis " + gyroscope.z);
});
gyroscope.start();

Specifications

Specification	Status	Comment
Generic Sensor API	Candidate Recommendation	Defines sensors in general.
GyroscopeThe definition of 'Gyroscope' in that specification.	Candidate Recommendation	Initial definition.

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Gyroscope	Chrome Full support 67	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 54	Safari No support No	WebView Android Full support 67	Chrome Android Full support 67	Firefox Android No support No	Opera Android Full support 48	Safari iOS No support No	Samsung Internet Android Full support 9.0
Gyroscope() constructor	Chrome Full support 67	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 54	Safari No support No	WebView Android Full support 67	Chrome Android Full support 67	Firefox Android No support No	Opera Android Full support 48	Safari iOS No support No	Samsung Internet Android Full support 9.0
x	Chrome Full support 67	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 54	Safari No support No	WebView Android Full support 67	Chrome Android Full support 67	Firefox Android No support No	Opera Android Full support 48	Safari iOS No support No	Samsung Internet Android Full support 9.0
y	Chrome Full support 67	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 54	Safari No support No	WebView Android Full support 67	Chrome Android Full support 67	Firefox Android No support No	Opera Android Full support 48	Safari iOS No support No	Samsung Internet Android Full support 9.0
z	Chrome Full support 67	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 54	Safari No support No	WebView Android Full support 67	Chrome Android Full support 67	Firefox Android No support No	Opera Android Full support 48	Safari iOS No support No	Samsung Internet Android Full support 9.0

Legend

Full support  

Full support

No support  

No support

Gyroscope by Mozilla Contributors is licensed under CC-BY-SA 2.5.