summaryrefslogtreecommitdiffstats
path: root/dom/webidl/PushSubscription.webidl
diff options
context:
space:
mode:
Diffstat (limited to 'dom/webidl/PushSubscription.webidl')
-rw-r--r--dom/webidl/PushSubscription.webidl58
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();
+};