dom/webidl/PushSubscription.webidl

   1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
   4 * You can obtain one at http://mozilla.org/MPL/2.0/.
   5 *
   6 * The origin of this IDL file is
   7 * https://w3c.github.io/push-api/
   8 */
   9
  10 interface Principal;
  11
  12 enum PushEncryptionKeyName
  13 {
  14   "p256dh",
  15   "auth"
  16 };
  17
  18 dictionary PushSubscriptionKeys
  19 {
  20   ByteString p256dh;
  21   ByteString auth;
  22 };
  23
  24 dictionary PushSubscriptionJSON
  25 {
  26   USVString endpoint;
  27   // FIXME: bug 1493860: should this "= {}" be here?  For that matter, this
  28   // PushSubscriptionKeys thing is not even in the spec; "keys" is a record
  29   // there.
  30   PushSubscriptionKeys keys = {};
  31 };
  32
  33 dictionary PushSubscriptionInit
  34 {
  35   required USVString endpoint;
  36   required USVString scope;
  37   ArrayBuffer? p256dhKey;
  38   ArrayBuffer? authSecret;
  39   BufferSource? appServerKey;
  40 };
  41
  42 [Exposed=(Window,Worker), Pref="dom.push.enabled"]
  43 interface PushSubscription
  44 {
  45   [Throws, ChromeOnly]
  46   constructor(PushSubscriptionInit initDict);
  47
  48   readonly attribute USVString endpoint;
  49   readonly attribute PushSubscriptionOptions options;
  50   [Throws]
  51   ArrayBuffer? getKey(PushEncryptionKeyName name);
  52   [Throws, UseCounter]
  53   Promise<boolean> unsubscribe();
  54
  55   // Implements the custom serializer specified in Push API, section 9.
  56   [Throws]
  57   PushSubscriptionJSON toJSON();
  58 };