content/common/permission_service.mojom

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 module content;
   6
   7 import "content/public/common/permission_status.mojom";
   8
   9 enum PermissionName {
  10   GEOLOCATION,
  11   NOTIFICATIONS,
  12   PUSH_NOTIFICATIONS,
  13   MIDI,
  14   MIDI_SYSEX,
  15   PROTECTED_MEDIA_IDENTIFIER,
  16   DURABLE_STORAGE,
  17 };
  18
  19 // The Permission service provides permission handling capabilities by exposing
  20 // methods to check, request, and revoke permissions. It also allows a client to
  21 // start listening to permission changes.
  22 interface PermissionService {
  23   HasPermission(PermissionName permission, string origin)
  24     => (PermissionStatus status);
  25   RequestPermission(PermissionName permission, string origin, bool user_gesture)
  26     => (PermissionStatus status);
  27   RevokePermission(PermissionName permission, string origin)
  28     => (PermissionStatus status);
  29
  30   // Runs the callback next time there is a permission status change for the
  31   // given { permission, origin }. Callers of this method will have to call it
  32   // again if they want to keep listening to the changes. To prevent race
  33   // conditions, the caller must pass the last known value.
  34   GetNextPermissionChange(PermissionName permission,
  35                           string origin,
  36                           PermissionStatus last_known_status)
  37     => (PermissionStatus status);
  38 };