webext-schema 5.1.8 → 5.1.10

package/README.md

@@ -9,13 +9,13 @@ Stubbed browser API is also available.
 
 ## Install
 
-```
+```console
 npm i webext-schema
 ```
 
 ## Usage
 
-```
+```javascript
 import { Schema } from 'webext-schema';
 
 const schema = new Schema();
@@ -28,7 +28,7 @@ const schema = new Schema();
 
 Both arguments are optional.
 
-```
+```javascript
 const schema = new Schema("central", {
   useFakeTimers: true,
   useFakeServer: true,
@@ -40,13 +40,13 @@ const schema = new Schema("central", {
 "central", "beta", "release", "esr" for WebExtensions, and "mail" for MailExtensions are available.
 Channel defaults to "beta".
 
-```
+```javascript
 const schema = new Schema("central");
 ```
 
 Also, you can set it afterwards.
 
-```
+```javascript
 const schema = new Schema();
 schema.channel = "central";
 ```
@@ -59,12 +59,12 @@ schema.channel = "central";
 Get the schema for the specific API.
 Argument can be either an API name or a file name.
 
-```
+```javascript
 const schema = new Schema().get("browserAction");
 // [{namespace: "browserAction", events: [...], ...}]
 ```
 
-```
+```javascript
 const schema = new Schema().get("browser_action.json");
 // [{namespace: "browserAction", events: [...], ...}]
 ```
@@ -76,7 +76,7 @@ const schema = new Schema().get("browser_action.json");
 Get all schemas as a single object.
 Note that the key of the object is the file name and the value is the schema.
 
-```
+```javascript
 const schema = new Schema().getAll();
 // {"alarms.json": [{...}], "bookmarks.json": [{...}], ...}
 ```
@@ -87,7 +87,7 @@ const schema = new Schema().getAll();
 
 Get the list of schema files.
 
