webext-schema 7.0.0 → 7.1.1

package/schemas/central/webext.json

@@ -3059,146 +3059,6 @@
       ]
     }
   ],
-  "normandyAddonStudy.json": [
-    {
-      "namespace": "manifest",
-      "types": [
-        {
-          "$extend": "PermissionPrivileged",
-          "choices": [
-            {
-              "type": "string",
-              "enum": [
-                "normandyAddonStudy"
-              ]
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "namespace": "normandyAddonStudy",
-      "description": "Normandy Study API",
-      "allowedContexts": [
-        "content",
-        "devtools"
-      ],
-      "defaultContexts": [
-        "content",
-        "devtools"
-      ],
-      "permissions": [
-        "normandyAddonStudy"
-      ],
-      "types": [
-        {
-          "id": "Study",
-          "type": "object",
-          "properties": {
-            "recipeId": {
-              "type": "integer",
-              "description": "The ID of the recipe for the study."
-            },
-            "slug": {
-              "type": "string",
-              "description": "A slug to identify the study."
-            },
-            "userFacingName": {
-              "type": "string",
-              "description": "The name presented on about:studies."
-            },
-            "userFacingDescription": {
-              "type": "string",
-              "description": "The description presented on about:studies."
-            },
-            "branch": {
-              "type": "string",
-              "description": "The study branch in which the user is enrolled."
-            },
-            "active": {
-              "type": "boolean",
-              "description": "The state of the study."
-            },
-            "addonId": {
-              "type": "string",
-              "description": "The ID of the extension installed by the study."
-            },
-            "addonUrl": {
-              "type": "string",
-              "description": "The URL of the XPI that was downloaded and installed by the study."
-            },
-            "addonVersion": {
-              "type": "string",
-              "description": "The version of the extension installed by the study."
-            },
-            "studyStartDate": {
-              "$ref": "extensionTypes.Date",
-              "description": "The start date for the study."
-            },
-            "studyEndDate": {
-              "$ref": "extensionTypes.Date",
-              "description": "The end date for the study."
-            },
-            "extensionApiId": {
-              "type": "integer",
-              "description": "The record ID for the extension in Normandy server's database."
-            },
-            "extensionHash": {
-              "type": "string",
-              "description": "A hash of the extension XPI file."
-            },
-            "extensionHashAlgorithm": {
-              "type": "string",
-              "description": "The algorithm used to hash the extension XPI file."
-            }
-          }
-        }
-      ],
-      "functions": [
-        {
-          "name": "getStudy",
-          "type": "function",
-          "description": "Returns a study object for the current study.",
-          "async": true,
-          "parameters": []
-        },
-        {
-          "name": "endStudy",
-          "type": "function",
-          "description": "Marks the study as ended and then uninstalls the addon.",
-          "async": true,
-          "parameters": [
-            {
-              "type": "string",
-              "name": "reason",
-              "description": "The reason why the study is ending."
-            }
-          ]
-        },
-        {
-          "name": "getClientMetadata",
-          "type": "function",
-          "description": "Returns an object with metadata about the client which may be required for constructing survey URLs.",
-          "async": true,
-          "parameters": []
-        }
-      ],
-      "events": [
-        {
-          "name": "onUnenroll",
-          "type": "function",
-          "description": "Fired when a user unenrolls from a study but before the addon is uninstalled.",
-          "parameters": [
-            {
-              "type": "string",
-              "name": "reason",
-              "description": "The reason why the study is ending."
-            }
-          ]
-        }
-      ]
-    }
-  ],
   "omnibox.json": [
     {
       "namespace": "manifest",
@@ -4815,6 +4675,12 @@
               "optional": true,
               "minimum": -1,
               "description": "The ID of the group that the tab belongs to. $(ref:tabGroups.TAB_GROUP_ID_NONE) (-1) if the tab does not belong to a tab group."
+            },
+            "splitViewId": {
+              "type": "integer",
+              "optional": true,
+              "minimum": -1,
+              "description": "The ID of the Split View that the tab belongs to. $(ref:tabs.SPLIT_VIEW_ID_NONE) if the tab does not belong to a split view."
             }
           }
         },
@@ -5032,6 +4898,7 @@
             "mutedInfo",
             "pinned",
             "sharingState",
+            "splitViewId",
             "status",
             "title",
             "url"
@@ -5080,6 +4947,10 @@
         "TAB_ID_NONE": {
           "value": -1,
           "description": "An ID which represents the absence of a browser tab."
+        },
+        "SPLIT_VIEW_ID_NONE": {
+          "value": -1,
+          "description": "A value for use with splitViewId to represent that the tab is not a member of a Split View."
         }
       },
       "functions": [
@@ -5149,6 +5020,11 @@
                   "optional": true,
                   "minimum": 0,
                   "description": "Open a port to a specific $(topic:frame_ids)[frame] identified by <code>frameId</code> instead of all frames in the tab."
+                },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "Open a port to a specific document identified by <code>documentId</code> instead of all frames in the tab."
                 }
               },
               "optional": true
