1---
2category: Browser
3---
4 
5# usePermission
6 
7Reactive [Permissions API](https://developer.mozilla.org/en-US/docs/Web/API/Permissions_API). The Permissions API provides the tools to allow developers to implement a better user experience as far as permissions are concerned.
8 
9## Usage
10 
11```ts
12import { usePermission } from '@vueuse/core'
13 
14const microphoneAccess = usePermission('microphone')
15```
16 
17## Type Declarations
18 
19```ts
20type DescriptorNamePolyfill =
21  | "accelerometer"
22  | "accessibility-events"
23  | "ambient-light-sensor"
24  | "background-sync"
25  | "camera"
26  | "clipboard-read"
27  | "clipboard-write"
28  | "gyroscope"
29  | "magnetometer"
30  | "microphone"
31  | "notifications"
32  | "payment-handler"
33  | "persistent-storage"
34  | "push"
35  | "speaker"
36  | "local-fonts"
37export type GeneralPermissionDescriptor =
38  | PermissionDescriptor
39  | {
40      name: DescriptorNamePolyfill
41    }
42export interface UsePermissionOptions<
43  Controls extends boolean,
44> extends ConfigurableNavigator {
45  /**
46   * Expose more controls
47   *
48   * @default false
49   */
50  controls?: Controls
51}
52export type UsePermissionReturn = Readonly<
53  ShallowRef<PermissionState | undefined>
54>
55export interface UsePermissionReturnWithControls extends Supportable {
56  state: UsePermissionReturn
57  query: () => Promise<PermissionStatus | undefined>
58}
59/**
60 * Reactive Permissions API.
61 *
62 * @see https://vueuse.org/usePermission
63 *
64 * @__NO_SIDE_EFFECTS__
65 */
66export declare function usePermission(
67  permissionDesc:
68    | GeneralPermissionDescriptor
69    | GeneralPermissionDescriptor["name"],
70  options?: UsePermissionOptions<false>,
71): UsePermissionReturn
72export declare function usePermission(
73  permissionDesc:
74    | GeneralPermissionDescriptor
75    | GeneralPermissionDescriptor["name"],
76  options: UsePermissionOptions<true>,
77): UsePermissionReturnWithControls
78```
79