DeviceMotionEvent: requestPermission() static method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Device Orientation Events")}}{{securecontext_header}}
The **requestPermission()** static method of the {{domxref("DeviceMotionEvent")}} interface requests the user's permission to access device motion data from the accelerometer and gyroscope sensors. This method requires {{Glossary("transient activation")}}, meaning that it must be triggered by a UI event such as a button click.
Syntax
DeviceMotionEvent.requestPermission()Parameters
None.
Return value
A {{jsxref("Promise")}} that resolves with a string which is either "granted" or "denied".
Exceptions
The returned promise rejects with the following exceptions:
NotAllowedError{{domxref("DOMException")}}- : The permission state is
"prompt"and the calling function does not have {{Glossary("transient activation")}}.
Security
Transient user activation is required. The user has to interact with the page or a UI element in order for this feature to work.
Examples
Requesting device motion permission on click
document.querySelector("button").addEventListener("click", async () => {
if (typeof DeviceMotionEvent.requestPermission !== "function") {
// The feature is not available, or does not need permission.
return;
}
const permission = await DeviceMotionEvent.requestPermission();
if (permission === "granted") {
window.addEventListener("devicemotion", (event) => {
console.log(`Acceleration X: ${event.acceleration.x}`);
console.log(`Acceleration Y: ${event.acceleration.y}`);
console.log(`Acceleration Z: ${event.acceleration.z}`);
});
}
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("DeviceMotionEvent")}}
- {{domxref("DeviceOrientationEvent.requestPermission_static", "DeviceOrientationEvent.requestPermission()")}}
- {{domxref("Window.devicemotion_event", "devicemotion")}} event
- {{domxref("Device orientation events/Detecting device orientation", "Detecting device orientation", "", "nocode")}}