webext-schema 5.6.0 → 6.0.0

package/modules/browser.js

@@ -428,7 +428,7 @@ export const makeConnection = async (id, info) => {
 /**
  * send message
  * @param {number|string} id - tab ID / extension ID
- * @param {*} msg - message
+ * @param {string|Array|object} msg - message
  * @param {object} opt - options
  * @returns {Promise.<object>} - tabs.sendMessage() | runtime.sendMessage()
  */
@@ -679,7 +679,7 @@ export const getAllStorage = async (area = 'local') => {
 
 /**
  * get storage
- * @param {*} key - key
+ * @param {string|Array|object} key - key
  * @param {string} area - storage area
  * @returns {Promise.<object>} - stored data
  */
@@ -698,7 +698,7 @@ export const getStorage = async (key, area = 'local') => {
 
 /**
  * remove storage
- * @param {*} key - key
+ * @param {string|Array|object} key - key
  * @param {string} area - storage area
  * @returns {Promise.<void>} - void
  */
@@ -814,7 +814,7 @@ export const execScriptToTabs = async (opt = {}) => {
  * execute scripts to tab in order
  * @param {number|Array} tabId - tabId or array of options
  * @param {Array} opts - array of options
- * @returns {Promise.<*>} - result of the last executed script
+ * @returns {Promise.<?Array|boolean>} - result of the last executed script
  */
 export const execScriptsToTabInOrder = async (tabId, opts = []) => {
   const func = [];
@@ -1058,7 +1058,7 @@ export const captureVisibleTab = async (windowId, opt) => {
 
 /**
  * is tab
- * @param {*} tabId - tab ID
+ * @param {number} tabId - tab ID
  * @returns {Promise.<boolean>} - result
  */
 export const isTab = async tabId => {

package/modules/common.js

@@ -9,7 +9,7 @@ const TYPE_TO = -1;
 /**
  * throw error
  * @param {!object} e - Error
- * @throws - Error
+ * @throws {Error} - Error
  */
 export const throwErr = e => {
   throw e;
@@ -27,7 +27,7 @@ export const logErr = e => {
 
 /**
  * log warn
- * @param {*} msg - message
+ * @param {string|object} msg - message
  * @returns {boolean} - false
  */
 export const logWarn = msg => {
@@ -37,8 +37,8 @@ export const logWarn = msg => {
 
 /**
  * log message
- * @param {*} msg - message
- * @returns {*} - message
+ * @param {string|object} msg - message
+ * @returns {string|object} - message
  */
 export const logMsg = msg => {
   msg && console.log(msg);
@@ -47,7 +47,7 @@ export const logMsg = msg => {
 
 /**
  * get type
- * @param {*} o - object to check
+ * @param {object} o - object to check
  * @returns {string} - type of object
  */
 export const getType = o =>
@@ -55,7 +55,7 @@ export const getType = o =>
 
 /**
  * is object, and not an empty object
- * @param {*} o - object to check;
+ * @param {object} o - object to check;
  * @returns {boolean} - result
  */
 export const isObjectNotEmpty = o => {
@@ -65,7 +65,7 @@ export const isObjectNotEmpty = o => {
 
 /**
  * is string
- * @param {*} o - object to check
+ * @param {object} o - object to check
  * @returns {boolean} - result
  */
 export const isString = o => typeof o === 'string' || o instanceof String;

package/modules/schema.js

@@ -23,13 +23,13 @@ export class Schema {
    * @param {...(string|object)} [args] - optional arguments
    *                                      {string} - release channel.
    *                                                 one of "beta", "central",
-   *                                                 "release", "esr", "mail".
+   *                                                 "esr", "mail".
    *                                      {object} - sinon config
    */
   constructor(...args) {
     const [arg1, arg2] = args;
     this.#channel =
-      isString(arg1) && /(?:centra|mai)l|beta|esr|release/.test(arg1)
+      isString(arg1) && /(?:centra|mai)l|beta|esr/.test(arg1)
         ? arg1
         : 'beta';
     this._sandbox =
@@ -48,7 +48,7 @@ export class Schema {
   }
 
   set channel(ch) {
-    if (isString(ch) && /(?:centra|mai)l|beta|esr|release/.test(ch)) {
+    if (isString(ch) && /(?:centra|mai)l|beta|esr/.test(ch)) {
       this.#channel = ch;
     }
   }
@@ -206,12 +206,12 @@ export class Schema {
       const { $ref, properties, type, unsupported } = item;
       if (!unsupported) {
         $ref && this._refMap.set(`${namespace}.${key}`, { $ref, namespace });
-        if (Object.prototype.hasOwnProperty.call(item, 'value')) {
+        if (Object.hasOwn(item, 'value')) {
           target[key] = item.value;
         } else if (type === 'function') {
           target[key] = this._sandbox.stub();
         } else if (type === 'object' || $ref ||
-                   Object.prototype.hasOwnProperty.call(item, 'properties')) {
+                   Object.hasOwn(item, 'properties')) {
           target[key] ??= {};
           properties && this._mockProperties(
             target[key], properties, `${namespace}.${key}`

package/modules/update.js

@@ -51,9 +51,6 @@ export const getChannelUrl = channel => {
     case 'mail':
       dir = 'comm-central/';
       break;
-    case 'release':
-      dir = 'releases/mozilla-release/';
-      break;
     default:
       dir = 'releases/mozilla-beta/';
   }
@@ -278,7 +275,6 @@ export const updateSchemas = async (cmdOpts = {}) => {
       saveSchemaFile('beta', info),
       saveSchemaFile('central', info),
       saveSchemaFile('esr', info),
-      saveSchemaFile('release', info),
       saveSchemaFile('mail', info)
     );
   }

package/package.json

@@ -19,26 +19,26 @@
   "types": "types/index.d.ts",
   "dependencies": {
     "camelize": "^1.0.1",
-    "commander": "^14.0.0",
-    "decamelize": "^6.0.0",
+    "commander": "^14.0.1",
+    "decamelize": "^6.0.1",
     "json5": "^2.2.3",
-    "sinon": "^20.0.0"
+    "sinon": "^21.0.0"
   },
   "devDependencies": {
-    "@types/firefox-webext-browser": "^120.0.4",
-    "@types/node": "^22.15.21",
+    "@types/firefox-webext-browser": "^120.0.5",
+    "@types/node": "^24.6.2",
     "@types/sinon": "^17.0.4",
     "c8": "^10.1.3",
-    "eslint": "^9.27.0",
-    "eslint-plugin-jsdoc": "^50.6.17",
-    "eslint-plugin-regexp": "^2.7.0",
-    "eslint-plugin-unicorn": "^59.0.1",
-    "globals": "^16.2.0",
-    "mocha": "^11.5.0",
-    "neostandard": "^0.12.1",
+    "eslint": "^9.37.0",
+    "eslint-plugin-jsdoc": "^60.8.0",
+    "eslint-plugin-regexp": "^2.10.0",
+    "eslint-plugin-unicorn": "^61.0.2",
+    "globals": "^16.4.0",
+    "mocha": "^11.7.4",
+    "neostandard": "^0.12.2",
     "npm-run-all2": "^8.0.4",
-    "typescript": "^5.8.3",
-    "undici": "^7.10.0"
+    "typescript": "^5.9.3",
+    "undici": "^7.16.0"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -55,8 +55,7 @@
     "update:beta": "node index update --channel=beta -i",
     "update:central": "node index update --channel=central -i",
     "update:esr": "node index update --channel=esr -i",
-    "update:mail": "node index update --channel=mail -i",
-    "update:release": "node index update --channel=release -i"
+    "update:mail": "node index update --channel=mail -i"
   },
-  "version": "5.6.0"
+  "version": "6.0.0"
 }

package/schemas/beta/webext.json

@@ -4434,7 +4434,6 @@
             {
               "type": "object",
               "name": "queryInfo",
-              "optional": true,
               "properties": {
                 "collapsed": {
                   "type": "boolean",
@@ -4543,6 +4542,16 @@
             {
               "$ref": "TabGroup",
               "name": "group"
+            },
+            {
+              "type": "object",
+              "name": "removeInfo",
+              "properties": {
+                "isWindowClosing": {
+                  "type": "boolean",
+                  "description": "True when the tab group is being closed because its window is being closed."
+                }
+              }
             }
           ]
         },
@@ -5059,6 +5068,10 @@
             "windowId": {
               "type": "integer",
               "optional": true
+            },
+            "cookieStoreId": {
+              "type": "string",
+              "optional": true
             }
           }
         }
@@ -6434,6 +6447,12 @@
                   ],
                   "description": "The tab's new favicon URL. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission."
                 },
+                "groupId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -1,
+                  "description": "The tab's new group ID. $(ref:tabGroups.TAB_GROUP_ID_NONE) (-1) if the tab no longer belongs to a tab group."
+                },
                 "hidden": {
                   "type": "boolean",
                   "optional": true,
@@ -8287,6 +8306,24 @@
               "optional": true
             }
           ]
+        },
+        {
+          "name": "onUserSettingsChanged",
+          "type": "function",
+          "description": "Fired when user-specified settings relating to an extension's action change.",
+          "parameters": [
+            {
+              "name": "change",
+              "type": "object",
+              "properties": {
+                "isOnToolbar": {
+                  "type": "boolean",
+                  "description": "Whether the extension's action icon is visible on browser windows' top-level toolbar (i.e., whether the extension has been 'pinned' by the user).",
+                  "optional": true
+                }
+              }
+            }
+          ]
         }
       ]
     },
@@ -8427,6 +8464,10 @@
         "zoomSiteSpecific": {
           "$ref": "types.Setting",
           "description": "This boolean setting controls whether zoom is applied on a per-site basis or to the current tab only. If privacy.resistFingerprinting is true, this setting has no effect and zoom is applied to the current tab only."
+        },
+        "verticalTabs": {
+          "$ref": "types.Setting",
+          "description": "This boolean setting controls whether vertical tabs are enabled."
         }
       }
     },
@@ -9081,6 +9122,11 @@
               "optional": true,
               "description": "The JavaScript world for a script to execute within. Defaults to \"ISOLATED\"."
             },
+            "cssOrigin": {
+              "$ref": "extensionTypes.CSSOrigin",
+              "optional": true,
+              "description": "The css origin of the stylesheet to inject. Defaults to \"author\"."
+            },
             "cookieStoreId": {
               "choices": [
                 {
@@ -9410,6 +9456,7 @@
           "id": "SameSiteStatus",
           "type": "string",
           "enum": [
+            "unspecified",
             "no_restriction",
             "lax",
             "strict"
@@ -9703,7 +9750,7 @@
                   "$ref": "SameSiteStatus",
                   "optional": true,
                   "description": "The cookie's same-site status.",
-                  "default": "no_restriction"
+                  "default": "unspecified"
                 },
                 "expirationDate": {
                   "type": "number",
@@ -9957,7 +10004,7 @@
         {
           "id": "ResourceType",
           "type": "string",
-          "description": "How the requested resource will be used. Comparable to the webRequest.ResourceType type.",
+          "description": "How the requested resource will be used. Comparable to the webRequest.ResourceType type. object_subrequest is unsupported.",
           "enum": [
             "main_frame",
             "sub_frame",
@@ -12528,7 +12575,8 @@
             "user",
             "author"
           ],
-          "description": "The origin of the CSS to inject, this affects the cascading order (priority) of the stylesheet."
+          "description": "The origin of the CSS to inject, this affects the cascading order (priority) of the stylesheet.",
+          "preprocess": "stringToLowerCase"
         },
         {
           "id": "InjectDetails",
@@ -12570,6 +12618,7 @@
             "cssOrigin": {
               "$ref": "CSSOrigin",
               "optional": true,
+              "default": "author",
               "description": "The css origin of the stylesheet to inject. Defaults to \"author\"."
             }
           }
@@ -13019,6 +13068,28 @@
             "description": "Message localized for current locale."
           }
         },
+        {
+          "name": "getPreferredSystemLanguages",
+          "type": "function",
+          "async": "callback",
+          "description": "Gets the preferred locales of the operating system. This is different from the locales set in the browser; to get those, use $(ref:i18n.getAcceptLanguages).",
+          "parameters": [
+            {
+              "type": "function",
+              "name": "callback",
+              "parameters": [
+                {
+                  "name": "languages",
+                  "type": "array",
+                  "items": {
+                    "$ref": "LanguageCode"
+                  },
+                  "description": "Array of LanguageCode"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "getUILanguage",
           "type": "function",
@@ -14323,12 +14394,13 @@
               "enum": [
                 "authenticationInfo",
                 "bookmarksInfo",
-                "browsingHistory",
+                "browsingActivity",
                 "financialAndPaymentInfo",
                 "healthInfo",
                 "locationInfo",
                 "personalCommunications",
                 "personallyIdentifyingInfo",
+                "searchTerms",
                 "websiteActivity",
                 "websiteContent"
               ]
@@ -14487,6 +14559,11 @@
                   },
                   "optional": true,
                   "default": []
+                },
+                "has_previous_consent": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": false
                 }
               }
             }
@@ -14634,6 +14711,11 @@
                 "$ref": "ExtensionURL"
               }
             },
+            "css_origin": {
+              "$ref": "extensionTypes.CSSOrigin",
+              "default": "author",
+              "optional": true
+            },
             "js": {
               "type": "array",
               "optional": true,
@@ -16536,6 +16618,7 @@
             "aarch64",
             "arm",
             "ppc64",
+            "riscv64",
             "s390x",
             "sparc64",
             "x86-32",
@@ -17568,6 +17651,10 @@
               "items": {
                 "$ref": "manifest.ExtensionURL"
               }
+            },
+            "cssOrigin": {
+              "$ref": "extensionTypes.CSSOrigin",
+              "optional": true
             }
           }
         }
@@ -17825,7 +17912,6 @@
             },
             {
               "name": "getBytesInUse",
-              "unsupported": true,
               "type": "function",
               "description": "Gets the amount of space (in bytes) being used by one or more items.",
               "async": "callback",
@@ -17861,173 +17947,23 @@
               ]
             },
             {
-              "name": "set",
+              "name": "getKeys",
               "type": "function",
-              "description": "Sets multiple items.",
+              "description": "Gets the keys of all items in storage.",
               "async": "callback",
               "parameters": [
-                {
-                  "name": "items",
-                  "type": "object",
-                  "additionalProperties": {
-                    "type": "any"
-                  },
-                  "description": "<p>An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.</p><p>Primitive values such as numbers will serialize as expected. Values with a <code>typeof</code> <code>\"object\"</code> and <code>\"function\"</code> will typically serialize to <code>{}</code>, with the exception of <code>Array</code> (serializes as expected), <code>Date</code>, and <code>Regex</code> (serialize using their <code>String</code> representation).</p>"
-                },
                 {
                   "name": "callback",
                   "type": "function",
-                  "description": "Callback on success, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [],
-                  "optional": true
-                }
-              ]
-            },
-            {
-              "name": "remove",
-              "type": "function",
-              "description": "Removes one or more items from storage.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "keys",
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A single key or a list of keys for items to remove."
-                },
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback on success, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [],
-                  "optional": true
-                }
-              ]
-            },
-            {
-              "name": "clear",
-              "type": "function",
-              "description": "Removes all items from storage.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback on success, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [],
-                  "optional": true
-                }
-              ]
-            }
-          ],
-          "events": [
-            {
-              "name": "onChanged",
-              "type": "function",
-              "description": "Fired when one or more items change.",
-              "parameters": [
-                {
-                  "name": "changes",
-                  "type": "object",
-                  "additionalProperties": {
-                    "$ref": "StorageChange"
-                  },
-                  "description": "Object mapping each key that changed to its corresponding $(ref:storage.StorageChange) for that item."
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "id": "StorageAreaWithUsage",
-          "type": "object",
-          "functions": [
-            {
-              "name": "get",
-              "type": "function",
-              "description": "Gets one or more items from storage.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "keys",
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    },
-                    {
-                      "type": "object",
-                      "description": "Storage items to return in the callback, where the values are replaced with those from storage if they exist.",
-                      "additionalProperties": {
-                        "type": "any"
-                      }
-                    }
-                  ],
-                  "description": "A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object).  An empty list or object will return an empty result object.  Pass in <code>null</code> to get the entire contents of storage.",
-                  "optional": true
-                },
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback with storage items, or on failure (in which case $(ref:runtime.lastError) will be set).",
+                  "description": "Callback with the keys of all items in storage, or on failure (in which case $(ref:runtime.lastError) will be set).",
                   "parameters": [
                     {
-                      "name": "items",
-                      "type": "object",
-                      "additionalProperties": {
-                        "type": "any"
-                      },
-                      "description": "Object with items in their key-value mappings."
-                    }
-                  ]
-                }
-              ]
-            },
-            {
-              "name": "getBytesInUse",
-              "type": "function",
-              "description": "Gets the amount of space (in bytes) being used by one or more items.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "keys",
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
+                      "name": "keys",
                       "type": "array",
                       "items": {
                         "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A single key or list of keys to get the total usage for. An empty list will return 0. Pass in <code>null</code> to get the total usage of all of storage.",
-                  "optional": true
-                },
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback with the amount of space being used by storage, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [
-                    {
-                      "name": "bytesInUse",
-                      "type": "integer",
-                      "description": "Amount of space being used in storage, in bytes."
+                      },
+                      "description": "The keys of all items in storage."
                     }
                   ]
                 }
