webext-schema 5.3.1 → 5.3.2

package/package.json

@@ -17,11 +17,11 @@
     "commander": "^12.0.0",
     "decamelize": "^6.0.0",
     "json5": "^2.2.3",
-    "sinon": "^17.0.2"
+    "sinon": "^18.0.0"
   },
   "devDependencies": {
     "@types/firefox-webext-browser": "^120.0.3",
-    "@types/node": "^20.12.11",
+    "@types/node": "^20.12.12",
     "@types/sinon": "^17.0.3",
     "c8": "^9.1.0",
     "chai": "^5.1.1",
@@ -54,5 +54,5 @@
     "update-mail": "node index update --channel=mail -i",
     "update-release": "node index update --channel=release -i"
   },
-  "version": "5.3.1"
+  "version": "5.3.2"
 }

package/schemas/beta/webext.json

@@ -9981,6 +9981,20 @@
               }
             }
           }
+        },
+        {
+          "id": "GetRulesFilter",
+          "type": "object",
+          "properties": {
+            "ruleIds": {
+              "type": "array",
+              "optional": true,
+              "description": "If specified, only rules with matching IDs are included.",
+              "items": {
+                "type": "integer"
+              }
+            }
+          }
         }
       ],
       "functions": [
@@ -10136,6 +10150,12 @@
           "description": "Returns the current set of dynamic rules for the extension.",
           "async": "callback",
           "parameters": [
+            {
+              "name": "filter",
+              "$ref": "GetRulesFilter",
+              "optional": true,
+              "description": "An object to filter the set of dynamic rules for the extension."
+            },
             {
               "name": "callback",
               "type": "function",
@@ -10157,6 +10177,12 @@
           "description": "Returns the current set of session scoped rules for the extension.",
           "async": "callback",
           "parameters": [
+            {
+              "name": "filter",
+              "$ref": "GetRulesFilter",
+              "optional": true,
+              "description": "An object to filter the set of session scoped rules for the extension."
+            },
             {
               "name": "callback",
               "type": "function",
@@ -12312,7 +12338,8 @@
             "power",
             "responsiveness",
             "cpufreq",
-            "bandwidth"
+            "bandwidth",
+            "memory"
           ]
         },
         {
@@ -12969,12 +12996,13 @@
         },
         {
           "id": "ExtensionInstallType",
-          "description": "How the extension was installed. One of<br><var>development</var>: The extension was loaded unpacked in developer mode,<br><var>normal</var>: The extension was installed normally via an .xpi file,<br><var>sideload</var>: The extension was installed by other software on the machine,<br><var>other</var>: The extension was installed by other means.",
+          "description": "How the extension was installed. One of<br><var>development</var>: The extension was loaded unpacked in developer mode,<br><var>normal</var>: The extension was installed normally via an .xpi file,<br><var>sideload</var>: The extension was installed by other software on the machine,<br><var>admin</var>: The extension was installed by policy,<br><var>other</var>: The extension was installed by other means.",
           "type": "string",
           "enum": [
             "development",
             "normal",
             "sideload",
+            "admin",
             "other"
           ]
         },
@@ -13417,10 +13445,13 @@
             },
             "incognito": {
               "type": "string",
+              "description": "The 'split' value is not supported.",
               "enum": [
                 "not_allowed",
-                "spanning"
+                "spanning",
+                "split"
               ],
+              "postprocess": "incognitoSplitUnsupportedAndFallback",
               "default": "spanning",
               "optional": true
             },
@@ -15725,6 +15756,132 @@
       ],
       "description": "Use the <code>browser.runtime</code> API to retrieve the background page, return details about the manifest, and listen for and respond to events in the app or extension lifecycle. You can also use this API to convert the relative path of URLs to fully-qualified URLs.",
       "types": [
+        {
+          "id": "ContextFilter",
+          "min_manifest_version": 3,
+          "type": "object",
+          "description": "A filter to match against existing extension context. Matching contexts must match all specified filters.",
+          "properties": {
+            "contextIds": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "contextTypes": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "$ref": "ContextType"
+              }
+            },
+            "documentIds": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "documentOrigins": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "documentUrls": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "frameIds": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "integer"
+              }
+            },
+            "tabIds": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "integer"
+              }
+            },
+            "windowIds": {
+              "optional": true,
+              "type": "array",
+              "items": {
+                "type": "integer"
+              }
+            },
+            "incognito": {
+              "optional": true,
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "id": "ContextType",
+          "type": "string",
+          "enum": [
+            "BACKGROUND",
+            "POPUP",
+            "SIDE_PANEL",
+            "TAB"
+          ],
+          "description": "The type of extension view."
+        },
+        {
+          "id": "ExtensionContext",
+          "type": "object",
+          "description": "A context hosting extension content",
+          "properties": {
+            "contextId": {
+              "type": "string",
+              "description": "An unique identifier associated to this context"
+            },
+            "contextType": {
+              "$ref": "ContextType",
+              "description": "The type of the context"
+            },
+            "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"
+            },
+            "documentOrigin": {
+              "type": "string",
+              "optional": true,
+              "description": "The origin of the document associated with this context, or undefined if it is not hosted in a document"
+            },
+            "documentUrl": {
+              "type": "string",
+              "optional": true,
+              "description": "The URL of the document associated with this context, or undefined if it is not hosted in a document"
+            },
+            "incognito": {
+              "type": "boolean",
+              "description": "Whether the context is associated with an private browsing context."
+            },
+            "frameId": {
+              "type": "integer",
+              "description": "The frame ID for this context, or -1 if it is not hosted in a frame."
+            },
+            "tabId": {
+              "type": "integer",
+              "description": "The tab ID for this context, or -1 if it is not hosted in a tab."
+            },
+            "windowId": {
+              "type": "integer",
+              "description": "The window ID for this context, or -1 if it is not hosted in a window."
+            }
+          }
+        },
         {
           "id": "Port",
           "type": "object",
@@ -15994,6 +16151,33 @@
             }
           ]
         },
