webext-patterns 1.0.0 → 1.2.0

package/index.d.ts

@@ -1,2 +1,5 @@
 export declare const patternValidationRegex: RegExp;
+export declare const allStarsRegex: RegExp;
+export declare const allUrlsRegex: RegExp;
 export declare function patternToRegex(...matchPatterns: readonly string[]): RegExp;
+export declare function globToRegex(...globs: readonly string[]): RegExp;

package/index.js

@@ -1,7 +1,12 @@
+import escapeStringRegexp from 'escape-string-regexp';
 // Copied from https://github.com/mozilla/gecko-dev/blob/073cc24f53d0cf31403121d768812146e597cc9d/toolkit/components/extensions/schemas/manifest.json#L487-L491
 export const patternValidationRegex = /^(https?|wss?|file|ftp|\*):\/\/(\*|\*\.[^*/]+|[^*/]+)\/.*$|^file:\/\/\/.*$|^resource:\/\/(\*|\*\.[^*/]+|[^*/]+)\/.*$|^about:/;
 const isFirefox = typeof navigator === 'object' && navigator.userAgent.includes('Firefox/');
-function getRawRegex(matchPattern) {
+export const allStarsRegex = isFirefox
+    ? /^(https?|wss?):[/][/][^/]+([/].*)?$/
+    : /^https?:[/][/][^/]+([/].*)?$/;
+export const allUrlsRegex = /^(https?|file|ftp):[/]+/;
+function getRawPatternRegex(matchPattern) {
     if (!patternValidationRegex.test(matchPattern)) {
         throw new Error(matchPattern + ' is an invalid pattern, it must match ' + String(patternValidationRegex));
     }
@@ -21,8 +26,51 @@ function getRawRegex(matchPattern) {
     return '^' + protocol + host + '(' + pathname + ')?$';
 }
 export function patternToRegex(...matchPatterns) {
+    // No pattern, match nothing https://stackoverflow.com/q/14115522/288906
+    if (matchPatterns.length === 0) {
+        return /$./;
+    }
     if (matchPatterns.includes('<all_urls>')) {
-        return /^(https?|file|ftp):[/]+/;
+        return allUrlsRegex;
+    }
+    if (matchPatterns.includes('*://*/*')) {
+        return allStarsRegex;
+    }
+    return new RegExp(matchPatterns.map(x => getRawPatternRegex(x)).join('|'));
+}
+// The parens are required by .split() to preserve the symbols
+const globSymbols = /([?*]+)/;
+function splitReplace(part, index) {
+    if (part === '') {
+        // Shortcut for speed
+        return '';
+    }
+    if (index % 2 === 0) {
+        // Raw text, escape it
+        return escapeStringRegexp(part);
+    }
+    // Else: Symbol
+    if (part.includes('*')) { // Can be more than one and it swallows surrounding question marks
+        return '.*';
+    }
+    return [...part].map(() => isFirefox ? '.' : '.?').join('');
+}
+function getRawGlobRegex(glob) {
+    const regexString = glob
+        .split(globSymbols)
+        // eslint-disable-next-line unicorn/no-array-callback-reference -- tis ok 🤫
+        .map(splitReplace)
+        .join('');
+    // Drop "start with anything" and "end with anything" sequences because they're the default for regex
+    return ('^' + regexString + '$')
+        .replace(/^[.][*]/, '')
+        .replace(/[.][*]$/, '')
+        .replace(/^[$]$/, '.+'); // Catch `*` and `*`
+}
+export function globToRegex(...globs) {
+    // No glob, match anything; `include_globs: []` is the default
+    if (globs.length === 0) {
+        return /.*/;
     }
-    return new RegExp(matchPatterns.map(getRawRegex).join('|'));
+    return new RegExp(globs.map(x => getRawGlobRegex(x)).join('|'));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "webext-patterns",
-	"version": "1.0.0",
-	"description": "Tool to convert the patterns of your WebExtension manifest to regex",
+	"version": "1.2.0",
+	"description": "Tool to convert the patterns and globs of your WebExtension manifest to regex",
 	"keywords": [
 		"browser",
 		"chrome",
@@ -9,6 +9,10 @@
 		"firefox",
 		"glob",
 		"permission",
+		"greasemonkey",
+		"user scripts",
+		"globs",
+		"userscript",
 		"match",
 		"webext"
 	],
@@ -24,7 +28,9 @@
 	],
 	"scripts": {
 		"build": "tsc",
-		"prepack": "tsc --sourceMap false",
+		"fix": "xo --fix",
+		"lint": "xo",
+		"prepare": "tsc --sourceMap false",
 		"test": "tsc && ava && xo",
 		"watch": "tsc --watch"
 	},
@@ -34,21 +40,28 @@
 			"webextensions"
 		],
 		"rules": {
-			"unicorn/better-regex": "off",
-			"unicorn/no-array-callback-reference": "off",
-			"comma-dangle": [
-				"error",
-				"always-multiline"
-			]
+			"unicorn/better-regex": "off"
 		}
 	},
