// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license. // @ts-check /// /// /// /// /// import { core, primordials } from "ext:core/mod.js"; const { op_urlpattern_parse, op_urlpattern_process_match_input, } = core.ensureFastOps(); const { ArrayPrototypePush, MathRandom, ObjectAssign, ObjectCreate, ObjectPrototypeIsPrototypeOf, RegExpPrototypeExec, RegExpPrototypeTest, SafeMap, SafeRegExp, Symbol, SymbolFor, TypeError, } = primordials; import * as webidl from "ext:deno_webidl/00_webidl.js"; import { createFilteredInspectProxy } from "ext:deno_console/01_console.js"; const _components = Symbol("components"); /** * @typedef Components * @property {Component} protocol * @property {Component} username * @property {Component} password * @property {Component} hostname * @property {Component} port * @property {Component} pathname * @property {Component} search * @property {Component} hash */ const COMPONENTS_KEYS = [ "protocol", "username", "password", "hostname", "port", "pathname", "search", "hash", ]; /** * @typedef Component * @property {string} patternString * @property {RegExp} regexp * @property {string[]} groupNameList */ /** * This implements a least-recently-used cache that has a pseudo-"young * generation" by using sampling. The idea is that we want to keep the most * recently used items in the cache, but we don't want to pay the cost of * updating the cache on every access. This relies on the fact that the data * we're caching is not uniformly distributed, and that the most recently used * items are more likely to be used again soon (long tail distribution). * * The LRU cache is implemented as a Map, with the key being the cache key and * the value being the cache value. When an item is accessed, it is moved to the * end of the Map. When an item is inserted, if the Map is at capacity, the * first item in the Map is deleted. Because maps iterate using insertion order, * this means that the oldest item is always the first. * * The sampling is implemented by using a random number generator to decide * whether to update the cache on each access. This means that the cache will * not be updated on every access, but will be updated on a random subset of * accesses. * * @template K * @template V */ class SampledLRUCache { /** @type {SafeMap} */ #map = new SafeMap(); #capacity = 0; #sampleRate = 0.1; /** @type {K} */ #lastUsedKey = undefined; /** @type {V} */ #lastUsedValue = undefined; /** @param {number} capacity */ constructor(capacity) { this.#capacity = capacity; } /** * @param {K} key * @param {(key: K) => V} factory * @return {V} */ getOrInsert(key, factory) { if (this.#lastUsedKey === key) return this.#lastUsedValue; const value = this.#map.get(key); if (value !== undefined) { if (MathRandom() < this.#sampleRate) { // put the item into the map this.#map.delete(key); this.#map.set(key, value); } this.#lastUsedKey = key; this.#lastUsedValue = value; return value; } else { // value doesn't exist yet, create const value = factory(key); if (MathRandom() < this.#sampleRate) { // if the map is at capacity, delete the oldest (first) element if (this.#map.size > this.#capacity) { // deno-lint-ignore prefer-primordials this.#map.delete(this.#map.keys().next().value); } // insert the new value this.#map.set(key, value); } this.#lastUsedKey = key; this.#lastUsedValue = value; return value; } } } const matchInputCache = new SampledLRUCache(4096); class URLPattern { /** @type {Components} */ [_components]; #reusedResult; /** * @param {URLPatternInput} input * @param {string} [baseURL] */ constructor(input, baseURL = undefined) { this[webidl.brand] = webidl.brand; const prefix = "Failed to construct 'URLPattern'"; webidl.requiredArguments(arguments.length, 1, prefix); input = webidl.converters.URLPatternInput(input, prefix, "Argument 1"); if (baseURL !== undefined) { baseURL = webidl.converters.USVString(baseURL, prefix, "Argument 2"); } const components = op_urlpattern_parse(input, baseURL); for (let i = 0; i < COMPONENTS_KEYS.length; ++i) { const key = COMPONENTS_KEYS[i]; try { components[key].regexp = new SafeRegExp( components[key].regexpString, "u", ); } catch (e) { throw new TypeError(`${prefix}: ${key} is invalid; ${e.message}`); } } this[_components] = components; } get protocol() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].protocol.patternString; } get username() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].username.patternString; } get password() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].password.patternString; } get hostname() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].hostname.patternString; } get port() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].port.patternString; } get pathname() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].pathname.patternString; } get search() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].search.patternString; } get hash() { webidl.assertBranded(this, URLPatternPrototype); return this[_components].hash.patternString; } /** * @param {URLPatternInput} input * @param {string} [baseURL] * @returns {boolean} */ test(input, baseURL = undefined) { webidl.assertBranded(this, URLPatternPrototype); const prefix = "Failed to execute 'test' on 'URLPattern'"; webidl.requiredArguments(arguments.length, 1, prefix); input = webidl.converters.URLPatternInput(input, prefix, "Argument 1"); if (baseURL !== undefined) { baseURL = webidl.converters.USVString(baseURL, prefix, "Argument 2"); } const res = baseURL === undefined ? matchInputCache.getOrInsert( input, op_urlpattern_process_match_input, ) : op_urlpattern_process_match_input(input, baseURL); if (res === null) return false; const values = res[0]; for (let i = 0; i < COMPONENTS_KEYS.length; ++i) { const key = COMPONENTS_KEYS[i]; const component = this[_components][key]; switch (component.regexpString) { case "^$": if (values[key] !== "") return false; break; case "^(.*)$": break; default: { if (!RegExpPrototypeTest(component.regexp, values[key])) return false; } } } return true; } /** * @param {URLPatternInput} input * @param {string} [baseURL] * @returns {URLPatternResult | null} */ exec(input, baseURL = undefined) { webidl.assertBranded(this, URLPatternPrototype); const prefix = "Failed to execute 'exec' on 'URLPattern'"; webidl.requiredArguments(arguments.length, 1, prefix); input = webidl.converters.URLPatternInput(input, prefix, "Argument 1"); if (baseURL !== undefined) { baseURL = webidl.converters.USVString(baseURL, prefix, "Argument 2"); } const res = baseURL === undefined ? matchInputCache.getOrInsert( input, op_urlpattern_process_match_input, ) : op_urlpattern_process_match_input(input, baseURL); if (res === null) { return null; } const { 0: values, 1: inputs } = res; /** @type {URLPatternResult} */ // globalThis.allocAttempt++; this.#reusedResult ??= { inputs: [undefined] }; const result = this.#reusedResult; // We don't construct the `inputs` until after the matching is done under // the assumption that most patterns do not match. const components = this[_components]; for (let i = 0; i < COMPONENTS_KEYS.length; ++i) { const key = COMPONENTS_KEYS[i]; /** @type {Component} */ const component = components[key]; const res = result[key] ??= { input: values[key], groups: component.regexpString === "^(.*)$" ? { "0": values[key] } : {}, }; switch (component.regexpString) { case "^$": if (values[key] !== "") return null; break; case "^(.*)$": res.groups["0"] = values[key]; break; default: { const match = RegExpPrototypeExec(component.regexp, values[key]); if (match === null) return null; const groupList = component.groupNameList; const groups = res.groups; for (let i = 0; i < groupList.length; ++i) { // TODO(lucacasonato): this is vulnerable to override mistake groups[groupList[i]] = match[i + 1] ?? ""; } break; } } res.input = values[key]; } // Now populate result.inputs result.inputs[0] = typeof inputs[0] === "string" ? inputs[0] : ObjectAssign(ObjectCreate(null), inputs[0]); if (inputs[1] !== null) ArrayPrototypePush(result.inputs, inputs[1]); this.#reusedResult = undefined; return result; } [SymbolFor("Deno.privateCustomInspect")](inspect, inspectOptions) { return inspect( createFilteredInspectProxy({ object: this, evaluate: ObjectPrototypeIsPrototypeOf(URLPatternPrototype, this), keys: [ "protocol", "username", "password", "hostname", "port", "pathname", "search", "hash", ], }), inspectOptions, ); } } webidl.configureInterface(URLPattern); const URLPatternPrototype = URLPattern.prototype; webidl.converters.URLPatternInit = webidl .createDictionaryConverter("URLPatternInit", [ { key: "protocol", converter: webidl.converters.USVString }, { key: "username", converter: webidl.converters.USVString }, { key: "password", converter: webidl.converters.USVString }, { key: "hostname", converter: webidl.converters.USVString }, { key: "port", converter: webidl.converters.USVString }, { key: "pathname", converter: webidl.converters.USVString }, { key: "search", converter: webidl.converters.USVString }, { key: "hash", converter: webidl.converters.USVString }, { key: "baseURL", converter: webidl.converters.USVString }, ]); webidl.converters["URLPatternInput"] = (V, prefix, context, opts) => { // Union for (URLPatternInit or USVString) if (typeof V == "object") { return webidl.converters.URLPatternInit(V, prefix, context, opts); } return webidl.converters.USVString(V, prefix, context, opts); }; export { URLPattern };