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_SYSEX,
  14   PROTECTED_MEDIA_IDENTIFIER,
  15 };
  16
  17 // The Permission service provides permission handling capabilities by exposing
  18 // methods to check, request, and revoke permissions. It also allows a client to
  19 // start listening to permission changes.
  20 interface PermissionService {
  21   HasPermission(PermissionName permission, string origin)
  22     => (PermissionStatus status);
  23   RequestPermission(PermissionName permission, string origin, bool user_gesture)
  24     => (PermissionStatus status);
  25   RevokePermission(PermissionName permission, string origin)
  26     => (PermissionStatus status);
  27
  28   // Runs the callback next time there is a permission status change for the
  29   // given { permission, origin }. Callers of this method will have to call it
  30   // again if they want to keep listening to the changes. To prevent race
  31   // conditions, the caller must pass the last known value.
  32   GetNextPermissionChange(PermissionName permission,
  33                           string origin,
  34                           PermissionStatus last_known_status)
  35     => (PermissionStatus status);
  36 };