@@ -5183,6 +5059,11 @@
                   "optional": true,
                   "minimum": 0,
                   "description": "Send a message to a specific $(topic:frame_ids)[frame] identified by <code>frameId</code> instead of all frames in the tab."
+                },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "Send a message to a specific document identified by <code>documentId</code> instead of all frames in the tab."
                 }
               },
               "optional": true
@@ -5464,6 +5345,12 @@
                   "optional": true,
                   "description": "The ID of the group that the tabs are in, or $(ref:tabGroups.TAB_GROUP_ID_NONE) (-1) for ungrouped tabs."
                 },
+                "splitViewId": {
+                  "type": "integer",
+                  "minimum": -1,
+                  "optional": true,
+                  "description": "The ID of the Split View that the tab belongs to. $(ref:tabs.SPLIT_VIEW_ID_NONE) if the tab does not belong to a split view."
+                },
                 "screen": {
                   "choices": [
                     {
@@ -6478,6 +6365,12 @@
                   "optional": true,
                   "description": "The tab's new sharing state for screen, microphone and camera."
                 },
+                "splitViewId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -1,
+                  "description": "The ID of the Split View that the tab belongs to. $(ref:tabs.SPLIT_VIEW_ID_NONE) if the tab does not belong to a split view."
+                },
                 "status": {
                   "type": "string",
                   "optional": true,
@@ -7700,13 +7593,7 @@
             {
               "type": "function",
               "name": "callback",
-              "parameters": [
-                {
-                  "name": "wasCleared",
-                  "type": "boolean",
-                  "description": "Whether any alarm was found to clear."
-                }
-              ]
+              "parameters": []
             }
           ]
         }
@@ -8263,7 +8150,17 @@
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "optional": true,
+              "choices": [
+                {
+                  "$ref": "Details"
+                },
+                {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The id of the tab for which you want to query its enabled state."
+                }
+              ]
             }
           ]
         },
@@ -9230,6 +9127,21 @@
               "description": "The cookie store ID of the contextual identity."
             }
           }
+        },
+        {
+          "id": "SiteAssociation",
+          "type": "object",
+          "description": "Represents the association between a site and a contextual identity.",
+          "properties": {
+            "site": {
+              "type": "string",
+              "description": "The associated host, normalized to lower case and encoded as ASCII."
+            },
+            "cookieStoreId": {
+              "type": "string",
+              "description": "The cookie store ID of the contextual identity the host is associated with."
+            }
+          }
         }
       ],
       "functions": [
@@ -9266,6 +9178,68 @@
             }
           ]
         },
+        {
+          "name": "getSupportedColors",
+          "type": "function",
+          "description": "Retrieves the list of colors supported by contextual identities.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "colors",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "color": {
+                        "type": "string",
+                        "description": "The color name, as accepted by the color property of create and update."
+                      },
+                      "colorCode": {
+                        "type": "string",
+                        "description": "The color hash for this color name."
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "getSupportedIcons",
+          "type": "function",
+          "description": "Retrieves the list of icons supported by contextual identities.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "icons",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "icon": {
+                        "type": "string",
+                        "description": "The icon name, as accepted by the icon property of create and update."
+                      },
+                      "iconUrl": {
+                        "type": "string",
+                        "description": "The icon url for this icon name."
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "create",
           "type": "function",
@@ -9371,84 +9345,213 @@
               "description": "The ID of the contextual identity cookie store. "
             }
           ]