@@ -18145,7 +18081,7 @@
       ],
       "properties": {
         "sync": {
-          "$ref": "StorageAreaWithUsage",
+          "$ref": "StorageArea",
           "description": "Items in the <code>sync</code> storage area are synced by the browser.",
           "properties": {
             "QUOTA_BYTES": {
@@ -18199,7 +18135,7 @@
           "allowedContexts": [
             "devtools"
           ],
-          "$ref": "StorageAreaWithUsage",
+          "$ref": "StorageArea",
           "description": "Items in the <code>session</code> storage area are kept in memory, and only until the either browser or extension is closed or reloaded.",
           "properties": {
             "QUOTA_BYTES": {
@@ -20906,7 +20842,6 @@
             "script",
             "image",
             "object",
-            "object_subrequest",
             "xmlhttprequest",
             "xslt",
             "ping",
@@ -21333,7 +21268,6 @@
             "cryptomining_content",
             "emailtracking",
             "emailtracking_content",
-            "consentmanager",
             "tracking",
             "tracking_ad",
             "tracking_analytics",
@@ -21341,7 +21275,9 @@
             "tracking_content",
             "any_basic_tracking",
             "any_strict_tracking",
-            "any_social_tracking"
+            "any_social_tracking",
+            "consentmanager",
+            "antifraud"
           ],
           "description": "Tracking flags that match our internal tracking classification"
         },