コンテンツへスキップ コンテンツへスキップ

usePermission

カテゴリ
エクスポートサイズ
759 B
最終更新日
先週
関連

リアクティブなPermissions API。Permissions APIは、開発者がパーミッションに関してより良いユーザーエクスペリエンスを実装するためのツールを提供します。

デモ

使用方法

JavaScript
import { usePermission } from '@vueuse/core'

const microphoneAccess = usePermission('microphone')

型定義

型定義を表示
TypeScript
type DescriptorNamePolyfill =
  | "accelerometer"
  | "accessibility-events"
  | "ambient-light-sensor"
  | "background-sync"
  | "camera"
  | "clipboard-read"
  | "clipboard-write"
  | "gyroscope"
  | "magnetometer"
  | "microphone"
  | "notifications"
  | "payment-handler"
  | "persistent-storage"
  | "push"
  | "speaker"
  | "local-fonts"
export type GeneralPermissionDescriptor =
  | PermissionDescriptor
  | {
      name: DescriptorNamePolyfill
    }
export interface UsePermissionOptions<Controls extends boolean>
  extends ConfigurableNavigator {
  /**
   * Expose more controls
   *
   * @default false
   */
  controls?: Controls
}
export type UsePermissionReturn = Readonly<Ref<PermissionState | undefined>>
export interface UsePermissionReturnWithControls {
  state: UsePermissionReturn
  isSupported: Ref<boolean>
  query: () => Promise<PermissionStatus | undefined>
}
/**
 * Reactive Permissions API.
 *
 * @see https://vueuse.dokyumento.jp/usePermission
 */
export declare function usePermission(
  permissionDesc:
    | GeneralPermissionDescriptor
    | GeneralPermissionDescriptor["name"],
  options?: UsePermissionOptions<false>,
): UsePermissionReturn
export declare function usePermission(
  permissionDesc:
    | GeneralPermissionDescriptor
    | GeneralPermissionDescriptor["name"],
  options: UsePermissionOptions<true>,
): UsePermissionReturnWithControls

ソースコード

ソースコードデモドキュメント

コントリビューター

Anthony Fu
Fernando Fernández
Antério Vieira
Anthony Fu
sean
Jelf
Guille
Alex Kozack
Nurettin Kaya

変更ログ

v12.0.0-beta.1 2024/11/21
0a9ed - feat!: Vue 2サポートの削除、バンドルの最適化、クリーンアップ (#4349)
v11.0.2 2024/08/24
2aaa1 - fix: 状態設定 (#4167)
v11.0.1 2024/08/19
63a22 - 修正: メモリリークを修正 (#4157)
v11.0.0-beta.2 2024年7月17日
5f584 - 新機能: local-fonts パーミッションを追加 (#4098)

MITライセンスの下でリリースされています。