;\n```\n\n```ts\nimport {requestNotifications} from 'react-native-permissions';\n\nrequestNotifications(['alert', 'sound']).then(({status, settings}) => {\n // β¦\n});\n```\n\n#### checkMultiple\n\nCheck multiples permissions in parallel.\n\n> [!IMPORTANT] \n> On Android, the `checkMultiple` function will never return a `blocked` status. You need to call `requestMultiple` to obtain that information.\n\n```ts\nfunction checkMultiple(\n permissions: P,\n): Promise>;\n```\n\n```ts\nimport {checkMultiple, PERMISSIONS} from 'react-native-permissions';\n\ncheckMultiple([PERMISSIONS.IOS.CAMERA, PERMISSIONS.IOS.FACE_ID]).then((statuses) => {\n console.log('Camera', statuses[PERMISSIONS.IOS.CAMERA]);\n console.log('FaceID', statuses[PERMISSIONS.IOS.FACE_ID]);\n});\n```\n\n#### requestMultiple\n\nRequest multiple permissions in sequence.\n\n```ts\nfunction requestMultiple(\n permissions: P,\n): Promise>;\n```\n\n```ts\nimport {requestMultiple, PERMISSIONS} from 'react-native-permissions';\n\nrequestMultiple([PERMISSIONS.IOS.CAMERA, PERMISSIONS.IOS.FACE_ID]).then((statuses) => {\n console.log('Camera', statuses[PERMISSIONS.IOS.CAMERA]);\n console.log('FaceID', statuses[PERMISSIONS.IOS.FACE_ID]);\n});\n```\n\n#### openSettings\n\nOpen application / alarms / notifications / fullscreen settings (default to `application`).\n\n> [!NOTE]\n>\n> - `notifications` settings are only available on Android 8+ and iOS 15.4+\n> - `alarms` settings are only available on Android 12+\n> - `fullscreen` settings are only available on Android 14+\n> - If a choice is not available, it fallbacks to `application` settings\n\n```ts\nfunction openSettings(\n type?: 'application' | 'alarms' | 'fullscreen' | 'notifications',\n): Promise;\n```\n\n```ts\nimport {openSettings} from 'react-native-permissions';\n\nopenSettings('application').catch(() => console.warn('Cannot open app settings'));\n```\n\n#### canScheduleExactAlarms (Android)\n\nCheck if your app can schedule exact alarms.\n\n```ts\nfunction canScheduleExactAlarms(): Promise;\n```\n\n```ts\nimport {canScheduleExactAlarms} from 'react-native-permissions';\n\ncanScheduleExactAlarms()\n .then((value) => console.log(`Can schedule exact alarms: ${value}`))\n .catch(() => console.warn('Cannot check exact alarms scheduling setting'));\n```\n\n#### canUseFullScreenIntent (Android)\n\nCheck if your app can use full screen intent.\n\n```ts\nfunction canUseFullScreenIntent(): Promise;\n```\n\n```ts\nimport {canUseFullScreenIntent} from 'react-native-permissions';\n\ncanUseFullScreenIntent()\n .then((value) => console.log(`Can use full screen intent: ${value}`))\n .catch(() => console.warn('Cannot check full screen intent using setting'));\n```\n\n#### openContactPicker (iOS 18+)\n\nOpen a picker to update the contacts selection when `Contacts` permission is `limited`. This will reject if unsupported or if full permission is already `granted`.\n\n```ts\nfunction openContactPicker(): Promise;\n```\n\n```ts\nimport {openContactPicker} from 'react-native-permissions';\n\nopenContactPicker().catch(() => console.warn('Cannot open contact access picker'));\n```\n\n#### openPhotoPicker (iOS 14+)\n\nOpen a picker to update the photo selection when `PhotoLibrary` permission is `limited`. This will reject if unsupported or if full permission is already `granted`.\n\n```ts\nfunction openPhotoPicker(): Promise;\n```\n\n```ts\nimport {openPhotoPicker} from 'react-native-permissions';\n\nopenPhotoPicker().catch(() => console.warn('Cannot open photo library picker'));\n```\n\n#### checkLocationAccuracy (iOS 14+)\n\nWhen `LocationAlways` or `LocationWhenInUse` is `granted`, allow checking if the user share his precise location.\n\n```ts\nfunction checkLocationAccuracy(): Promise;\n```\n\n```ts\nimport {checkLocationAccuracy} from 'react-native-permissions';\n\ncheckLocationAccuracy()\n .then((accuracy) => console.log(`Location accuracy is: ${accuracy}`))\n .catch(() => console.warn('Cannot check location accuracy'));\n```\n\n#### requestLocationAccuracy (iOS 14+)\n\nWhen `LocationAlways` or `LocationWhenInUse` is `granted`, allow requesting the user for his precise location. Will resolve immediately if `full` accuracy is already authorized.\n\n```ts\nfunction requestLocationAccuracy(options: LocationAccuracyOptions): Promise;\n```\n\n```js\nimport {requestLocationAccuracy} from 'react-native-permissions';\n\nrequestLocationAccuracy({purposeKey: 'YOUR-PURPOSE-KEY'})\n .then((accuracy) => console.log(`Location accuracy is: ${accuracy}`))\n .catch(() => console.warn('Cannot request location accuracy'));\n```\n\n### About iOS `LOCATION_ALWAYS` permission\n\nOn iOS, background location permission can be requested in two different ways ([Apple Developer Docs π](https://developer.apple.com/documentation/corelocation/cllocationmanager/1620551-requestalwaysauthorization#3578736)).\n\n#### Request `LOCATION_ALWAYS` after `LOCATION_WHEN_IN_USE`\n\nIf 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:\n\n![\"Location](\"./docs/location_always_upgrade.png\")
\n\n| Option | `LOCATION_ALWAYS` status | `LOCATION_WHEN_IN_USE` status |\n| ---------------------- | ------------------------ | ----------------------------- |\n| Keep Only While Using | `RESULTS.BLOCKED` | `RESULTS.GRANTED` |\n| Change to Always Allow | `RESULTS.GRANTED` | `RESULTS.GRANTED` |\n\n---\n\n#### Request `LOCATION_ALWAYS` directly\n\nThe user is immediately prompted:\n\n![\"Location](\"./docs/location_always_first_prompt.png\")
\n\n| Option | `LOCATION_ALWAYS` status | `LOCATION_WHEN_IN_USE` status |\n| --------------------- | ------------------------ | ----------------------------- |\n| Allow Once | `RESULTS.BLOCKED` | `RESULTS.GRANTED` |\n| Allow While Using App | `RESULTS.GRANTED` | `RESULTS.GRANTED` |\n| Donβt Allow | `RESULTS.BLOCKED` | `RESULTS.BLOCKED` |\n\nIn 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:\n\n![\"Location](\"./docs/location_always_second_prompt.png\")
\n\n### Testing with Jest\n\nIf 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:\n\n```js\nsetupFiles: ['/jest.setup.js'];\n```\n\nYou can then add the following line to that setup file to mock the `NativeModule.RNPermissions`:\n\n```js\njest.mock('react-native-permissions', () => require('react-native-permissions/mock'));\n```\n\n## Sponsors\n\nThis module is provided **as is**, I work on it in my free time.\n\nIf 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.\n\n![\"Sponsors](\"https://raw.githubusercontent.com/zoontek/sponsors/main/sponsorkit/sponsors.svg\")
\n","readmeFilename":"README.md","users":{"xudaolong":true,"elena_zhuk":true}}