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
36 lines
1.2 KiB
C++
36 lines
1.2 KiB
C++
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
|
|
/* 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/. */
|
|
|
|
#ifndef mozilla_dom_PermissionUtils_h_
|
|
#define mozilla_dom_PermissionUtils_h_
|
|
|
|
#include "mozilla/dom/PermissionsBinding.h"
|
|
#include "mozilla/dom/PermissionStatusBinding.h"
|
|
#include "mozilla/dom/WorkerPrivate.h"
|
|
#include "mozilla/Maybe.h"
|
|
|
|
namespace mozilla::dom {
|
|
class Document;
|
|
|
|
const nsLiteralCString& PermissionNameToType(PermissionName aName);
|
|
|
|
/**
|
|
* Returns the permission name given a permission type.
|
|
*
|
|
* Note: the "midi" permission is implemented with two internal permissions
|
|
* ("midi" and "midi-sysex"). For this reason, when we pass "midi-sysex" to
|
|
* this function, it unconditionally returns the "midi" permission name,
|
|
* because that's the only public permission name.
|
|
*/
|
|
Maybe<PermissionName> TypeToPermissionName(const nsACString& aType);
|
|
|
|
PermissionState ActionToPermissionState(uint32_t aAction, PermissionName aName,
|
|
nsIGlobalObject* aGlobal);
|
|
|
|
} // namespace mozilla::dom
|
|
|
|
#endif
|