+	"dependencies": {
+		"escape-string-regexp": "^5.0.0"
+	},
 	"devDependencies": {
-		"@sindresorhus/tsconfig": "^0.8.0",
-		"@types/chrome": "0.0.128",
-		"ava": "^3.15.0",
-		"sinon": "^9.2.4",
-		"type-fest": "^0.20.2",
-		"typescript": "^4.1.3",
-		"xo": "^0.37.1"
+		"@sindresorhus/tsconfig": "^3.0.1",
+		"@types/chrome": "0.0.190",
+		"ava": "^4.3.0",
+		"sinon": "^14.0.0",
+		"type-fest": "^2.13.1",
+		"typescript": "^4.7.4",
+		"xo": "^0.50.0"
+	},
+	"webExt": {
+		"sourceDir": "demo-extension",
+		"run": {
+			"startUrl": [
+				"chrome://extensions/",
+				"https://example.com/"
+			]
+		}
 	}
 }

package/readme.md

@@ -3,13 +3,15 @@
 [badge-gzip]: https://img.shields.io/bundlephobia/minzip/webext-patterns.svg?label=gzipped
 [link-bundlephobia]: https://bundlephobia.com/result?p=webext-patterns
 
-> Tool to convert the [patterns](https://developer.chrome.com/extensions/match_patterns) and [globs](https://wiki.greasespot.net/Include_and_exclude_rules) of your WebExtension manifest to regex
+> Tool to convert the [patterns](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts#globs) of your WebExtension manifest to regex
 
 This might be incomplete. Please help me test it by adding more pattern and URLs to the [tests](./test.js).
 
 ## Install
 
-You can just download the [standalone bundle](https://packd.fregante.now.sh/webext-patterns) (it might take a minute to download) and include the file in your `manifest.json`, or:
+You can download the [standalone bundle](https://bundle.fregante.com/?pkg=webext-patterns) and include it in your `manifest.json`.
+
+Or use `npm`:
 
 ```sh
 npm install webext-patterns
@@ -22,15 +24,34 @@ import {patternToRegex} from 'webext-patterns';
 
 ## Usage
 
+> **Note**
+> Firefox and Chrome handle globs very slighly differently. `webext-patterns` defaults to Chrome’s logic, but if it detects a Firefox userAgent it will produce a Firefox-compatible regex.
+
+```js
+patternToRegex('http://*/*');
+// Returns /^http:[/][/][^/]+[/].+$/
+
+globToRegex('*.example.com');
+// Returns /\.example\.com$/
+```
+
+## API
+
+#### patternToRegex(pattern1, pattern2, etc)
+
+Accepts any number of `string` arguments and returns a single regex to match all of them.
+
+[Match patterns](https://developer.chrome.com/extensions/match_patterns) are used in the manifest’s permissions and content scripts’ `matches` and `exclude_matches` array.
+
 ```js
 patternToRegex('http://*/*');
-// Returns /^http:\/\/?.+\/.+$/
+// Returns /^http:[/][/][^/]+[/].+$/
 
 const gmailRegex = patternToRegex('*://mail.google.com/*');
 gmailRegex.test('https://mail.google.com/a/b/c'); // -> true
 gmailRegex.test('https://photos.google.com/a/b/c'); // -> false
 
-// Also accepts an array of patterns and returns a single regex
+// Also accepts multiple patterns and returns a single regex
 const googleRegex = patternToRegex(
 	'https://google.com/*',
 	'https://google.it/*'
@@ -39,12 +60,30 @@ googleRegex.test('https://google.it/search'); // -> true
 googleRegex.test('https://google.de/search'); // -> false
 ```
 
-## API
-
-#### patternToRegex(pattern1, pattern2, etc)
+#### globToRegex(pattern1, pattern2, etc)
 
 Accepts any number of `string` arguments and returns a single regex to match all of them.
 
+[Globs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts#globs) are used in the manifest’s content scripts’ `include_globs` and `exclude_globs` arrays.
+
+```js
+globToRegex('*.example.co?');
+// Returns /\.example\.co.?$/ in Firefox
+// Returns /\.example\.co.$/ everywhere else
+
+const gmailRegex = globToRegex('*://mai?.google.com/*');
+gmailRegex.test('https://mail.google.com/a/b/c'); // -> true
+gmailRegex.test('https://photos.google.com/a/b/c'); // -> false
+
+// Also accepts multiple globs and returns a single regex
+const googleRegex = globToRegex(
+	'*google.com*',
+	'*google.it*'
+);
+googleRegex.test('https://google.it/search'); // -> true
+googleRegex.test('https://google.de/search'); // -> false
+```
+
 ## Related
 
 ### Permissions