RuntimePermissions.jsm

Summary

Contains the RuntimePermissions object, which can be used to check whether one or more runtime permissions have been granted to Firefox for Android, and to ask for them if they have not.

Import the RuntimePermissions module with code like this:

Components.utils.import("resource://gre/modules/RuntimePermissions.jsm");

Example

This example asks for the CAMERA and RECORD_AUDIO permissions, and logs the result.

Components.utils.import("resource://gre/modules/RuntimePermissions.jsm");

var permitted = RuntimePermissions.waitForPermissions([
    RuntimePermissions.CAMERA,
    RuntimePermissions.RECORD_AUDIO
  ]);

permitted.then((permissionGranted) => {
  console.log(permissionGranted);
});

Methods

waitForPermissions()

waitForPermissions(permission);

Checks whether the given permission(s) have been granted to Firefox for Android. If any of them have not, prompts the user for the permissions which have not been granted.

Note that add-ons can only request permissions that are defined in the manifest for Firefox for Android. Those permissions are defined as constants in the RuntimePermissions object.

Arguments

permission

A single permission, or an array of permissions, to check/request. The permissions are specified using the constants defined in the RuntimePermissions object.

Return value

A Promise, which resolves to true if all requested permissions were granted, and false otherwise.

Constants

Pass these constants into waitForPermission().

CAMERA

The name of the Android CAMERA permission.

RECORD_AUDIO

The name of the Android RECORD_AUDIO permission.

WRITE_EXTERNAL_STORAGE

The name of the Android WRITE_EXTERNAL_STORAGE permission.