Cookie Change Events

dictionary CookieInit {
    USVString name;
    DOMString expires;
    long long maxAge;
    USVString domain;
    USVString path;
    boolean secure;
    required USVString value;
};

A CookieInit is a generic object that can be used to define a new cookie. You can set the following fields:

• name is the key value in the key value pairing for cookies. Because of backwards compatibility, it is not required.
• expires is an optional string value of a RFC 1123 Date, pursuant to RFC 6265§4.1.1
• maxAge is an optional numeric value that, when specified, defines the number of seconds until the cookie expires, starting when the value is set, pursuant to RFC 6265§5.2.2
• domain is an optional attribute that specifies what domain the cookie will be sent to, pursuant to RFC 6265§5.2.3.
• path is an optional attribute that will only give access to the cookie if the requested resource matches the specified path, pursuant to RFC 6265§5.2.4.
• secure is an optional boolean attribute that, when true, signals that the cookie can only be transmitted over "secure" protocols, as defined by the user agent. pursuant to RFC 6265§5.4, subsection 1
• value is the only required attribute. It is a string, as defined as a cookie-value in RFC 6265

[Constructor((CookieInit or USVString) cookie), Exposed=Window]
interface Cookie {
    readonly attribute USVString name;
    attribute DOMString expires;
    attribute USVString value;
    readonly attribute USVString domain;
    readonly attribute USVString path;
    readonly attribute boolean secure;
    stringifier USVString ();
};

For backwards compatibility, the stringifier for a Cookie returns the serialized version of the object in a format that is consistent with how a cookie is returned on the original document.cookie. The Cookie can be set via a CookieInit object, or via the same serialized string.

[Exposed=Window]
interface CookieJar : EventTarget {
    stringifier attribute USVString value;
    maplike<USVString, Cookie>;
    attribute EventHandler onchange;
    setter USVString ((Cookie or USVString) cookie);
};

CookieJar represents all of the current cookies set on a domain, and is available via `document.cookie`.

• value is a seralized version of the current valid cookies, in the same format as the historical value returns from `document.cookie`.
• onchange is an event handler to listen for a `change` event (see: §3 the Change event)

partial interface Document {
    [PutForwards=value] attribute CookieJar cookie;
};

For backwards compatibility, a CookieJar, when accessed as document.cookie, returns the serialized string version of a Cookie. However, a iterator is also defined, which returns the object form of Cookie on each iteration.

let cookie = document.cookie
typeof cookie === 'string' // returns true

for (let cookie of document.cookie) {
  if (cookie.name === 'cookieIWantToDelete') {
    doucment.cookie.delete(cookie)
  }
}

3. the Change event

enum ChangeCause {
  "explicit",
  "evicted",
  "expired",
  "expired-overwrite",
  "overwrite",
  "created"
};

[Constructor(DOMString type, optional CookieChangeEventInit eventInitDict), Exposed=(Window)]
interface CookieChangeEventInit : Event {
    attribute boolean removed;
    attribute ChangeCause cause;
    attribute Cookie cookie;
};

interface CookieChangeEvent : Event {
  readonly attribute boolean removed;
  readonly attribute ChangeCause cause;
  readonly attribute Cookie cookie;
};