1. Introduction
This document specifies a function to relinquish permissions that are no longer needed.
2. Revoke API
partial interface Permissions {Promise <PermissionStatus >revoke (object ); };
permissionDesc
When the revoke(permissionDesc)
method is
invoked, the UA MUST run the following algorithm, passing the parameter permissionDesc:
-
Let rootDesc be the object permissionDesc refers to, converted to an IDL value of type
PermissionDescriptor
. If this throws an exception, return a promise rejected with that exception and abort these steps. -
Let typedDescriptor be the object permissionDesc refers to, converted to an IDL value of
rootDesc.
’s permission descriptor type. If this throws an exception, return a promise rejected with that exception and abort these steps.name
-
Return a new promise promise and run the following steps in parallel:
-
The UA now has new information that the user intends to revoke permission to use the feature described by typedDescriptor.
-
If any tasks run due to Reacting to users revoking permission, wait for them to finish.
-
Queue a task to resolve promise with the result of
query(permissionDesc)
.This should pass typedDescriptor directly into the parallel part of query().
-
3. Security Considerations
No security considerations have been identified.
4. Privacy Considerations
No privacy considerations have been identified.