diff options
Diffstat (limited to 'dom/webidl/PushSubscription.webidl')
-rw-r--r-- | dom/webidl/PushSubscription.webidl | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/dom/webidl/PushSubscription.webidl b/dom/webidl/PushSubscription.webidl new file mode 100644 index 0000000000..f47a18b2f4 --- /dev/null +++ b/dom/webidl/PushSubscription.webidl @@ -0,0 +1,58 @@ +/* -*- 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/push-api/ +*/ + +interface Principal; + +enum PushEncryptionKeyName +{ + "p256dh", + "auth" +}; + +dictionary PushSubscriptionKeys +{ + ByteString p256dh; + ByteString auth; +}; + +dictionary PushSubscriptionJSON +{ + USVString endpoint; + // FIXME: bug 1493860: should this "= {}" be here? For that matter, this + // PushSubscriptionKeys thing is not even in the spec; "keys" is a record + // there. + PushSubscriptionKeys keys = {}; +}; + +dictionary PushSubscriptionInit +{ + required USVString endpoint; + required USVString scope; + ArrayBuffer? p256dhKey; + ArrayBuffer? authSecret; + BufferSource? appServerKey; +}; + +[Exposed=(Window,Worker), Pref="dom.push.enabled"] +interface PushSubscription +{ + [Throws, ChromeOnly] + constructor(PushSubscriptionInit initDict); + + readonly attribute USVString endpoint; + readonly attribute PushSubscriptionOptions options; + [Throws] + ArrayBuffer? getKey(PushEncryptionKeyName name); + [Throws, UseCounter] + Promise<boolean> unsubscribe(); + + // Implements the custom serializer specified in Push API, section 9. + [Throws] + PushSubscriptionJSON toJSON(); +}; |