-        }
-      ],
-      "events": [
+        },
         {
-          "name": "onUpdated",
+          "name": "setSiteAssociation",
           "type": "function",
-          "description": "Fired when a container is updated.",
+          "description": "Associates a site with a container. Top-level navigations to that site will load in the given container.",
+          "async": true,
           "parameters": [
             {
               "type": "object",
-              "name": "changeInfo",
+              "name": "details",
+              "description": "Details about the site association.",
               "properties": {
-                "contextualIdentity": {
-                  "$ref": "ContextualIdentity",
-                  "description": "Contextual identity that has been updated"
+                "site": {
+                  "type": "string",
+                  "description": "The host to associate with the container (matched as an exact host)."
+                },
+                "cookieStoreId": {
+                  "type": "string",
+                  "description": "The cookie store ID of the container to associate the site with."
                 }
               }
             }
           ]
         },
         {
-          "name": "onCreated",
+          "name": "removeSiteAssociation",
           "type": "function",
-          "description": "Fired when a new container is created.",
+          "description": "Removes the container association for a site.",
+          "async": true,
           "parameters": [
             {
               "type": "object",
-              "name": "changeInfo",
+              "name": "details",
+              "description": "Details about the site association to remove.",
               "properties": {
-                "contextualIdentity": {
-                  "$ref": "ContextualIdentity",
-                  "description": "Contextual identity that has been created"
+                "site": {
+                  "type": "string",
+                  "description": "The host whose container association should be removed."
                 }
               }
             }
           ]
         },
         {
-          "name": "onRemoved",
+          "name": "getSiteAssociation",
           "type": "function",
-          "description": "Fired when a container is removed.",
+          "description": "Retrieves the association of a site, or null if the site is not associated with any container.",
+          "async": "callback",
           "parameters": [
             {
               "type": "object",
-              "name": "changeInfo",
+              "name": "details",
+              "description": "Details about the site to look up.",
               "properties": {
-                "contextualIdentity": {
-                  "$ref": "ContextualIdentity",
-                  "description": "Contextual identity that has been removed"
+                "site": {
+                  "type": "string",
+                  "description": "The host to look up."
                 }
               }
-            }
-          ]
-        }
-      ]
-    }
-  ],
-  "cookies.json": [
-    {
-      "namespace": "manifest",
-      "types": [
-        {
-          "$extend": "OptionalPermissionNoPrompt",
-          "choices": [
+            },
             {
-              "type": "string",
-              "enum": [
-                "cookies"
+              "type": "function",
+              "name": "callback",
+              "parameters": [
+                {
+                  "name": "association",
+                  "$ref": "SiteAssociation",
+                  "optional": true,
+                  "description": "The association of the site, null if the site is not associated with any container."
+                }
               ]
             }
           ]
-        }
-      ]
-    },
-    {
-      "namespace": "cookies",
-      "description": "Use the <code>browser.cookies</code> API to query and modify cookies, and to be notified when they change.",
-      "permissions": [
+        },
+        {
+          "name": "querySiteAssociations",
+          "type": "function",
+          "description": "Retrieves the list of site-to-container associations.",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "details",
+              "description": "Information to filter the associations being retrieved.",
+              "properties": {
+                "cookieStoreId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "If provided, only associations for this container are returned."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "parameters": [
+                {
+                  "name": "associations",
+                  "type": "array",
+                  "items": {
+                    "$ref": "SiteAssociation"
+                  },
+                  "description": "The site-to-container associations."
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "events": [
+        {
+          "name": "onUpdated",
+          "type": "function",
+          "description": "Fired when a container is updated.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "changeInfo",
+              "properties": {
+                "contextualIdentity": {
+                  "$ref": "ContextualIdentity",
+                  "description": "Contextual identity that has been updated"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "onCreated",
+          "type": "function",
+          "description": "Fired when a new container is created.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "changeInfo",
+              "properties": {
+                "contextualIdentity": {
+                  "$ref": "ContextualIdentity",
+                  "description": "Contextual identity that has been created"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "onRemoved",
+          "type": "function",
+          "description": "Fired when a container is removed.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "changeInfo",
+              "properties": {
+                "contextualIdentity": {
+                  "$ref": "ContextualIdentity",
+                  "description": "Contextual identity that has been removed"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "onSiteAssociationChanged",
+          "type": "function",
+          "description": "Fired when a site-to-container association is added, changed, or removed.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "changeInfo",
+              "properties": {
+                "site": {
+                  "type": "string",
+                  "description": "The host whose association changed."
+                },
+                "cookieStoreId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The cookie store ID of the now-associated container, or omitted if the association was removed."
+                }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "cookies.json": [
+    {
+      "namespace": "manifest",
+      "types": [
+        {
+          "$extend": "OptionalPermissionNoPrompt",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "cookies"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "namespace": "cookies",
+      "description": "Use the <code>browser.cookies</code> API to query and modify cookies, and to be notified when they change.",
+      "permissions": [
         "cookies"
       ],
       "types": [
@@ -12823,7 +12926,6 @@
             "nativeallocations",
             "ipcmessages",
             "audiocallbacktracing",
-            "cpu",
             "notimerresolutionchange",
             "cpuallthreads",
             "samplingallthreads",
@@ -12992,7 +13094,7 @@
           "properties": {
             "default_locale": {
               "type": "string",
-              "optional": "true"
+              "optional": true
             },
             "l10n_resources": {
               "type": "array",
@@ -14073,7 +14175,6 @@
             },
             "content_security_policy": {
               "optional": true,
-              "onError": "warn",
               "choices": [
                 {
                   "max_manifest_version": 2,
@@ -14092,11 +14193,40 @@
                       "optional": true,
                       "format": "contentSecurityPolicy",
                       "description": "The Content Security Policy used for extension pages."
+                    },
+                    "sandbox": {
+                      "type": "string",
+                      "optional": true,
+                      "format": "contentSecurityPolicySandbox",
+                      "description": "The content security policy used for sandboxed extension pages."
                     }
                   }
                 }
               ]
             },
+            "sandbox": {
+              "type": "object",
+              "optional": true,
+              "additionalProperties": {
+                "$ref": "UnrecognizedProperty"
+              },
+              "properties": {
+                "pages": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "The list of pages in the form of globs to serve as sandboxed extension pages."
+                },
+                "content_security_policy": {
+                  "type": "string",
+                  "optional": true,
+                  "max_manifest_version": 2,
+                  "format": "contentSecurityPolicySandbox",
+                  "description": "The content security policy used for sandboxed extension pages."
+                }
+              }
+            },
             "permissions": {
               "default": [],
               "optional": true,
@@ -16077,6 +16207,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -16370,6 +16510,123 @@
       }
     }
   ],
+  "public_suffix.json": [
+    {
+      "namespace": "manifest",
+      "types": [
+        {
+          "$extend": "OptionalPermissionNoPrompt",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "publicSuffix"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "namespace": "publicSuffix",
+      "description": "API to obtain the registrable domain / eTLD+1 from a domain name.",
+      "permissions": [
+        "publicSuffix"
+      ],
+      "types": [
+        {
+          "id": "DomainEncoding",
+          "type": "string",
+          "description": "The available encoding types for the returned domain.",
+          "enum": [
+            "punycode",
+            "display"
+          ]
+        }
+      ],
+      "functions": [
+        {
+          "name": "isKnownSuffix",
+          "type": "function",
+          "description": "Checks if the given hostname is itself a known public suffix / eTLD (i.e. in the PSL).",
+          "parameters": [
+            {
+              "name": "hostname",
+              "type": "string"
+            }
+          ],
+          "returns": {
+            "type": "boolean",
+            "description": "True if the given hostname is itself a known eTLD."
+          }
+        },
+        {
+          "name": "getKnownSuffix",
+          "type": "function",
+          "description": "Gets the known public suffix / eTLD (i.e. in the PSL), if any, of a given hostname.",
+          "parameters": [
+            {
+              "name": "hostname",
+              "type": "string"
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "optional": true,
+            "description": "The known eTLD of the given hostname, or null if no such known eTLD exists."
+          }
+        },
+        {
+          "name": "getDomain",
+          "type": "function",
+          "description": "Gets the eTLD+1 of a given hostname, or a variant such as IP address if the options allow.",
+          "parameters": [
+            {
+              "name": "hostname",
+              "type": "string"
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "properties": {
+                "encoding": {
+                  "$ref": "DomainEncoding",
+                  "optional": true,
+                  "default": "punycode",
+                  "description": "Determines how the returned domain should be encoded."
+                },
+                "allowIPAddress": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": false,
+                  "description": "If true, and the input hostname is an IP address, then this is returned as-is."
+                },
+                "allowPlainSuffix": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": false,
+                  "description": "If true, and the input hostname is itself a known eTLD (without a preceding label) then this is returned as-is."
+                },
+                "allowUnknownSuffix": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": false,
+                  "description": "If true, and the input hostname lacks a known eTLD, and is neither itself a known eTLD nor an IP address, then the returned domain consists of the penultimate two domain labels of the input."
+                }
+              },
+              "optional": true,
+              "default": {}
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "optional": true,
+            "description": "The eTLD+1 (or a variant such as IP address if allowed) of the given hostname, or null if no such eTLD+1 (variant) exists."
+          }
+        }
+      ]
+    }
+  ],
   "runtime.json": [
     {
       "namespace": "manifest",
@@ -16489,7 +16746,6 @@
             },
             "documentId": {
               "type": "string",
-              "unsupported": true,
               "optional": true,
               "description": "An UUID for the document associated with this context, or undefined if it is not hosted in a document"
             },
@@ -16574,6 +16830,11 @@
               "optional": true,
               "description": "The $(topic:frame_ids)[frame] that opened the connection. 0 for top-level frames, positive for child frames. This will only be set when <code>tab</code> is set."
             },
+            "documentId": {
+              "type": "string",
+              "optional": true,
+              "description": "A UUID of the document that opened the connection."
+            },
             "id": {
               "type": "string",
               "optional": true,
@@ -16855,6 +17116,20 @@
             "description": "The manifest details."
           }
         },
+        {
+          "name": "getVersion",
+          "allowedContexts": [
+            "content",
+            "devtools"
+          ],
+          "description": "Returns the extension version as declared in the manifest.",
+          "type": "function",
+          "parameters": [],
+          "returns": {
+            "type": "string",
+            "description": "The extension version."
+          }
+        },
         {
           "name": "getURL",
           "type": "function",
@@ -16876,18 +17151,39 @@
           }
         },
         {
-          "name": "getFrameId",
+          "name": "getDocumentId",
           "type": "function",
           "allowedContexts": [
             "content",
             "devtools"
           ],
-          "description": "Get the frameId of any window global or frame element.",
+          "description": "Get the documentId of any window global or frame element. Throws for invalid targets, such as unloaded frames.",
           "parameters": [
             {
               "type": "any",
               "name": "target",
-              "description": "A WindowProxy or a Browsing Context container element (IFrame, Frame, Embed, Object) for the target frame."
+              "description": "A WindowProxy or a browsing context container Element (iframe, frame, embed, or object) for the target frame."
+            }
+          ],
+          "allowCrossOriginArguments": true,
+          "returns": {
+            "type": "string",
+            "description": "The documentId of the target document."
+          }
+        },
+        {
+          "name": "getFrameId",
+          "type": "function",
+          "allowedContexts": [
+            "content",
+            "devtools"
+          ],
+          "description": "Get the frameId of any window global or frame element.",
+          "parameters": [
+            {
+              "type": "any",
+              "name": "target",
+              "description": "A WindowProxy or a browsing context container Element (iframe, frame, embed, or object) for the target frame."
             }
           ],
           "allowCrossOriginArguments": true,
@@ -17493,6 +17789,10 @@
           "type": "object",
           "description": "Result of a script injection.",
           "properties": {
+            "documentId": {
+              "type": "string",
+              "description": "The document associated with the injection."
+            },
             "frameId": {
               "type": "integer",
               "description": "The frame ID associated with the injection."
@@ -17529,6 +17829,14 @@
             "tabId": {
               "type": "number",
               "description": "The ID of the tab into which to inject."
+            },
+            "documentIds": {
+              "type": "array",
+              "optional": true,
+              "description": "The IDs of specific documents to inject into. This must not be set if <code>frameIds</code> or <code>allFrames</code> is set.",
+              "items": {
+                "type": "string"
+              }
             }
           }
         },
@@ -18990,6 +19298,83 @@
             }
           }
         },
+        {
+          "id": "ThemeCSSGradient",
+          "description": "A CSS gradient that can be used as a theme background, in addition to image assets. The single property name selects the gradient function, and its value holds the gradient's arguments, e.g. `{ \"linear-gradient\": \"to bottom, #FF6BBA, #FFC999\" }`.",
+          "choices": [
+            {
+              "type": "object",
+              "postprocess": "validCSSGradient",
+              "properties": {
+                "linear-gradient": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "postprocess": "validCSSGradient",
+              "properties": {
+                "radial-gradient": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "postprocess": "validCSSGradient",
+              "properties": {
+                "conic-gradient": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "postprocess": "validCSSGradient",
+              "properties": {
+                "repeating-linear-gradient": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "postprocess": "validCSSGradient",
+              "properties": {
+                "repeating-radial-gradient": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "postprocess": "validCSSGradient",
+              "properties": {
+                "repeating-conic-gradient": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        {
+          "id": "ThemeBackground",
+          "choices": [
+            {
+              "$ref": "ImageDataOrExtensionURL"
+            },
+            {
+              "$ref": "ThemeCSSGradient"
+            }
+          ]
+        },
         {
           "id": "ThemeType",
           "type": "object",
@@ -19001,7 +19386,7 @@
                 "additional_backgrounds": {
                   "type": "array",
                   "items": {
-                    "$ref": "ImageDataOrExtensionURL"
+                    "$ref": "ThemeBackground"
                   },
                   "maxItems": 15,
                   "optional": true
@@ -19012,7 +19397,7 @@
                   "deprecated": "Unsupported images property, use 'theme.images.theme_frame', this alias is ignored in Firefox >= 70."
                 },
                 "theme_frame": {
-                  "$ref": "ImageDataOrExtensionURL",
+                  "$ref": "ThemeBackground",
                   "optional": true
                 }
               },
@@ -19205,6 +19590,15 @@
               "type": "object",
               "optional": true,
               "properties": {
+                "backgrounds_area": {
+                  "type": "string",
+                  "enum": [
+                    "auto",
+                    "window",
+                    "top_toolbars"
+                  ],
+                  "optional": true
+                },
                 "additional_backgrounds_alignment": {
                   "type": "array",
                   "items": {
@@ -19243,6 +19637,14 @@
                   "maxItems": 15,
                   "optional": true
                 },
+                "additional_backgrounds_size": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "maxItems": 15,
+                  "optional": true
+                },
                 "color_scheme": {
                   "optional": true,
                   "type": "string",
@@ -19955,6 +20357,100 @@
               "description": "Whether the runtime.sendMessage and runtime.connect methods are exposed. Defaults to not exposing these messaging APIs."
             }
           }
+        },
+        {
+          "id": "UserScriptInjection",
+          "min_manifest_version": 3,
+          "type": "object",
+          "description": "Details of a user script injection",
+          "properties": {
+            "injectImmediately": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether the injection should be triggered in the target as soon as possible. Note that this is not a guarantee that injection will occur prior to page load, as the page may have already loaded by the time the script reaches the target."
+            },
+            "js": {
+              "type": "array",
+              "optional": false,
+              "description": "The list of ScriptSource objects defining sources of scripts to be injected into matching pages.",
+              "items": {
+                "$ref": "ScriptSource"
+              }
+            },
+            "target": {
+              "$ref": "InjectionTarget",
+              "description": "Details specifying the target into which to inject the script."
+            },
+            "world": {
+              "$ref": "ExecutionWorld",
+              "optional": true,
+              "description": "The JavaScript \"world\" to run the script in. The default is `USER_SCRIPT`."
+            },
+            "worldId": {
+              "type": "string",
+              "optional": true,
+              "description": "A specific user script world ID to execute in. Only valid if `world` is omitted or is `USER_SCRIPT`. If `worldId` is omitted, the default value is an empty string (\"\") and the script will execute in the default world."
+            }
+          }
+        },
+        {
+          "id": "InjectionTarget",
+          "min_manifest_version": 3,
+          "type": "object",
+          "description": "Details specifying the target into which to inject the script.",
+          "properties": {
+            "allFrames": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` is specified."
+            },
+            "documentIds": {
+              "type": "array",
+              "optional": true,
+              "description": "The IDs of specific documentIds to inject into. This must not be set if frameIds is set.",
+              "items": {
+                "type": "string"
+              }
+            },
+            "frameIds": {
+              "type": "array",
+              "optional": true,
+              "description": "The IDs of specific frames to inject into.",
+              "items": {
+                "type": "number"
+              }
+            },
+            "tabId": {
+              "type": "number",
+              "description": "The ID of the tab into which to inject."
+            }
+          }
+        },
+        {
+          "id": "InjectionResult",
+          "min_manifest_version": 3,
+          "type": "object",
+          "description": "Result of a user script injection.",
+          "properties": {
+            "documentId": {
+              "type": "string",
+              "description": "Document ID associated with the injection."
+            },
+            "frameId": {
+              "type": "integer",
+              "description": "Frame ID associated with the injection."
+            },
+            "result": {
+              "type": "any",
+              "optional": true,
+              "description": "Result of the script injection if any. This is mutually exclusive with error."
+            },
+            "error": {
+              "type": "any",
+              "optional": true,
+              "description": "Error message if any. This is mutually exclusive with result. The value is typically an (Error) object with a message property, but could be any value (including primitives and undefined) if the user script threw or rejected with such a value."
+            }
+          }
         }
       ],
       "functions": [
@@ -20130,6 +20626,34 @@
               ]
             }
           ]
+        },
+        {
+          "name": "execute",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Executes one or more ephemeral user scripts into a specific tab.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "injection",
+              "$ref": "UserScriptInjection",
+              "description": "The details of the user script which to inject."
+            },
+            {
+              "name": "callback",
+              "type": "function",
+              "description": "Invoked upon completion of the injection. The resulting array contains the result of execution for each frame where the injection succeeded.",
+              "parameters": [
+                {
+                  "name": "results",
+                  "type": "array",
+                  "items": {
+                    "$ref": "InjectionResult"
+                  }
+                }
+              ]
+            }
+          ]
         }
       ]
     }
@@ -20272,7 +20796,7 @@
         {
           "name": "getFrame",
           "type": "function",
-          "description": "Retrieves information about the given frame. A frame refers to an &lt;iframe&gt; or a &lt;frame&gt; of a web page and is identified by a tab ID and a frame ID.",
+          "description": "Retrieves information about the given frame. A frame refers to an &lt;iframe&gt; or a &lt;frame&gt; of a web page and is identified by a tab ID and a frame ID, or by its document ID.",
           "async": "callback",
           "parameters": [
             {
@@ -20281,9 +20805,10 @@
               "description": "Information about the frame to retrieve information about.",
               "properties": {
                 "tabId": {
+                  "optional": true,
                   "type": "integer",
                   "minimum": 0,
-                  "description": "The ID of the tab in which the frame is."
+                  "description": "The ID of the tab in which the frame is. Must be specified if documentId is not set."
                 },
                 "processId": {
                   "optional": true,
@@ -20291,9 +20816,15 @@
                   "description": "The ID of the process runs the renderer for this tab."
                 },
                 "frameId": {
+                  "optional": true,
                   "type": "integer",
                   "minimum": 0,
-                  "description": "The ID of the frame in the given tab."
+                  "description": "The ID of the frame in the given tab. Must be specified if documentId is not set."
+                },
+                "documentId": {
+                  "optional": true,
+                  "type": "string",
+                  "description": "The UUID of the document. If provided, tabId and frameId are optional. If all are provided, the frame is only returned if all properties match."
                 }
               }
             },
@@ -20327,6 +20858,15 @@
                     "parentFrameId": {
                       "type": "integer",
                       "description": "ID of frame that wraps the frame. Set to -1 of no parent frame exists."
+                    },
+                    "documentId": {
+                      "type": "string",
+                      "description": "A UUID of the document loaded."
+                    },
+                    "parentDocumentId": {
+                      "type": "string",
+                      "optional": true,
+                      "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
                     }
                   }
                 }
@@ -20386,6 +20926,15 @@
                         "type": "integer",
                         "description": "ID of frame that wraps the frame. Set to -1 of no parent frame exists."
                       },
+                      "documentId": {
+                        "type": "string",
+                        "description": "A UUID of the document loaded."
+                      },
+                      "parentDocumentId": {
+                        "type": "string",
+                        "optional": true,
+                        "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                      },
                       "url": {
                         "type": "string",
                         "description": "The URL currently associated with this frame."
@@ -20428,6 +20977,11 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame. Set to -1 of no parent frame exists."
                 },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "timeStamp": {
                   "type": "number",
                   "description": "The time when the browser was about to start the navigation, in milliseconds since the epoch."
@@ -20469,6 +21023,15 @@
                   "type": "integer",
                   "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."
                 },
+                "documentId": {
+                  "type": "string",
+                  "description": "A UUID of the document loaded."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "transitionType": {
                   "$ref": "TransitionType",
                   "description": "Cause of the navigation."
@@ -20521,6 +21084,15 @@
                   "type": "integer",
                   "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."
                 },
+                "documentId": {
+                  "type": "string",
+                  "description": "A UUID of the document loaded."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "timeStamp": {
                   "type": "number",
                   "description": "The time when the page's DOM was fully constructed, in milliseconds since the epoch."
@@ -20562,6 +21134,15 @@
                   "type": "integer",
                   "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."
                 },
+                "documentId": {
+                  "type": "string",
+                  "description": "A UUID of the document loaded."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "timeStamp": {
                   "type": "number",
                   "description": "The time when the document finished loading, in milliseconds since the epoch."
@@ -20603,6 +21184,15 @@
                   "type": "integer",
                   "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."
                 },
+                "documentId": {
+                  "type": "string",
+                  "description": "A UUID of the document loaded."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "error": {
                   "unsupported": true,
                   "type": "string",
@@ -20694,6 +21284,15 @@
                   "type": "integer",
                   "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."
                 },
+                "documentId": {
+                  "type": "string",
+                  "description": "A UUID of the document loaded."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "transitionType": {
                   "$ref": "TransitionType",
                   "description": "Cause of the navigation."
@@ -20771,6 +21370,15 @@
                   "type": "integer",
                   "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."
                 },
+                "documentId": {
+                  "type": "string",
+                  "description": "A UUID of the document loaded."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "A UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "transitionType": {
                   "$ref": "TransitionType",
                   "description": "Cause of the navigation."
@@ -21402,6 +22010,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -21528,6 +22146,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -21627,6 +22255,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -21721,6 +22359,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -21828,6 +22476,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -21972,6 +22630,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -22083,6 +22751,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -22198,6 +22876,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,
@@ -22316,6 +23004,16 @@
                   "type": "integer",
                   "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."
                 },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the document making the request. This value is not present if the request is a navigation of a frame."
+                },
+                "parentDocumentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The UUID of the parent document owning this frame. This is not set if there is no parent."
+                },
                 "incognito": {
                   "type": "boolean",
                   "optional": true,