+        {
+          "name": "getContexts",
+          "type": "function",
+          "description": "Fetches information about active contexts associated with this extension",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "filter",
+              "$ref": "ContextFilter",
+              "description": "A filter to find matching context."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "parameters": [
+                {
+                  "name": "contexts",
+                  "type": "array",
+                  "items": {
+                    "$ref": "ExtensionContext"
+                  },
+                  "description": "The matching contexts, if any."
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "openOptionsPage",
           "type": "function",

package/schemas/central/webext.json

@@ -14137,7 +14137,12 @@
             "match_about_blank": {
               "type": "boolean",
               "optional": true,
-              "description": "If matchAboutBlank is true, then the code is also injected in about:blank and about:srcdoc frames if your extension has access to its parent document. Code cannot be inserted in top-level about:-frames. By default it is <code>false</code>."
+              "description": "If match_about_blank is true, then the code is also injected in about:blank and about:srcdoc frames if your extension has access to its parent document. Ignored if match_origin_as_fallback is specified. By default it is <code>false</code>."
+            },
+            "match_origin_as_fallback": {
+              "type": "boolean",
+              "optional": true,
+              "description": "If match_origin_as_fallback is true, then the code is also injected in about:, data:, blob: when their origin matches the pattern in 'matches', even if the actual document origin is opaque (due to the use of CSP sandbox or iframe sandbox). Match patterns in 'matches' must specify a wildcard path glob. By default it is <code>false</code>."
             },
             "run_at": {
               "$ref": "extensionTypes.RunAt",
@@ -16936,6 +16941,11 @@
                 "type": "string"
               }
             },
+            "matchOriginAsFallback": {
+              "type": "boolean",
+              "optional": true,
+              "description": "If matchOriginAsFallback is true, then the code is also injected in about:, data:, blob: when their origin matches the pattern in 'matches', even if the actual document origin is opaque (due to the use of CSP sandbox or iframe sandbox). Match patterns in 'matches' must specify a wildcard path glob. By default it is <code>false</code>."
+            },
             "runAt": {
               "$ref": "extensionTypes.RunAt",
               "optional": true,
@@ -21004,7 +21014,7 @@
             {
               "type": "function",
               "optional": true,
-              "name": "callback",
+              "name": "asyncCallback",
               "parameters": [
                 {
                   "name": "response",
@@ -21023,6 +21033,7 @@
               "type": "array",
               "optional": true,
               "name": "extraInfoSpec",
+              "postprocess": "mutuallyExclusiveBlockingOrAsyncBlocking",
               "description": "Array of extra information that should be passed to the listener function.",
               "items": {
                 "$ref": "OnAuthRequiredOptions"

package/schemas/mail/mailext.json

@@ -4449,6 +4449,12 @@
                   "description": "Enable browser styles. See the `MDN documentation on browser styles <|link-mdn-browser-styles|>`__ for more information.",
                   "default": false
                 },
+                "default_area": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "Defines the location the action button will appear. Deprecated and ignored. Replaced by ``allowed_spaces``",
+                  "deprecated": "Unsupported on Thunderbird."
+                },
                 "default_windows": {
                   "description": "Defines the windows, the action button should appear in. Defaults to showing it only in the <value>normal</value> Thunderbird window, but can also be shown in the <value>messageDisplay</value> window.",
                   "type": "array",
@@ -5355,14 +5361,14 @@
                       "optional": true,
                       "format": "url",
                       "preprocess": "localize",
-                      "deprecated": "Unsupported on Thunderbird at this time."
+                      "deprecated": "Unsupported on Thunderbird."
                     },
                     "image_url": {
                       "type": "string",
                       "optional": true,
                       "format": "url",
                       "preprocess": "localize",
-                      "deprecated": "Unsupported on Thunderbird at this time."
+                      "deprecated": "Unsupported on Thunderbird."
                     },
                     "search_url_get_params": {
                       "type": "string",
@@ -5392,13 +5398,13 @@
                       "type": "string",
                       "optional": true,
                       "preprocess": "localize",
-                      "deprecated": "Unsupported on Thunderbird at this time."
+                      "deprecated": "Unsupported on Thunderbird."
                     },
                     "image_url_post_params": {
                       "type": "string",
                       "optional": true,
                       "preprocess": "localize",
-                      "deprecated": "Unsupported on Thunderbird at this time."
+                      "deprecated": "Unsupported on Thunderbird."
                     },
                     "search_form": {
                       "type": "string",
@@ -5415,7 +5421,7 @@
                         "preprocess": "localize"
                       },
                       "optional": true,
-                      "deprecated": "Unsupported on Thunderbird at this time."
+                      "deprecated": "Unsupported on Thunderbird."
                     },
                     "prepopulated_id": {
                       "type": "integer",
@@ -7818,16 +7824,17 @@
       "permissions": [
         "compose"
       ],
+      "max_manifest_version": 2,
       "types": [
         {
           "id": "RegisteredComposeScriptOptions",
           "type": "object",
-          "description": "Details of a compose script registered programmatically",
+          "description": "Details of a compose script registered programmatically.",
           "properties": {
             "css": {
               "type": "array",
               "optional": true,
-              "description": "The list of CSS files to inject",
+              "description": "The list of CSS files to inject.",
               "items": {
                 "$ref": "extensionTypes.ExtensionFileOrCode"
               }
@@ -7835,7 +7842,7 @@
             "js": {
               "type": "array",
               "optional": true,
-              "description": "The list of JavaScript files to inject",
+              "description": "The list of JavaScript files to inject.",
               "items": {
                 "$ref": "extensionTypes.ExtensionFileOrCode"
               }
@@ -7845,12 +7852,12 @@
         {
           "id": "RegisteredComposeScript",
           "type": "object",
-          "description": "An object that represents a compose script registered programmatically",
+          "description": "An object that represents a compose script registered programmatically.",
           "functions": [
             {
               "name": "unregister",
               "type": "function",
-              "description": "Unregister a compose script registered programmatically",
+              "description": "Unregister a compose script registered programmatically.",
               "async": true,
               "parameters": []
             }
@@ -7861,7 +7868,7 @@
         {
           "name": "register",
           "type": "function",
-          "description": "Register a compose script programmatically",
+          "description": "Register a compose script programmatically. **Note:** Registered scripts will only be applied to newly opened message composer tabs. To apply the script to already open message composer tab, manually inject your script by calling :ref:`tabs.executeScript` for each of the open <value>messageCompose</value> tabs.",
           "async": true,
           "parameters": [
             {
@@ -7877,6 +7884,7 @@
       "permissions": [
         "messagesModify"
       ],
+      "max_manifest_version": 2,
       "types": [
         {
           "id": "RegisteredMessageDisplayScriptOptions",
@@ -13583,8 +13591,7 @@
             {
               "type": "string",
               "enum": [
-                "tabs",
-                "tabHide"
+                "tabs"
               ]
             }
           ]
@@ -14294,6 +14301,7 @@
         {
           "name": "executeScript",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Injects JavaScript code into a page. For details, see the `programmatic injection <|link-content-scripts|>`__ section of the content scripts doc.",
           "async": "callback",
           "parameters": [
@@ -14331,6 +14339,7 @@
         {
           "name": "insertCSS",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Injects CSS into a page. For details, see the `programmatic injection <|link-content-scripts|>`__ section of the content scripts doc.",
           "async": "callback",
           "parameters": [
@@ -14358,6 +14367,7 @@
         {
           "name": "removeCSS",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Removes injected CSS from a page. For details, see the `programmatic injection <|link-content-scripts|>`__ section of the content scripts doc.",
           "async": "callback",
           "parameters": [