webext-schema 5.2.10 → 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

@@ -21,20 +21,20 @@
   },
   "devDependencies": {
     "@types/firefox-webext-browser": "^120.0.3",
-    "@types/node": "^20.11.30",
+    "@types/node": "^20.12.7",
     "@types/sinon": "^17.0.3",
     "c8": "^9.1.0",
     "chai": "^5.1.0",
     "eslint": "^8.57.0",
     "eslint-config-standard": "^17.1.0",
     "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jsdoc": "^48.2.1",
-    "eslint-plugin-regexp": "^2.3.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.4.2",
-    "undici": "^6.9.0"
+    "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.10"
+  "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."
             }
           ]
         },
@@ -7596,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>"
             }
           }
         },

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>;