Add doesUrlMatchPatterns helper

index.ts

@@ -20,6 +20,24 @@ export function isValidPattern(matchPattern: string): boolean {
 	return matchPattern === '<all_urls>' || patternValidationRegex.test(matchPattern);
 }
 
+export function doesUrlMatchPatterns(url: string, ...matchPattern: string[]): boolean {
+	if (matchPattern.includes('<all_urls>') && allUrlsRegex.test(url)) {
+		return true;
+	}
+
+	if (matchPattern.includes('*://*/*') && allStarsRegex.test(url)) {
+		return true;
+	}
+
+	for (const pattern of matchPattern) {
+		if (patternToRegex(pattern).test(url)) {
+			return true;
+		}
+	}
+
+	return false;
+}
+
 function getRawPatternRegex(matchPattern: string): string {
 	assertValidPattern(matchPattern);
 

readme.md

@@ -23,6 +23,7 @@ import {
 	patternToRegex,
 	globToRegex,
 	excludeDuplicatePatterns
+	doesUrlMatchPatterns,
 	assertValidPattern,
 	isValidPattern,
 } from 'webext-patterns';
@@ -112,6 +113,15 @@ excludeDuplicatePatterns([
 // Returns ["https://*/*"]
 ```
 
+#### doesUrlMatchPatterns(url, ...patterns)
+
+Accepts a URL and any number of patterns and returns `true` if the URL matches any of the patterns. This is a convenience method that wraps `patternToRegex` for single use. If you plan on testing multiple URLs to the same pattern, it's better to convert the patterns to a regex once and reuse that.
+
+```js
+doesUrlMatchPatterns('https://google.com/', ['https://*.google.com/*', '*://example.com/*']);
+// Returns true
+```
+
 #### assertValidPattern(pattern)
 
 Accepts a pattern and throws an error if it's invalid.

test/patterns.js

@@ -1,12 +1,13 @@
 import test from 'ava';
-import {patternToRegex, isValidPattern, assertValidPattern} from '../index.js';
+import {patternToRegex, isValidPattern, assertValidPattern, doesUrlMatchPatterns} from '../index.js';
 
 function macro(t, pattern, matching) {
 	const regex = patternToRegex(pattern);
 	for (const url of matching) {
 		t.regex(url, regex);
 		t.true(isValidPattern(pattern));
 		t.notThrows(() => assertValidPattern(pattern));
+		t.true(doesUrlMatchPatterns(url, 'http://never.example.com/*', pattern, 'http://nope.example.com/*'));
 	}
 }