add Credential Management types (#711)

Author: saschanaz

baselines/dom.generated.d.ts

@@ -250,6 +250,15 @@ interface ConvolverOptions extends AudioNodeOptions {
     disableNormalization?: boolean;
 }
 
+interface CredentialCreationOptions {
+    signal?: AbortSignal;
+}
+
+interface CredentialRequestOptions {
+    mediation?: CredentialMediationRequirement;
+    signal?: AbortSignal;
+}
+
 interface CustomEventInit<T = any> extends EventInit {
     detail?: T;
 }
@@ -3588,6 +3597,28 @@ declare var CountQueuingStrategy: {
     new(options: { highWaterMark: number }): CountQueuingStrategy;
 };
 
+interface Credential {
+    readonly id: string;
+    readonly type: string;
+}
+
+declare var Credential: {
+    prototype: Credential;
+    new(): Credential;
+};
+
+interface CredentialsContainer {
+    create(options?: CredentialCreationOptions): Promise<Credential | null>;
+    get(options?: CredentialRequestOptions): Promise<Credential | null>;
+    preventSilentAccess(): Promise<void>;
+    store(credential: Credential): Promise<Credential>;
+}
+
+declare var CredentialsContainer: {
+    prototype: CredentialsContainer;
+    new(): CredentialsContainer;
+};
+
 /** Basic cryptography features available in the current context. It allows access to a cryptographically strong random number generator and to cryptographic primitives. */
 interface Crypto {
     readonly subtle: SubtleCrypto;
@@ -10669,6 +10700,7 @@ interface Navigator extends NavigatorID, NavigatorOnLine, NavigatorContentUtils,
     readonly authentication: WebAuthentication;
     readonly clipboard: Clipboard;
     readonly cookieEnabled: boolean;
+    readonly credentials: CredentialsContainer;
     readonly doNotTrack: string | null;
     gamepadInputEmulation: GamepadInputEmulationType;
     readonly geolocation: Geolocation;
@@ -18796,6 +18828,7 @@ type ChannelInterpretation = "speakers" | "discrete";
 type ClientTypes = "window" | "worker" | "sharedworker" | "all";
 type CompositeOperation = "replace" | "add" | "accumulate";
 type CompositeOperationOrAuto = "replace" | "add" | "accumulate" | "auto";
+type CredentialMediationRequirement = "silent" | "optional" | "required";
 type DirectionSetting = "" | "rl" | "lr";
 type DisplayCaptureSurfaceType = "monitor" | "window" | "application" | "browser";
 type DistanceModelType = "linear" | "inverse" | "exponential";

inputfiles/idl/Credential Management.widl

@@ -0,0 +1,98 @@
+[Exposed=Window, SecureContext]
+interface Credential {
+  readonly attribute USVString id;
+  readonly attribute DOMString type;
+};
+
+[SecureContext]
+interface mixin CredentialUserData {
+  readonly attribute USVString name;
+  readonly attribute USVString iconURL;
+};
+
+partial interface Navigator {
+  [SecureContext, SameObject] readonly attribute CredentialsContainer credentials;
+};
+
+[Exposed=Window, SecureContext]
+interface CredentialsContainer {
+  Promise<Credential?> get(optional CredentialRequestOptions options);
+  Promise<Credential> store(Credential credential);
+  Promise<Credential?> create(optional CredentialCreationOptions options);
+  Promise<void> preventSilentAccess();
+};
+
+dictionary CredentialData {
+  required USVString id;
+};
+
+dictionary CredentialRequestOptions {
+  CredentialMediationRequirement mediation = "optional";
+  AbortSignal signal;
+};
+
+enum CredentialMediationRequirement {
+  "silent",
+  "optional",
+  "required"
+};
+
+dictionary CredentialCreationOptions {
+  AbortSignal signal;
+};
+
+[Constructor(HTMLFormElement form),
+ Constructor(PasswordCredentialData data),
+ Exposed=Window,
+ SecureContext]
+interface PasswordCredential : Credential {
+  readonly attribute USVString password;
+};
+PasswordCredential includes CredentialUserData;
+
+partial dictionary CredentialRequestOptions {
+  boolean password = false;
+};
+
+dictionary PasswordCredentialData : CredentialData {
+  USVString name;
+  USVString iconURL;
+  required USVString origin;
+  required USVString password;
+};
+
+typedef (PasswordCredentialData or HTMLFormElement) PasswordCredentialInit;
+
+partial dictionary CredentialCreationOptions {
+  PasswordCredentialInit password;
+};
+
+[Constructor(FederatedCredentialInit data),
+ Exposed=Window,
+ SecureContext]
+interface FederatedCredential : Credential {
+  readonly attribute USVString provider;
+  readonly attribute DOMString? protocol;
+};
+FederatedCredential includes CredentialUserData;
+
+dictionary FederatedCredentialRequestOptions {
+  sequence<USVString> providers;
+  sequence<DOMString> protocols;
+};
+
+partial dictionary CredentialRequestOptions {
+  FederatedCredentialRequestOptions federated;
+};
+
+dictionary FederatedCredentialInit : CredentialData {
+  USVString name;
+  USVString iconURL;
+  required USVString origin;
+  required USVString provider;
+  DOMString protocol;
+};
+
+partial dictionary CredentialCreationOptions {
+  FederatedCredentialInit federated;
+};

inputfiles/idlSources.json

@@ -8,6 +8,10 @@
         "title": "Compatibility",
         "deprecated": true
     },
+    {
+        "url": "https://www.w3.org/TR/credential-management-1/",
+        "title": "Credential Management"
+    },
     {
         "url": "https://www.w3.org/TR/css-animations-1/",
         "title": "CSS Animations"

inputfiles/removedTypes.json

@@ -87,6 +87,7 @@
                     }
                 }
             },
+            "FederatedCredential": null,
             "HTMLAreasCollection": null,
             "HTMLBodyElement": {
                 "properties": {
@@ -134,6 +135,7 @@
             "MSPortRange": null,
             "MSStreamReader": null,
             "OverconstrainedErrorEvent": null,
+            "PasswordCredential": null,
             "Screen": {
                 "methods": {
                     "method": {
@@ -282,6 +284,22 @@
     },
     "dictionaries": {
         "dictionary": {
+            "CredentialCreationOptions": {
+                "members": {
+                    "member": {
+                        "federated": null,
+                        "password": null
+                    }
+                }
+            },
+            "CredentialRequestOptions": {
+                "members": {
+                    "member": {
+                        "federated": null,
+                        "password": null
+                    }
+                }
+            },
             "ObjectURLOptions": null,
             "RTCIceGatherOptions": {
                 "members": {