devtools-protocol 0.0.1188167 → 0.0.1188649

package/json/browser_protocol.json

@@ -2029,24 +2029,119 @@
                         },
                         {
                             "name": "value",
-                            "description": "address field name, for example Jon Doe.",
+                            "description": "address field value, for example Jon Doe.",
                             "type": "string"
                         }
                     ]
                 },
+                {
+                    "id": "AddressFields",
+                    "description": "A list of address fields.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "fields",
+                            "type": "array",
+                            "items": {
+                                "$ref": "AddressField"
+                            }
+                        }
+                    ]
+                },
                 {
                     "id": "Address",
                     "type": "object",
                     "properties": [
                         {
                             "name": "fields",
-                            "description": "fields and values defining a test address.",
+                            "description": "fields and values defining an address.",
                             "type": "array",
                             "items": {
                                 "$ref": "AddressField"
                             }
                         }
                     ]
+                },
+                {
+                    "id": "AddressUI",
+                    "description": "Defines how an address can be displayed like in chrome://settings/addresses.\nAddress UI is a two dimensional array, each inner array is an \"address information line\", and when rendered in a UI surface should be displayed as such.\nThe following address UI for instance:\n[[{name: \"GIVE_NAME\", value: \"Jon\"}, {name: \"FAMILY_NAME\", value: \"Doe\"}], [{name: \"CITY\", value: \"Munich\"}, {name: \"ZIP\", value: \"81456\"}]]\nshould allow the receiver to render:\nJon Doe\nMunich 81456",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "addressFields",
+                            "description": "A two dimension array containing the repesentation of values from an address profile.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "AddressFields"
+                            }
+                        }
+                    ]
+                },
+                {
+                    "id": "FillingStrategy",
+                    "description": "Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.",
+                    "type": "string",
+                    "enum": [
+                        "autocompleteAttribute",
+                        "autofillInferred"
+                    ]
+                },
+                {
+                    "id": "FilledField",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "htmlType",
+                            "description": "The type of the field, e.g text, password etc.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "id",
+                            "description": "the html id",
+                            "type": "string"
+                        },
+                        {
+                            "name": "name",
+                            "description": "the html name",
+                            "type": "string"
+                        },
+                        {
+                            "name": "value",
+                            "description": "the field value",
+                            "type": "string"
+                        },
+                        {
+                            "name": "autofillType",
+                            "description": "The actual field type, e.g FAMILY_NAME",
+                            "type": "string"
+                        },
+                        {
+                            "name": "fillingStrategy",
+                            "description": "The filling strategy",
+                            "$ref": "FillingStrategy"
+                        }
+                    ]
+                }
+            ],
+            "events": [
+                {
+                    "name": "addressFormFilled",
+                    "description": "Emitted when an address form is filled.",
+                    "parameters": [
+                        {
+                            "name": "filledFields",
+                            "description": "Information about the fields that were filled",
+                            "type": "array",
+                            "items": {
+                                "$ref": "FilledField"
+                            }
+                        },
+                        {
+                            "name": "addressUi",
+                            "description": "An UI representation of the address used to fill the form.\nConsists of a 2D array where each child represents an address/profile line.",
+                            "$ref": "AddressUI"
+                        }
+                    ]
                 }
             ],
             "commands": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1188167",
+  "version": "0.0.1188649",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/browser_protocol.pdl

@@ -1002,14 +1002,61 @@ experimental domain Autofill
     properties
       # address field name, for example GIVEN_NAME.
       string name
-      # address field name, for example Jon Doe.
+      # address field value, for example Jon Doe.
       string value
 
+  # A list of address fields.
+  type AddressFields extends object
+    properties
+      array of AddressField fields
+
   type Address extends object
     properties
-      # fields and values defining a test address.
+      # fields and values defining an address.
       array of AddressField fields
 
