dom/webidl/Permissions.webidl

   1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
   4  * You can obtain one at http://mozilla.org/MPL/2.0/.
   5  *
   6  * The origin of this IDL file is
   7  * https://w3c.github.io/permissions/#permissions-interface
   8  */
   9
  10 enum PermissionName {
  11   "geolocation",
  12   "notifications",
  13   "push",
  14   "persistent-storage",
  15   "midi",
  16   "storage-access", // Defined in https://privacycg.github.io/storage-access/#permissions-integration
  17   "screen-wake-lock" // Defined in https://w3c.github.io/screen-wake-lock/
  18 };
  19
  20 [GenerateInit]
  21 dictionary PermissionDescriptor {
  22   required PermissionName name;
  23 };
  24
  25 // https://webaudio.github.io/web-midi-api/#permissions-integration
  26 [GenerateInit]
  27 dictionary MidiPermissionDescriptor : PermissionDescriptor {
  28   boolean sysex = false;
  29 };
  30
  31 // We don't implement `PushPermissionDescriptor` because we use a background
  32 // message quota instead of `userVisibleOnly`.
  33
  34 [Exposed=Window]
  35 interface Permissions {
  36   [NewObject]
  37   Promise<PermissionStatus> query(object permission);
  38
  39   // http://w3c.github.io/permissions/#webdriver-command-set-permission
  40   [ChromeOnly, Throws]
  41   PermissionStatus parseSetParameters(PermissionSetParameters parameters);
  42 };