-```
+```javascript
 const list = new Schema().list();
 // ["alarms.json", "bookmarks.json", ...]
 ```
@@ -105,18 +105,18 @@ Creates stubbed browser API.
 
 See [Sinon.JS](https://sinonjs.org/) for details of sinon.sandbox.
 
-```
+```javascript
 const browser = new Schema().mock();
 
 // example of mocking runtime.connect()
-const mockConnect = browser.runtime.connect.callsFake(({name}) => {
+const mockConnect = browser.runtime.connect.callsFake(({ name }) => {
   const port = Object.assign({}, browser.runtime.Port);
   port.name = name;
   return port;
 });
 
-const port1 = mockConnect({name: "foo"});
-const port2 = mockConnect({name: "bar"});
+const port1 = mockConnect({ name: "foo" });
+const port2 = mockConnect({ name: "bar" });
 assert.strictEqual(port1.name, "foo");
 assert.isFunction(port1.onDisconnect.addListener);
 assert.strictEqual(port2.name, "bar");

package/package.json

@@ -13,30 +13,30 @@
   "main": "index.js",
   "types": "types/index.d.ts",
   "dependencies": {
-    "@types/firefox-webext-browser": "^109.0.0",
-    "@types/node": "^18.14.2",
+    "@types/firefox-webext-browser": "^111.0.0",
+    "@types/node": "^18.15.2",
     "@types/sinon": "^10.0.13",
     "camelize": "^1.0.1",
     "commander": "^10.0.0",
     "decamelize": "^6.0.0",
     "json5": "^2.2.3",
-    "sinon": "^15.0.1"
+    "sinon": "^15.0.2"
   },
   "devDependencies": {
     "c8": "^7.13.0",
     "chai": "^4.3.7",
-    "eslint": "^8.35.0",
+    "eslint": "^8.36.0",
     "eslint-config-standard": "^17.0.0",
     "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-jsdoc": "^40.0.0",
+    "eslint-plugin-jsdoc": "^40.0.1",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-promise": "^6.1.1",
     "eslint-plugin-regexp": "^1.12.0",
-    "eslint-plugin-unicorn": "^45.0.2",
+    "eslint-plugin-unicorn": "^46.0.0",
     "mocha": "^10.2.0",
     "npm-run-all": "^4.1.5",
     "typescript": "^4.9.5",
-    "undici": "^5.20.0"
+    "undici": "^5.21.0"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -56,5 +56,5 @@
     "update-mail": "node index update --channel=mail -i",
     "update-release": "node index update --channel=release -i"
   },
-  "version": "5.1.8"
+  "version": "5.1.10"
 }

package/schemas/beta/webext.json

@@ -9721,13 +9721,24 @@
             }
           ]
         },
+        {
+          "$extend": "OptionalPermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "declarativeNetRequestFeedback"
+              ],
+              "min_manifest_version": 3
+            }
+          ]
+        },
         {
           "$extend": "PermissionNoPrompt",
           "choices": [
             {
               "type": "string",
               "enum": [
-                "declarativeNetRequestFeedback",
                 "declarativeNetRequestWithHostAccess"
               ],
               "min_manifest_version": 3
@@ -9811,6 +9822,15 @@
             "other"
           ]
         },
+        {
+          "id": "UnsupportedRegexReason",
+          "type": "string",
+          "description": "Describes the reason why a given regular expression isn't supported.",
+          "enum": [
+            "syntaxError",
+            "memoryLimitExceeded"
+          ]
+        },
         {
           "id": "MatchedRule",
           "type": "object",
@@ -10093,7 +10113,7 @@
                     "regexSubstitution": {
                       "type": "string",
                       "optional": true,
-                      "description": "TODO with regexFilter + Substitution pattern for rules which specify a 'regexFilter'."
+                      "description": "Substitution pattern for rules which specify a 'regexFilter'. The first match of regexFilter within the url will be replaced with this pattern. Within regexSubstitution, backslash-escaped digits (\\1 to \\9) can be used to insert the corresponding capture groups. \\0 refers to the entire matching text."
                     }
                   }
                 },
@@ -10349,6 +10369,57 @@
             }
           ]
         },
+        {
+          "name": "isRegexSupported",
+          "type": "function",
+          "description": "Checks if the given regular expression will be supported as a 'regexFilter' rule condition.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "regexOptions",
+              "type": "object",
+              "properties": {
+                "regex": {
+                  "type": "string",
+                  "description": "The regular expresson to check."
+                },
+                "isCaseSensitive": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the 'regex' specified is case sensitive.",
+                  "default": false
+                },
+                "requireCapturing": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the 'regex' specified requires capturing. Capturing is only required for redirect rules which specify a 'regexSubstition' action.",
+                  "default": false
+                }
+              }
+            },
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "result",
+                  "type": "object",
+                  "properties": {
+                    "isSupported": {
+                      "type": "boolean",
+                      "description": "Whether the given regex is supported"
+                    },
+                    "reason": {
+                      "$ref": "UnsupportedRegexReason",
+                      "optional": true,
+                      "description": "Specifies the reason why the regular expression is not supported. Only provided if 'isSupported' is false."
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "testMatchOutcome",
           "type": "function",
@@ -10447,6 +10518,10 @@
           "type": "number",
           "description": "The maximum number of dynamic and session rules an extension can add. NOTE: in the Firefox we are enforcing this limit to the session and dynamic rules count separately, instead of enforcing it to the rules count for both combined as the Chrome implementation does."
         },
+        "MAX_NUMBER_OF_REGEX_RULES": {
+          "type": "number",
+          "description": "The maximum number of regular expression rules that an extension can add. This limit is evaluated separately for the set of session rules, dynamic rules and those specified in the rule_resources file."
+        },
         "SESSION_RULESET_ID": {
           "type": "string",
           "value": "_session",
@@ -12415,7 +12490,7 @@
             "mainthreadio",
             "fileio",
             "fileioall",
-            "noiostacks",
+            "nomarkerstacks",
             "screenshots",
             "seqstyle",
             "stackwalk",
@@ -13572,6 +13647,14 @@
                         "$ref": "ExtensionURL"
                       }
                     },
+                    "type": {
+                      "optional": true,
+                      "type": "string",
+                      "enum": [
+                        "module",
+                        "classic"
+                      ]
+                    },
                     "persistent": {
                       "optional": true,
                       "type": "boolean",
@@ -20148,6 +20231,26 @@
               },
               "description": "list of reasons that cause the request to be considered weak, if state is \"weak\"",
               "optional": true
+            },
+            "usedEch": {
+              "type": "boolean",
+              "description": "True if the TLS connection used Encrypted Client Hello.",
+              "optional": true
+            },
+            "usedDelegatedCredentials": {
+              "type": "boolean",
+              "description": "True if the TLS connection used Delegated Credentials.",
+              "optional": true
+            },
+            "usedOcsp": {
+              "type": "boolean",
+              "description": "True if the TLS connection made OCSP requests.",
+              "optional": true
+            },
+            "usedPrivateDns": {
+              "type": "boolean",
+              "description": "True if the TLS connection used a privacy-preserving DNS transport like DNS-over-HTTPS.",
+              "optional": true
             }
           }
         },

package/schemas/central/webext.json

@@ -9822,6 +9822,15 @@
             "other"
           ]
         },
+        {
+          "id": "UnsupportedRegexReason",
+          "type": "string",
+          "description": "Describes the reason why a given regular expression isn't supported.",
+          "enum": [
+            "syntaxError",
+            "memoryLimitExceeded"
+          ]
+        },
         {
           "id": "MatchedRule",
           "type": "object",
@@ -10104,7 +10113,7 @@
                     "regexSubstitution": {
                       "type": "string",
                       "optional": true,
-                      "description": "TODO with regexFilter + Substitution pattern for rules which specify a 'regexFilter'."
+                      "description": "Substitution pattern for rules which specify a 'regexFilter'. The first match of regexFilter within the url will be replaced with this pattern. Within regexSubstitution, backslash-escaped digits (\\1 to \\9) can be used to insert the corresponding capture groups. \\0 refers to the entire matching text."
                     }
                   }
                 },
@@ -10360,6 +10369,57 @@
             }
           ]
         },
+        {
+          "name": "isRegexSupported",
+          "type": "function",
+          "description": "Checks if the given regular expression will be supported as a 'regexFilter' rule condition.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "regexOptions",
+              "type": "object",
+              "properties": {
+                "regex": {
+                  "type": "string",
+                  "description": "The regular expresson to check."
+                },
+                "isCaseSensitive": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the 'regex' specified is case sensitive.",
+                  "default": false
+                },
+                "requireCapturing": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the 'regex' specified requires capturing. Capturing is only required for redirect rules which specify a 'regexSubstition' action.",
+                  "default": false
+                }
+              }
+            },
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "result",
+                  "type": "object",
+                  "properties": {
+                    "isSupported": {
+                      "type": "boolean",
+                      "description": "Whether the given regex is supported"
+                    },
+                    "reason": {
+                      "$ref": "UnsupportedRegexReason",
+                      "optional": true,
+                      "description": "Specifies the reason why the regular expression is not supported. Only provided if 'isSupported' is false."
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "testMatchOutcome",
           "type": "function",
@@ -10458,6 +10518,10 @@
           "type": "number",
           "description": "The maximum number of dynamic and session rules an extension can add. NOTE: in the Firefox we are enforcing this limit to the session and dynamic rules count separately, instead of enforcing it to the rules count for both combined as the Chrome implementation does."
         },
+        "MAX_NUMBER_OF_REGEX_RULES": {
+          "type": "number",
+          "description": "The maximum number of regular expression rules that an extension can add. This limit is evaluated separately for the set of session rules, dynamic rules and those specified in the rule_resources file."
+        },
         "SESSION_RULESET_ID": {
           "type": "string",
           "value": "_session",

package/schemas/release/webext.json

@@ -1898,6 +1898,11 @@
                   "description": "Find only ranges with case sensitive match.",
                   "optional": true
                 },
+                "matchDiacritics": {
+                  "type": "boolean",
+                  "description": "Find only ranges with diacritic sensitive match.",
+                  "optional": true
+                },
                 "entireWord": {
                   "type": "boolean",
                   "description": "Find only ranges that match entire word.",
@@ -3577,6 +3582,16 @@
               "format": "url"
             }
           }
+        },
+        {
+          "id": "Disposition",
+          "type": "string",
+          "description": "Location where search results should be displayed.",
+          "enum": [
+            "CURRENT_TAB",
+            "NEW_TAB",
+            "NEW_WINDOW"
+          ]
         }
       ],
       "functions": [
@@ -3606,12 +3621,51 @@
                   "optional": true,
                   "description": "Search engine to use. Uses the default if not specified."
                 },
+                "disposition": {
+                  "$ref": "Disposition",
+                  "optional": true,
+                  "description": "Location where search results should be displayed. NEW_TAB is the default."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "description": "The ID of the tab for the search results. If not specified, a new tab is created, unless disposition is set. tabId cannot be used with disposition."
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "query",
+          "type": "function",
+          "async": "callback",
+          "description": "Use the chrome.search API to search via the default provider.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "queryInfo",
+              "properties": {
+                "text": {
+                  "type": "string",
+                  "description": "String to query with the default search provider."
+                },
+                "disposition": {
+                  "$ref": "Disposition",
+                  "optional": true,
+                  "description": "Location where search results should be displayed. CURRENT_TAB is the default."
+                },
                 "tabId": {
                   "type": "integer",
                   "optional": true,
-                  "description": "The ID of the tab for the search results. If not specified, a new tab is created."
+                  "description": "Location where search results should be displayed. tabId cannot be used with disposition."
                 }
               }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": []
             }
           ]
         }
@@ -9898,7 +9952,7 @@
                 "isUrlFilterCaseSensitive": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Whether 'urlFilter' or 'regexFilter' is case-sensitive. Defaults to true."
+                  "description": "Whether 'urlFilter' or 'regexFilter' is case-sensitive."
                 },
                 "initiatorDomains": {
                   "type": "array",
@@ -10370,7 +10424,35 @@
             }
           ]
         }
-      ]
+      ],
+      "properties": {
+        "DYNAMIC_RULESET_ID": {
+          "type": "string",
+          "value": "_dynamic",
+          "description": "Ruleset ID for the dynamic rules added by the extension."
+        },
+        "GUARANTEED_MINIMUM_STATIC_RULES": {
+          "type": "number",
+          "description": "The minimum number of static rules guaranteed to an extension across its enabled static rulesets. Any rules above this limit will count towards the global static rule limit."
+        },
+        "MAX_NUMBER_OF_STATIC_RULESETS": {
+          "type": "number",
+          "description": "The maximum number of static Rulesets an extension can specify as part of the rule_resources manifest key."
+        },
+        "MAX_NUMBER_OF_ENABLED_STATIC_RULESETS": {
+          "type": "number",
+          "description": "The maximum number of static Rulesets an extension can enable at any one time."
+        },
+        "MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES": {
+          "type": "number",
+          "description": "The maximum number of dynamic and session rules an extension can add. NOTE: in the Firefox we are enforcing this limit to the session and dynamic rules count separately, instead of enforcing it to the rules count for both combined as the Chrome implementation does."
+        },
+        "SESSION_RULESET_ID": {
+          "type": "string",
+          "value": "_session",
+          "description": "Ruleset ID for the session-scoped rules added by the extension."
+        }
+      }
     }
   ],
   "dns.json": [
@@ -12339,7 +12421,6 @@
             "stackwalk",
             "jsallocations",
             "nostacksampling",
-            "preferencereads",
             "nativeallocations",
             "ipcmessages",
             "audiocallbacktracing",
@@ -13690,12 +13771,6 @@
           "description": "Represents a WebExtension language pack manifest.json file",
           "$import": "ManifestBase",
           "properties": {
-            "homepage_url": {
-              "type": "string",
-              "format": "url",
-              "optional": true,
-              "preprocess": "localize"
-            },
             "langpack_id": {
               "type": "string",
               "pattern": "^[a-zA-Z][a-zA-Z-]+$"
@@ -13763,12 +13838,6 @@
           "description": "Represents a WebExtension dictionary manifest.json file",
           "$import": "ManifestBase",
           "properties": {
-            "homepage_url": {
-              "type": "string",
-              "format": "url",
-              "optional": true,
-              "preprocess": "localize"
-            },
             "dictionaries": {
               "type": "object",
               "patternProperties": {