webext-schema 5.2.9 → 5.3.0

package/modules/browser.js

@@ -989,6 +989,44 @@ export const warmupTab = async tabId => {
   }
 };
 
+/**
+ * capture visible tab
+ * @param {number} windowId - window ID
+ * @param {object} opt - options
+ * @returns {Promise.<?string>} - data URL
+ */
+export const captureVisibleTab = async (windowId, opt) => {
+  const info = await runtime.getBrowserInfo();
+  let isGranted;
+  if (info.vender === 'Mozilla') {
+    const browserVersion = parseFloat(info.version);
+    isGranted = (browserVersion >= 126 && await isPermissionGranted({
+      permissions: ['activeTab']
+    })) || await isPermissionGranted({
+      origins: ['<all_urls>']
+    });
+  } else {
+    isGranted = await isPermissionGranted({
+      permissions: ['activeTab']
+    }) || await isPermissionGranted({
+      origins: ['<all_urls>']
+    });
+  }
+  let url;
+  if (isGranted) {
+    if (!Number.isInteger(windowId)) {
+      windowId = windows.WINDOW_ID_CURRENT;
+    }
+    if (!opt) {
+      opt = {
+        format: 'png'
+      };
+    }
+    url = await tabs.captureVisibleTab(windowId, opt);
+  }
+  return url ?? null;
+};
+
 /**
  * is tab
  * @param {*} tabId - tab ID

package/package.json

@@ -20,21 +20,21 @@
     "sinon": "^17.0.1"
   },
   "devDependencies": {
-    "@types/firefox-webext-browser": "^120.0.0",
-    "@types/node": "^20.11.19",
+    "@types/firefox-webext-browser": "^120.0.3",
+    "@types/node": "^20.12.7",
     "@types/sinon": "^17.0.3",
     "c8": "^9.1.0",
     "chai": "^5.1.0",
-    "eslint": "^8.56.0",
+    "eslint": "^8.57.0",
     "eslint-config-standard": "^17.1.0",
     "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jsdoc": "^48.1.0",
-    "eslint-plugin-regexp": "^2.2.0",
-    "eslint-plugin-unicorn": "^51.0.1",
-    "mocha": "^10.3.0",
+    "eslint-plugin-jsdoc": "^48.2.3",
+    "eslint-plugin-regexp": "^2.5.0",
+    "eslint-plugin-unicorn": "^52.0.0",
+    "mocha": "^10.4.0",
     "npm-run-all": "^4.1.5",
-    "typescript": "^5.3.3",
-    "undici": "^6.6.2"
+    "typescript": "^5.4.5",
+    "undici": "^6.13.0"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -54,5 +54,5 @@
     "update-mail": "node index update --channel=mail -i",
     "update-release": "node index update --channel=release -i"
   },
-  "version": "5.2.9"
+  "version": "5.3.0"
 }

package/schemas/central/webext.json

@@ -915,6 +915,12 @@
             {
               "name": "command",
               "type": "string"
+            },
+            {
+              "name": "tab",
+              "$ref": "tags.Tab",
+              "optional": true,
+              "description": "Details of the $(ref:tabs.Tab) where the command was activated."
             }
           ]
         },
@@ -5613,9 +5619,10 @@
         {
           "name": "captureVisibleTab",
           "type": "function",
-          "description": "Captures an area of the currently active tab in the specified window. You must have $(topic:declare_permissions)[<all_urls>] permission to use this method.",
+          "description": "Captures an area of the currently active tab in the specified window. You must have <all_urls> or activeTab permission to use this method.",
           "permissions": [
-            "<all_urls>"
+            "<all_urls>",
+            "activeTab"
           ],
           "async": "callback",
           "parameters": [
@@ -13476,6 +13483,11 @@
               ],
               "optional": true
             },
+            "options_page": {
+              "$ref": "ExtensionURL",
+              "optional": true,
+              "description": "Alias property for options_ui.page, ignored when options_ui.page is set. When using this property the options page is always opened in a new tab."
+            },
             "options_ui": {
               "type": "object",
               "optional": true,
@@ -19710,6 +19722,7 @@
               "type": "string",
               "enum": [
                 "webRequest",
+                "webRequestAuthProvider",
                 "webRequestBlocking",
                 "webRequestFilterResponse",
                 "webRequestFilterResponse.serviceWorkerScript"
@@ -19800,7 +19813,7 @@
             "blocking",
             "asyncBlocking"
           ],
-          "postprocess": "webRequestBlockingPermissionRequired"
+          "postprocess": "webRequestBlockingOrAuthProviderPermissionRequired"
         },
         {
           "id": "OnResponseStartedOptions",

package/schemas/mail/mailext.json

@@ -109,6 +109,12 @@
             {
               "name": "command",
               "type": "string"
+            },
+            {
+              "name": "tab",
+              "$ref": "tags.Tab",
+              "optional": true,
+              "description": "Details of the $(ref:tabs.Tab) where the command was activated."
             }
           ]
         },
@@ -5808,51 +5814,6 @@
           "type": "object",
           "description": "Used by various functions to represent the state of a message being composed. Note that functions using this type may have a partial implementation.",
           "properties": {
-            "identityId": {
-              "type": "string",
-              "description": "The ID of an identity from the :doc:`accounts`. The settings from the identity will be used in the composed message. If ``replyTo`` is also specified, the ``replyTo`` property of the identity is overridden. The permission <permission>accountsRead</permission> is required to include the ``identityId``.",
-              "optional": true
-            },
-            "from": {
-              "$ref": "ComposeRecipient",
-              "description": "*Caution*: Setting a value for ``from`` does not change the used identity, it overrides the FROM header. Many email servers do not accept emails where the FROM header does not match the sender identity. Must be set to exactly one valid email address.",
-              "optional": true
-            },
-            "to": {
-              "$ref": "ComposeRecipientList",
-              "optional": true
-            },
-            "cc": {
-              "$ref": "ComposeRecipientList",
-              "optional": true
-            },
-            "bcc": {
-              "$ref": "ComposeRecipientList",
-              "optional": true
-            },
-            "overrideDefaultFcc": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <value>false</value> will clear the override. Setting <value>true</value> will throw an <em>ExtensionError</em>, if ``overrideDefaultFccFolder`` is not set as well."
-            },
-            "overrideDefaultFccFolder": {
-              "choices": [
-                {
-                  "$ref": "folders.MailFolderId"
-                },
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "type": "string",
-                  "enum": [
-                    ""
-                  ]
-                }
-              ],
-              "optional": true,
-              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or an empty string to not save a copy at all."
-            },
             "additionalFccFolder": {
               "choices": [
                 {
@@ -5871,58 +5832,80 @@
               "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used.",
               "optional": true
             },
-            "replyTo": {
-              "$ref": "ComposeRecipientList",
+            "attachVCard": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether or not the vCard of the used identity will be attached to the message during send. **Note:** If the value has not been modified, selecting a different identity will load the default value of the new identity."
+            },
+            "attachments": {
+              "type": "array",
+              "items": {
+                "choices": [
+                  {
+                    "$ref": "FileAttachment"
+                  },
+                  {
+                    "$ref": "ComposeAttachment"
+                  }
+                ]
+              },
+              "description": "Only used in the begin* functions. Attachments to add to the message.",
               "optional": true
             },
-            "followupTo": {
+            "bcc": {
               "$ref": "ComposeRecipientList",
               "optional": true
             },
-            "newsgroups": {
-              "description": "A single newsgroup name or an array of newsgroup names.",
-              "choices": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              ],
+            "body": {
+              "type": "string",
+              "description": "The HTML content of the message.",
               "optional": true
             },
-            "relatedMessageId": {
-              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <value>null</value> in all other cases or if the original message was opened from file.",
-              "$ref": "messages.MessageId",
+            "cc": {
+              "$ref": "ComposeRecipientList",
               "optional": true
             },
-            "subject": {
-              "type": "string",
+            "customHeaders": {
+              "type": "array",
+              "items": {
+                "$ref": "CustomHeader"
+              },
+              "description": "Array of custom headers. Headers will be returned in <em>Http-Header-Case</em> (a.k.a. <em>Train-Case</em>). Set an empty array to clear all custom headers.",
               "optional": true
             },
-            "type": {
+            "deliveryFormat": {
               "type": "string",
-              "description": "Read-only. The type of the message being composed, depending on how the compose window was opened by the user.",
               "enum": [
-                "draft",
-                "new",
-                "redirect",
-                "reply",
-                "forward"
+                "auto",
+                "plaintext",
+                "html",
+                "both"
               ],
+              "description": "Defines the MIME format of the sent message (ignored on plain text messages). Defaults to <value>auto</value>, which will send html messages as plain text, if they do not include any formatting, and as <value>both</value> otherwise (a multipart/mixed message).",
               "optional": true
             },
-            "body": {
-              "type": "string",
-              "description": "The HTML content of the message.",
+            "deliveryStatusNotification": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Let the sender know when the recipient's server received the message. Not supported by all servers."
+            },
+            "followupTo": {
+              "$ref": "ComposeRecipientList",
               "optional": true
             },
-            "plainTextBody": {
+            "from": {
+              "$ref": "ComposeRecipient",
+              "description": "*Caution*: Setting a value for ``from`` does not change the used identity, it overrides the <value>From</value> header. Many email servers do not accept emails where the <value>From</value> header does not match the sender identity. Must be set to exactly one valid email address.",
+              "optional": true
+            },
+            "identityId": {
               "type": "string",
-              "description": "The plain text content of the message.",
+              "description": "The ID of an identity from the :doc:`accounts`. The settings from the identity will be used in the composed message. If ``replyTo`` is also specified, the ``replyTo`` property of the identity is overridden. The permission <permission>accountsRead</permission> is required to include the ``identityId``.",
+              "optional": true
+            },
+            "isModified": {
+              "type": "boolean",
+              "description": "Whether the composer is considered modified by the user. A modified composer asks for confirmation, when it is closed.",
               "optional": true
             },
             "isPlainText": {
@@ -5930,23 +5913,47 @@
               "description": "Whether the message is an HTML message or a plain text message.",
               "optional": true
             },
-            "deliveryFormat": {
-              "type": "string",
-              "enum": [
-                "auto",
-                "plaintext",
-                "html",
-                "both"
+            "newsgroups": {
+              "description": "A single newsgroup name or an array of newsgroup names.",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
               ],
-              "description": "Defines the mime format of the sent message (ignored on plain text messages). Defaults to <value>auto</value>, which will send html messages as plain text, if they do not include any formatting, and as <value>both</value> otherwise (a multipart/mixed message).",
               "optional": true
             },
-            "customHeaders": {
-              "type": "array",
-              "items": {
-                "$ref": "CustomHeader"
-              },
-              "description": "Array of custom headers. Headers will be returned in <em>Http-Header-Case</em> (a.k.a. <em>Train-Case</em>). Set an empty array to clear all custom headers.",
+            "overrideDefaultFcc": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <value>false</value> will clear the override. Setting <value>true</value> will throw an <em>ExtensionError</em>, if ``overrideDefaultFccFolder`` is not set as well."
+            },
+            "overrideDefaultFccFolder": {
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    ""
+                  ]
+                }
+              ],
+              "optional": true,
+              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or an empty string to not save a copy at all."
+            },
+            "plainTextBody": {
+              "type": "string",
+              "description": "The plain text content of the message.",
               "optional": true
             },
             "priority": {
@@ -5961,34 +5968,38 @@
               "description": "The priority of the message.",
               "optional": true
             },
+            "relatedMessageId": {
+              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <value>null</value> in all other cases or if the original message was opened from file.",
+              "$ref": "messages.MessageId",
+              "optional": true
+            },
+            "replyTo": {
+              "$ref": "ComposeRecipientList",
+              "optional": true
+            },
             "returnReceipt": {
               "type": "boolean",
               "optional": true,
               "description": "Add the <em>Disposition-Notification-To</em> header to the message to requests the recipients email client to send a reply once the message has been received. Recipient server may strip the header and the recipient might ignore the request."
             },
-            "deliveryStatusNotification": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Let the sender know when the recipient's server received the message. Not supported by all servers."
+            "subject": {
+              "type": "string",
+              "optional": true
             },
-            "attachVCard": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether or not the vCard of the used identity will be attached to the message during send. **Note:** If the value has not been modified, selecting a different identity will load the default value of the new identity."
+            "to": {
+              "$ref": "ComposeRecipientList",
+              "optional": true
             },
-            "attachments": {
-              "type": "array",
-              "items": {
-                "choices": [
-                  {
-                    "$ref": "FileAttachment"
-                  },
-                  {
-                    "$ref": "ComposeAttachment"
-                  }
-                ]
-              },
-              "description": "Only used in the begin* functions. Attachments to add to the message.",
+            "type": {
+              "type": "string",
+              "description": "Read-only. The type of the message being composed, depending on how the compose window was opened by the user.",
+              "enum": [
+                "draft",
+                "new",
+                "redirect",
+                "reply",
+                "forward"
+              ],
               "optional": true
             }
           }
@@ -6040,8 +6051,7 @@
           "properties": {
             "name": {
               "type": "string",
-              "description": "Name of a custom header, must have a <value>X-</value> prefix.",
-              "pattern": "^X-.*$"
+              "description": "Name of a custom header, must be prefixed by <value>X-</value> (but not by <value>X-Mozilla-</value>) or be one of the explicitly allowed headers (<value>MSIP_Labels</value>)"
             },
             "value": {
               "type": "string"
@@ -6157,6 +6167,7 @@
                   "type": "string",
                   "description": "The used save mode.",
                   "enum": [
+                    "autoSave",
                     "draft",
                     "template"
                   ]
@@ -7591,6 +7602,17 @@
               "items": {
                 "$ref": "extensionTypes.ExtensionFileOrCode"
               }
+            },
+            "runAt": {
+              "type": "string",
+              "optional": true,
+              "default": "document_idle",
+              "enum": [
+                "document_start",
+                "document_end",
+                "document_idle"
+              ],
+              "description": "Determines when the files specified in css and js are injected. The states directly correspond to <code>Document.readyState</code>: <value>loading</value>, <value>interactive</value> and <value>complete</value>"
             }
           }
         },
@@ -11339,9 +11361,20 @@
               "type": "string",
               "optional": true
             },
+            "decryptionStatus": {
+              "type": "string",
+              "optional": true,
+              "description": "The decryption status, only available for the root part.",
+              "enum": [
+                "none",
+                "skipped",
+                "success",
+                "fail"
+              ]
+            },
             "headers": {
               "type": "object",
-              "description": "A <em>dictionary object</em> of part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>",
+              "description": "A <em>dictionary object</em> of part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>.",
               "optional": true,
               "additionalProperties": {
                 "type": "array",
@@ -11650,6 +11683,18 @@
               "name": "messageId",
               "$ref": "messages.MessageId"
             },
+            {
+              "name": "options",
+              "type": "object",
+              "properties": {
+                "decrypt": {
+                  "type": "boolean",
+                  "description": "Whether the message should be decrypted. If the message could not be decrypted, its parts are omitted. Defaults to true.",
+                  "optional": true
+                }
+              },
+              "optional": true
+            },
             {
               "type": "function",
               "name": "callback",
@@ -11676,6 +11721,11 @@
               "name": "options",
               "type": "object",
               "properties": {
+                "decrypt": {
+                  "type": "boolean",
+                  "description": "Whether the message should be decrypted. Throws, if the message could not be decrypted.",
+                  "optional": true
+                },
                 "data_format": {
                   "choices": [
                     {
@@ -11696,7 +11746,8 @@
                         "BinaryString"
                       ]
                     }
-                  ]
+                  ],
+                  "optional": true
                 }
               },
               "optional": true
@@ -12087,7 +12138,7 @@
         {
           "name": "delete",
           "type": "function",
-          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The ``skipTrash`` parameter allows immediate permanent deletion, bypassing the trash folder.\n**Note**: Consider using :ref:`messages.move` to manually move messages to the account's trash folder, instead of requesting the overly powerful permission to actually delete messages. The account's trash folder can be extracted as follows: <literalinclude>includes/messages/getTrash.js<lang>JavaScript</lang></literalinclude>",
+          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The ``skipTrash`` parameter allows immediate permanent deletion, bypassing the trash folder.",
           "async": true,
           "permissions": [
             "messagesDelete"
@@ -14002,6 +14053,95 @@
       ]
     }
   ],
+  "utilities.json": [
+    {
+      "namespace": "messengerUtilities",
+      "types": [
+        {
+          "id": "ParsedMailbox",
+          "type": "object",
+          "description": "Representation of a parsed mailbox string (see RFC 5322, section 3.4).",
+          "properties": {
+            "name": {
+              "type": "string",
+              "optional": true,
+              "description": "The <value>display-name</value> associated with the provided address or group, if available."
+            },
+            "email": {
+              "type": "string",
+              "optional": true,
+              "description": "The <value>addr-spec</value> associated with the provided address, if available."
+            },
+            "group": {
+              "type": "array",
+              "optional": true,
+              "items": {
+                "$ref": "messengerUtilities.ParsedMailbox"
+              },
+              "description": "The members of the group, if available."
+            }
+          }
+        }
+      ],
+      "functions": [
+        {
+          "name": "formatFileSize",
+          "type": "function",
+          "description": "Returns the provided file size in a human readable format (e.g. <value>12 bytes</value> or <value>11,4 GB</value>).",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "integer",
+              "name": "sizeInBytes",
+              "description": "The size in bytes."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "parseMailboxString",
+          "type": "function",
+          "description": "Parse a mailbox string containing one or more email addresses (see RFC 5322, section 3.4).",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "string",
+              "name": "mailboxString",
+              "description": "The string to be parsed (e.g. <value>User <user@example.com>, other-user@example.com</value>)"
+            },
+            {
+              "type": "boolean",
+              "name": "preserveGroups",
+              "optional": true,
+              "description": "Keep grouped hierachies. Groups may be specified in a mailbox string as follows: <value>GroupName : user1 <user1@example.com>, user2@example,com ;</value>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "messengerUtilities.ParsedMailbox"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ],
   "windows.json": [
     {
       "namespace": "windows",

package/schemas/release/webext.json

@@ -6543,307 +6543,6 @@
       ]
     }
   ],
-  "urlbar.json": [
-    {
-      "namespace": "manifest",
-      "types": [
-        {
-          "$extend": "PermissionPrivileged",
-          "choices": [
-            {
-              "type": "string",
-              "enum": [
-                "urlbar"
-              ]
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "namespace": "urlbar",
-      "description": "Use the <code>browser.urlbar</code> API to experiment with new features in the URLBar. Restricted to Mozilla privileged WebExtensions.",
-      "permissions": [
-        "urlbar"
-      ],
-      "types": [
-        {
-          "id": "EngagementState",
-          "type": "string",
-          "enum": [
-            "start",
-            "engagement",
-            "abandonment",
-            "discard"
-          ],
-          "description": "The state of an engagement made with the urlbar by the user. <code>start</code>: The user has started an engagement. <code>engagement</code>: The user has completed an engagement by picking a result. <code>abandonment</code>: The user has abandoned their engagement, for example by blurring the urlbar. <code>discard</code>: The engagement ended in a way that should be ignored by listeners."
-        },
-        {
-          "id": "Query",
-          "type": "object",
-          "description": "A query performed in the urlbar.",
-          "properties": {
-            "isPrivate": {
-              "type": "boolean",
-              "description": "Whether the query's browser context is private."
-            },
-            "maxResults": {
-              "type": "integer",
-              "description": "The maximum number of results shown to the user."
-            },
-            "searchString": {
-              "type": "string",
-              "description": "The query's search string."
-            },
-            "sources": {
-              "type": "array",
-              "description": "List of acceptable source types to return.",
-              "items": {
-                "$ref": "SourceType"
-              }
-            }
-          }
-        },
-        {
-          "id": "Result",
-          "type": "object",
-          "description": "A result of a query. Queries can have many results. Each result is created by a provider.",
-          "properties": {
-            "payload": {
-              "type": "object",
-              "description": "An object with arbitrary properties depending on the result's type."
-            },
-            "source": {
-              "$ref": "SourceType",
-              "description": "The result's source."
-            },
-            "type": {
-              "$ref": "ResultType",
-              "description": "The result's type."
-            },
-            "suggestedIndex": {
-              "type": "integer",
-              "description": "Suggest a preferred position for this result within the result set.",
-              "optional": true,
-              "default": -1
-            }
-          }
-        },
-        {
-          "id": "ResultType",
-          "type": "string",
-          "enum": [
-            "dynamic",
-            "remote_tab",
-            "search",
-            "tab",
-            "tip",
-            "url"
-          ],
-          "description": "Possible types of results. <code>dynamic</code>: A result whose view and payload are specified by the extension. <code>remote_tab</code>: A synced tab from another device. <code>search</code>: A search suggestion from a search engine. <code>tab</code>: An open tab in the browser. <code>tip</code>: An actionable message to help the user with their query. <code>url</code>: A URL that's not one of the other types."
-        },
-        {
-          "id": "SearchOptions",
-          "type": "object",
-          "description": "Options to the <code>search</code> function.",
-          "properties": {
-            "focus": {
-              "type": "boolean",
-              "optional": true,
-              "default": true,
-              "description": "Whether to focus the input field and select its contents."
-            }
-          }
-        },
-        {
-          "id": "SourceType",
-          "type": "string",
-          "enum": [
-            "bookmarks",
-            "history",
-            "local",
-            "network",
-            "search",
-            "tabs"
-          ],
-          "description": "Possible sources of results. <code>bookmarks</code>: The result comes from the user's bookmarks. <code>history</code>: The result comes from the user's history. <code>local</code>: The result comes from some local source not covered by another source type. <code>network</code>: The result comes from some network source not covered by another source type. <code>search</code>: The result comes from a search engine. <code>tabs</code>: The result is an open tab in the browser or a synced tab from another device."
-        }
-      ],
-      "properties": {
-        "engagementTelemetry": {
-          "$ref": "types.Setting",
-          "description": "Enables or disables the engagement telemetry."
-        }
-      },
-      "functions": [
-        {
-          "name": "closeView",
-          "type": "function",
-          "async": true,
-          "description": "Closes the urlbar view in the current window.",
-          "parameters": []
-        },
-        {
-          "name": "focus",
-          "type": "function",
-          "async": true,
-          "description": "Focuses the urlbar in the current window.",
-          "parameters": [
-            {
-              "name": "select",
-              "type": "boolean",
-              "optional": true,
-              "default": false,
-              "description": "If true, the text in the urlbar will also be selected."
-            }
-          ]
-        },
-        {
-          "name": "search",
-          "type": "function",
-          "async": true,
-          "description": "Starts a search in the urlbar in the current window.",
-          "parameters": [
-            {
-              "name": "searchString",
-              "type": "string",
-              "description": "The search string."
-            },
-            {
-              "name": "options",
-              "$ref": "SearchOptions",
-              "optional": true,
-              "default": {},
-              "description": "Options for the search."
-            }
-          ]
-        }
-      ],
-      "events": [
-        {
-          "name": "onBehaviorRequested",
-          "type": "function",
-          "description": "Before a query starts, this event is fired for the given provider. Its purpose is to request the provider's behavior for the query. The listener should return a behavior in response. By default, providers are inactive, so if your provider should always be inactive, you don't need to listen for this event.",
-          "parameters": [
-            {
-              "name": "query",
-              "$ref": "Query",
-              "description": "The query for which the behavior is requested."
-            }
-          ],
-          "extraParameters": [
-            {
-              "name": "providerName",
-              "type": "string",
-              "pattern": "^[a-zA-Z0-9_-]+$",
-              "description": "The name of the provider whose behavior the listener returns."
-            }
-          ],
-          "returns": {
-            "type": "string",
-            "enum": [
-              "active",
-              "inactive",
-              "restricting"
-            ],
-            "description": "The behavior of the provider for the query."
-          }
-        },
-        {
-          "name": "onEngagement",
-          "type": "function",
-          "description": "This event is fired when the user starts and ends an engagement with the urlbar.",
-          "parameters": [
-            {
-              "name": "state",
-              "$ref": "EngagementState",
-              "description": "The state of the engagement."
-            }
-          ],
-          "extraParameters": [
-            {
-              "name": "providerName",
-              "type": "string",
-              "pattern": "^[a-zA-Z0-9_-]+$",
-              "description": "The name of the provider that will listen for engagement events."
-            }
-          ]
-        },
-        {
-          "name": "onQueryCanceled",
-          "type": "function",
-          "description": "This event is fired for the given provider when a query is canceled. The listener should stop any ongoing fetch or creation of results and clean up its resources.",
-          "parameters": [
-            {
-              "name": "query",
-              "$ref": "Query",
-              "description": "The query that was canceled."
-            }
-          ],
-          "extraParameters": [
-            {
-              "name": "providerName",
-              "type": "string",
-              "pattern": "^[a-zA-Z0-9_-]+$",
-              "description": "The name of the provider that is creating results for the query."
-            }
-          ]
-        },
-        {
-          "name": "onResultsRequested",
-          "type": "function",
-          "description": "When a query starts, this event is fired for the given provider if the provider is active for the query and there are no other providers that are restricting. Its purpose is to request the provider's results for the query. The listener should return a list of results in response.",
-          "parameters": [
-            {
-              "name": "query",
-              "$ref": "Query",
-              "description": "The query for which results are requested."
-            }
-          ],
-          "extraParameters": [
-            {
-              "name": "providerName",
-              "type": "string",
-              "pattern": "^[a-zA-Z0-9_-]+$",
-              "description": "The name of the provider whose results the listener returns."
-            }
-          ],
-          "returns": {
-            "type": "array",
-            "items": {
-              "$ref": "Result"
-            },
-            "description": "The results that the provider fetched for the query."
-          }
-        },
-        {
-          "name": "onResultPicked",
-          "type": "function",
-          "description": "Typically, a provider includes a <code>url</code> property in its results' payloads. When the user picks a result with a URL, Firefox automatically loads the URL. URLs don't make sense for every result type, however. When the user picks a result without a URL, this event is fired. The provider should take an appropriate action in response. Currently the only applicable <code>ResultTypes</code> are <code>dynamic</code> and <code>tip</code>.",
-          "parameters": [
-            {
-              "name": "payload",
-              "type": "object",
-              "description": "The payload of the result that was picked."
-            },
-            {
-              "name": "elementName",
-              "type": "string",
-              "description": "If the result is a dynamic type, this is the name of the element in the result view that was picked. If the result is not a dynamic type, this is an empty string."
-            }
-          ],
-          "extraParameters": [
-            {
-              "name": "providerName",
-              "type": "string",
-              "pattern": "^[a-zA-Z0-9_-]+$",
-              "description": "The listener will be called for the results of the provider with this name."
-            }
-          ]
-        }
-      ]
-    }
-  ],
   "windows.json": [
     {
       "namespace": "windows",
@@ -16209,6 +15908,24 @@
             "os_update",
             "periodic"
           ]
+        },
+        {
+          "id": "OnPerformanceWarningCategory",
+          "type": "string",
+          "enum": [
+            "content_script"
+          ],
+          "description": "The performance warning event category, e.g. 'content_script'."
+        },
+        {
+          "id": "OnPerformanceWarningSeverity",
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high"
+          ],
+          "description": "The performance warning event severity. Will be 'high' for serious and user-visible issues."
         }
       ],
       "properties": {
@@ -16786,6 +16503,36 @@
               "description": "The reason that the event is being dispatched."
             }
           ]
+        },
+        {
+          "name": "onPerformanceWarning",
+          "type": "function",
+          "description": "Fired when a runtime performance issue is detected with the extension. Observe this event to be proactively notified of runtime performance problems with the extension.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "details",
+              "properties": {
+                "category": {
+                  "$ref": "OnPerformanceWarningCategory",
+                  "description": "The performance warning event category, e.g. 'content_script'."
+                },
+                "severity": {
+                  "$ref": "OnPerformanceWarningSeverity",
+                  "description": "The performance warning event severity, e.g. 'high'."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "description": "The $(ref:tabs.Tab) that the performance warning relates to, if any."
+                },
+                "description": {
+                  "type": "string",
+                  "description": "An explanation of what the warning means, and hopefully how to address it."
+                }
+              }
+            }
+          ]
         }
       ]
     }

package/types/modules/browser.d.ts

@@ -50,6 +50,7 @@ export function reloadTab(tabId: number, opt: object): Promise<void>;
 export function removeTab(arg: number | any[]): Promise<void>;
 export function updateTab(tabId: number, opt: object): Promise<object>;
 export function warmupTab(tabId: number): Promise<void>;
+export function captureVisibleTab(windowId: number, opt: object): Promise<string | null>;
 export function isTab(tabId: any): Promise<boolean>;
 export function getCurrentTheme(windowId?: number): Promise<object>;
 export function createNewWindow(opt: object): Promise<object>;