+  # Defines how an address can be displayed like in chrome://settings/addresses. 
+  # Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
+  # The following address UI for instance:
+  # [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
+  # should allow the receiver to render:
+  # Jon Doe
+  # Munich 81456
+  type AddressUI extends object
+    properties
+      # A two dimension array containing the repesentation of values from an address profile.
+      array of AddressFields addressFields
+
+  # Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
+  type FillingStrategy extends string
+    enum
+      autocompleteAttribute
+      autofillInferred
+
+  type FilledField extends object
+    properties
+      # The type of the field, e.g text, password etc.
+      string htmlType
+      # the html id
+      string id
+      # the html name
+      string name
+      # the field value
+      string value
+      # The actual field type, e.g FAMILY_NAME
+      string autofillType
+      # The filling strategy
+      FillingStrategy fillingStrategy
+
+  # Emitted when an address form is filled.
+  event addressFormFilled
+    parameters
+      # Information about the fields that were filled
+      array of FilledField filledFields
+      # An UI representation of the address used to fill the form. 
+      # Consists of a 2D array where each child represents an address/profile line.
+      AddressUI addressUi
+
   # Trigger autofill on a form identified by the fieldId.
   # If the field and related form cannot be autofilled, returns an error.
   command trigger

package/types/protocol-mapping.d.ts

@@ -114,6 +114,10 @@ export namespace ProtocolMapping {
          */
         'Animation.animationStarted': [Protocol.Animation.AnimationStartedEvent];
         'Audits.issueAdded': [Protocol.Audits.IssueAddedEvent];
+        /**
+         * Emitted when an address form is filled.
+         */
+        'Autofill.addressFormFilled': [Protocol.Autofill.AddressFormFilledEvent];
         /**
          * Called when the recording state for the service has been updated.
          */

package/types/protocol-proxy-api.d.ts

@@ -820,6 +820,11 @@ export namespace ProtocolProxyApi {
          */
         enable(): Promise<void>;
 
+        /**
+         * Emitted when an address form is filled.
+         */
+        on(event: 'addressFormFilled', listener: (params: Protocol.Autofill.AddressFormFilledEvent) => void): void;
+
     }
 
     export interface BackgroundServiceApi {

package/types/protocol.d.ts

@@ -3723,18 +3723,73 @@ export namespace Protocol {
              */
             name: string;
             /**
-             * address field name, for example Jon Doe.
+             * address field value, for example Jon Doe.
              */
             value: string;
         }
 
+        /**
+         * A list of address fields.
+         */
+        export interface AddressFields {
+            fields: AddressField[];
+        }
+
         export interface Address {
             /**
-             * fields and values defining a test address.
+             * fields and values defining an address.
              */
             fields: AddressField[];
         }
 
+        /**
+         * Defines how an address can be displayed like in chrome://settings/addresses.
+         * Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
+         * The following address UI for instance:
+         * [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
+         * should allow the receiver to render:
+         * Jon Doe
+         * Munich 81456
+         */
+        export interface AddressUI {
+            /**
+             * A two dimension array containing the repesentation of values from an address profile.
+             */
+            addressFields: AddressFields[];
+        }
+
+        /**
+         * Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
+         */
+        export type FillingStrategy = ('autocompleteAttribute' | 'autofillInferred');
+
+        export interface FilledField {
+            /**
+             * The type of the field, e.g text, password etc.
+             */
+            htmlType: string;
+            /**
+             * the html id
+             */
+            id: string;
+            /**
+             * the html name
+             */
+            name: string;
+            /**
+             * the field value
+             */
+            value: string;
+            /**
+             * The actual field type, e.g FAMILY_NAME
+             */
+            autofillType: string;
+            /**
+             * The filling strategy
+             */
+            fillingStrategy: FillingStrategy;
+        }
+
         export interface TriggerRequest {
             /**
              * Identifies a field that serves as an anchor for autofill.
@@ -3753,6 +3808,21 @@ export namespace Protocol {
         export interface SetAddressesRequest {
             addresses: Address[];
         }
+
+        /**
+         * Emitted when an address form is filled.
+         */
+        export interface AddressFormFilledEvent {
+            /**
+             * Information about the fields that were filled
+             */
+            filledFields: FilledField[];
+            /**
+             * An UI representation of the address used to fill the form.
+             * Consists of a 2D array where each child represents an address/profile line.
+             */
+            addressUi: AddressUI;
+        }
     }
 
     /**