45eb7e06ce
This commit exposes the Permissions API to DOM Workers. It achieves this goal by introducing a thread-safe bridge between `PermissionStatus` and the `PermissionObserver`: the `PermissionStatusSink` object. Actors: - The `PermissionObserver` is a main-thread-only singleton that monitors permission change events and propagates the notification to the right sink objects. - The `PermissionStatus` is the DOM object exposed to the global. It's not thread-safe. - The `PermissionStatusSink` is the new bridge introduced by this commit. The `PermissionStatusSink` lifetime: - This object is kept alive on the current thread by the `PermissionStatus` and on the main thread by the `PermissionObserver`. - The `PermissionStatus` creates the object on its creation thread. When `PermissionStatus` object is released (or disconnected from the owner, it disentangles itself from the `PermissionStatusSink`. The disentangle operation triggers the un-registration procedure from the `PermissionObserver` on the main thread. - A weak `WorkerRef` is used to monitor the worker's lifetime. Permission change notification: - When the `PermissionObserver` is notified for a permission-change event, it notifies all the `PermissionStatusSink`. This happens on the main thread (see `MaybeUpdatedByOnMainThread` and `MaybeUpdatedByNotifyOnlyOnMainThread`). - Using `MozPromise`, the `PermissionStatusSink` computes the permission action (`PermissionChangedOnMainThread`) on the main thread, then informs the parent `PermissionStatus` object on its creation thread. - The `PermissionStatus` object converts the action to the DOM `PermissionState` and dispatches an event. Differential Revision: https://phabricator.services.mozilla.com/D224594
45 lines
1.5 KiB
Plaintext
45 lines
1.5 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*
|
|
* The origin of this IDL file is
|
|
* https://w3c.github.io/permissions/#permissions-interface
|
|
*/
|
|
|
|
enum PermissionName {
|
|
"geolocation",
|
|
"notifications",
|
|
"push",
|
|
"persistent-storage",
|
|
"midi",
|
|
"storage-access", // Defined in https://privacycg.github.io/storage-access/#permissions-integration
|
|
"screen-wake-lock", // Defined in https://w3c.github.io/screen-wake-lock/
|
|
"camera", // Defined in https://www.w3.org/TR/mediacapture-streams/#permissions-integration
|
|
"microphone" // Defined in https://www.w3.org/TR/mediacapture-streams/#permissions-integration
|
|
};
|
|
|
|
[GenerateInit]
|
|
dictionary PermissionDescriptor {
|
|
required PermissionName name;
|
|
};
|
|
|
|
// https://webaudio.github.io/web-midi-api/#permissions-integration
|
|
[GenerateInit]
|
|
dictionary MidiPermissionDescriptor : PermissionDescriptor {
|
|
boolean sysex = false;
|
|
};
|
|
|
|
// We don't implement `PushPermissionDescriptor` because we use a background
|
|
// message quota instead of `userVisibleOnly`.
|
|
|
|
[Exposed=(Window,Worker)]
|
|
interface Permissions {
|
|
[NewObject]
|
|
Promise<PermissionStatus> query(object permission);
|
|
|
|
// http://w3c.github.io/permissions/#webdriver-command-set-permission
|
|
[ChromeOnly, Throws]
|
|
PermissionStatus parseSetParameters(PermissionSetParameters parameters);
|
|
};
|