hs.permissions

Check if the app has Accessibility permission

hs.permissions.checkAccessibility() -> boolean

console.log(hs.permissions.checkAccessibility())

Request Accessibility permission (shows system dialog if not granted)

hs.permissions.requestAccessibility() -> None

hs.permissions.requestAccessibility()

Check if the app has Screen Recording permission

hs.permissions.checkScreenRecording() -> boolean

console.log(hs.permissions.checkScreenRecording())

Request Screen Recording permission

hs.permissions.requestScreenRecording() -> None

hs.permissions.requestScreenRecording()

Check if the app has Camera permission

hs.permissions.checkCamera() -> boolean

console.log(hs.permissions.checkCamera())

Request Camera permission (shows system dialog if not granted)

hs.permissions.requestCamera() -> Promise<boolean>

hs.permissions.requestCamera().then(granted => console.log(granted))

Check if the app has Microphone permission

hs.permissions.checkMicrophone() -> boolean

console.log(hs.permissions.checkMicrophone())

Request Microphone permission (shows system dialog if not granted)

hs.permissions.requestMicrophone() -> Promise<boolean>

hs.permissions.requestMicrophone().then(granted => console.log(granted))

Check if the app has permission to display notifications. The result is cached from the last request or check; the cache is refreshed asynchronously, so the very first call in a session may return `false` before the cached value is populated. Use `requestNotifications()` on first launch to ensure the result is accurate.

hs.permissions.checkNotifications() -> boolean

console.log(hs.permissions.checkNotifications())

Request notification permission (shows the system dialog if the user has not yet decided). It is safe to call this on every launch — the dialog only appears once; subsequent calls resolve immediately with the previously granted or denied state.

hs.permissions.requestNotifications() -> Promise<boolean>

hs.permissions.requestNotifications().then(granted => console.log(granted))

Check if the app has Location permission.

hs.permissions.checkLocation() -> boolean

console.log(hs.permissions.checkLocation())

Request Location permission (shows the system dialog if the user has not yet decided).

hs.permissions.requestLocation() -> Promise<boolean>

hs.permissions.requestLocation().then(granted => {
    if (granted) console.log(hs.location.get())
})