;
```
```ts
import {requestNotifications} from 'react-native-permissions';
requestNotifications(['alert', 'sound']).then(({status, settings}) => {
// β¦
});
```
#### checkMultiple
Check multiples permissions in parallel.
> [!IMPORTANT]
> On Android, the `checkMultiple` function will never return a `blocked` status. You need to call `requestMultiple` to obtain that information.
```ts
function checkMultiple(
permissions: P,
): Promise>;
```
```ts
import {checkMultiple, PERMISSIONS} from 'react-native-permissions';
checkMultiple([PERMISSIONS.IOS.CAMERA, PERMISSIONS.IOS.FACE_ID]).then((statuses) => {
console.log('Camera', statuses[PERMISSIONS.IOS.CAMERA]);
console.log('FaceID', statuses[PERMISSIONS.IOS.FACE_ID]);
});
```
#### requestMultiple
Request multiple permissions in sequence.
```ts
function requestMultiple(
permissions: P,
): Promise>;
```
```ts
import {requestMultiple, PERMISSIONS} from 'react-native-permissions';
requestMultiple([PERMISSIONS.IOS.CAMERA, PERMISSIONS.IOS.FACE_ID]).then((statuses) => {
console.log('Camera', statuses[PERMISSIONS.IOS.CAMERA]);
console.log('FaceID', statuses[PERMISSIONS.IOS.FACE_ID]);
});
```
#### openSettings
Open application / alarms / notifications / fullscreen settings (default to `application`).
> [!NOTE]
>
> - `notifications` settings are only available on Android 8+ and iOS 15.4+
> - `alarms` settings are only available on Android 12+
> - `fullscreen` settings are only available on Android 14+
> - If a choice is not available, it fallbacks to `application` settings
```ts
function openSettings(
type?: 'application' | 'alarms' | 'fullscreen' | 'notifications',
): Promise;
```
```ts
import {openSettings} from 'react-native-permissions';
openSettings('application').catch(() => console.warn('Cannot open app settings'));
```
#### canScheduleExactAlarms (Android)
Check if your app can schedule exact alarms.
```ts
function canScheduleExactAlarms(): Promise;
```
```ts
import {canScheduleExactAlarms} from 'react-native-permissions';
canScheduleExactAlarms()
.then((value) => console.log(`Can schedule exact alarms: ${value}`))
.catch(() => console.warn('Cannot check exact alarms scheduling setting'));
```
#### canUseFullScreenIntent (Android)
Check if your app can use full screen intent.
```ts
function canUseFullScreenIntent(): Promise;
```
```ts
import {canUseFullScreenIntent} from 'react-native-permissions';
canUseFullScreenIntent()
.then((value) => console.log(`Can use full screen intent: ${value}`))
.catch(() => console.warn('Cannot check full screen intent using setting'));
```
#### openPhotoPicker (iOS 14+)
Open a picker to update the photo selection when `PhotoLibrary` permission is `limited`. This will reject if unsupported or if full permission is already `granted`.
```ts
function openPhotoPicker(): Promise;
```
```ts
import {openPhotoPicker} from 'react-native-permissions';
openPhotoPicker().catch(() => console.warn('Cannot open photo library picker'));
```
#### checkLocationAccuracy (iOS 14+)
When `LocationAlways` or `LocationWhenInUse` is `granted`, allow checking if the user share his precise location.
```ts
function checkLocationAccuracy(): Promise;
```
```ts
import {checkLocationAccuracy} from 'react-native-permissions';
checkLocationAccuracy()
.then((accuracy) => console.log(`Location accuracy is: ${accuracy}`))
.catch(() => console.warn('Cannot check location accuracy'));
```
#### requestLocationAccuracy (iOS 14+)
When `LocationAlways` or `LocationWhenInUse` is `granted`, allow requesting the user for his precise location. Will resolve immediately if `full` accuracy is already authorized.
```ts
function requestLocationAccuracy(options: LocationAccuracyOptions): Promise;
```
```js
import {requestLocationAccuracy} from 'react-native-permissions';
requestLocationAccuracy({purposeKey: 'YOUR-PURPOSE-KEY'})
.then((accuracy) => console.log(`Location accuracy is: ${accuracy}`))
.catch(() => console.warn('Cannot request location accuracy'));
```
### About iOS `LOCATION_ALWAYS` permission
On iOS, background location permission can be requested in two different ways ([Apple Developer Docs π](https://developer.apple.com/documentation/corelocation/cllocationmanager/1620551-requestalwaysauthorization#3578736)).
#### Request `LOCATION_ALWAYS` after `LOCATION_WHEN_IN_USE`
If the user chooses _Allow While Using App_ when calling `request(PERMISSIONS.IOS.LOCATION_WHEN_IN_USE)`, then calling `request(PERMISSIONS.IOS.LOCATION_ALWAYS)` afterward will immediately prompt the user:
| Option | `LOCATION_ALWAYS` status | `LOCATION_WHEN_IN_USE` status |
| ---------------------- | ------------------------ | ----------------------------- |
| Keep Only While Using | `RESULTS.BLOCKED` | `RESULTS.GRANTED` |
| Change to Always Allow | `RESULTS.GRANTED` | `RESULTS.GRANTED` |
---
#### Request `LOCATION_ALWAYS` directly
The user is immediately prompted:
| Option | `LOCATION_ALWAYS` status | `LOCATION_WHEN_IN_USE` status |
| --------------------- | ------------------------ | ----------------------------- |
| Allow Once | `RESULTS.BLOCKED` | `RESULTS.GRANTED` |
| Allow While Using App | `RESULTS.GRANTED` | `RESULTS.GRANTED` |
| Donβt Allow | `RESULTS.BLOCKED` | `RESULTS.BLOCKED` |
In this scenario, if the user chooses `Allow While Using App`, they will see `While Using` in the app settings and will later be informed that your app is using their location in background with the option to confirm / change it:
### Testing with Jest
If you don't already have a Jest setup file configured, please add the following to your Jest configuration file and create the new `jest.setup.js` file in project root:
```js
setupFiles: ['/jest.setup.js'];
```
You can then add the following line to that setup file to mock the `NativeModule.RNPermissions`:
```js
jest.mock('react-native-permissions', () => require('react-native-permissions/mock'));
```
## Sponsors
This module is provided **as is**, I work on it in my free time.
If you or your company uses it in a production app, consider sponsoring this project π°. You also can contact me for **premium** enterprise support: help with issues, prioritize bugfixes, feature requests, etc.
