Skip to content

Chrome DevTools for coding agents

30.0 KB
Raw Blame
/**
 * @license
 * Copyright 2026 Google LLC
 * SPDX-License-Identifier: Apache-2.0
 */

import assert from 'node:assert';
import os from 'node:os';
import {describe, it} from 'node:test';

import sinon from 'sinon';

import {
  isAllowedUrl,
  isLocalBrowserEndpoint,
  isLocalhost,
  validateUrl,
  validateUrlPatterns,
} from '../../src/utils/url.js';

describe('isLocalBrowserEndpoint', () => {
  it('returns true for loopback endpoints', () => {
    assert.strictEqual(
      isLocalBrowserEndpoint('ws://127.0.0.1:9222/devtools/browser/id'),
      true,
    );
    assert.strictEqual(isLocalBrowserEndpoint('ws://localhost:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://[::1]:9222'), true);
  });

  it('returns true for unspecified address endpoints', () => {
    assert.strictEqual(
      isLocalBrowserEndpoint('ws://0.0.0.0:9222/devtools/browser/id'),
      true,
    );
    assert.strictEqual(isLocalBrowserEndpoint('http://0:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://0x0:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://0.0.0.0.:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://[::]:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://[::0]:9222'), true);
    assert.strictEqual(
      isLocalBrowserEndpoint('ws://[::ffff:0.0.0.0]:9222'),
      true,
    );
  });

  it('returns false for remote and invalid endpoints', () => {
    assert.strictEqual(
      isLocalBrowserEndpoint('ws://remote-host.com:9222'),
      false,
    );
    assert.strictEqual(isLocalBrowserEndpoint('ws://0.0.0.1:9222'), false);
    assert.strictEqual(isLocalBrowserEndpoint('ws://[::2]:9222'), false);
    assert.strictEqual(isLocalBrowserEndpoint('file://0.0.0.0/x'), false);
    assert.strictEqual(isLocalBrowserEndpoint(''), false);
    assert.strictEqual(isLocalBrowserEndpoint('not a url'), false);
  });

  it('returns true for endpoints on a local network interface address', () => {
    const ipv4: os.NetworkInterfaceInfoIPv4 = {
      address: '192.168.1.20',
      netmask: '255.255.255.0',
      family: 'IPv4',
      mac: '00:00:00:00:00:01',
      internal: false,
      cidr: '192.168.1.20/24',
    };
    const ipv6: os.NetworkInterfaceInfoIPv6 = {
      address: '2001:db8::20',
      netmask: 'ffff:ffff:ffff:ffff::',
      family: 'IPv6',
      mac: '00:00:00:00:00:01',
      internal: false,
      cidr: '2001:db8::20/64',
      scopeid: 0,
    };
    sinon.stub(os, 'networkInterfaces').returns({eth0: [ipv4, ipv6]});

    assert.strictEqual(isLocalBrowserEndpoint('ws://192.168.1.20:9222'), true);
    assert.strictEqual(
      isLocalBrowserEndpoint('ws://[2001:db8:0::20]:9222'),
      true,
    );
    assert.strictEqual(isLocalBrowserEndpoint('ws://192.168.1.21:9222'), false);
  });

  it('returns true for endpoints on the local host name', () => {
    sinon.stub(os, 'hostname').returns('My-Host');

    assert.strictEqual(isLocalBrowserEndpoint('ws://my-host:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://MY-HOST.:9222'), true);
    assert.strictEqual(isLocalBrowserEndpoint('ws://other-host:9222'), false);
  });

  it('treats an endpoint as remote when network interfaces cannot be read', () => {
    sinon.stub(os, 'hostname').returns('my-host');
    sinon.stub(os, 'networkInterfaces').throws(new Error('uv error'));

    assert.strictEqual(isLocalBrowserEndpoint('ws://192.168.1.20:9222'), false);
    assert.strictEqual(isLocalBrowserEndpoint('ws://localhost:9222'), true);
  });
});

describe('isLocalhost', () => {
  it('should return true for valid localhost and loopback URLs', () => {
    assert.strictEqual(isLocalhost('http://localhost'), true);
    assert.strictEqual(isLocalhost('http://localhost:9222'), true);
    assert.strictEqual(
      isLocalhost('https://localhost:8080/path?query=1'),
      true,
    );
    assert.strictEqual(isLocalhost('http://subdomain.localhost:3000'), true);
    assert.strictEqual(isLocalhost('https://app.dev.localhost'), true);
    assert.strictEqual(isLocalhost('http://127.0.0.1:9222'), true);
    assert.strictEqual(
      isLocalhost('ws://127.0.0.1:9222/devtools/browser/123'),
      true,
    );
    assert.strictEqual(isLocalhost('wss://127.0.0.2'), true);
    assert.strictEqual(isLocalhost('http://[::1]:8080'), true);
    assert.strictEqual(isLocalhost('ws://[::1]:9222'), true);
  });

  it('should return true for alternative IPv4 representations', () => {
    assert.strictEqual(isLocalhost('http://127.1'), true); // short-form
    assert.strictEqual(isLocalhost('http://2130706433'), true); // decimal integer
    assert.strictEqual(isLocalhost('http://0177.0.0.1'), true); // octal
    assert.strictEqual(isLocalhost('http://0x7f.0.0.1'), true); // hex
  });

  it('should return true for full 127.0.0.0/8 loopback range', () => {
    assert.strictEqual(isLocalhost('http://127.0.0.0'), true);
    assert.strictEqual(isLocalhost('http://127.255.255.255'), true);
  });

  it('should return true for FQDN hostnames with trailing root dot', () => {
    assert.strictEqual(isLocalhost('http://localhost.'), true);
    assert.strictEqual(isLocalhost('http://subdomain.localhost.'), true);
  });

  it('should return true for uncompressed IPv6 loopback', () => {
    assert.strictEqual(isLocalhost('http://[0:0:0:0:0:0:0:1]:8080'), true);
  });

  it('should return true for IPv4-mapped IPv6 loopback', () => {
    assert.strictEqual(isLocalhost('ws://[::ffff:127.0.0.1]:9222'), true);
    assert.strictEqual(isLocalhost('http://[::ffff:127.1.2.3]'), true);
    assert.strictEqual(isLocalhost('http://[::ffff:7f00:1]:8080'), true);
    assert.strictEqual(isLocalhost('http://[::ffff:128.0.0.1]'), false);
    assert.strictEqual(isLocalhost('http://[::ffff:192.168.1.1]'), false);
  });

  it('should return true for URLs with user credentials', () => {
    assert.strictEqual(isLocalhost('http://user:pass@localhost:8080'), true);
  });

  it('should return false for non-localhost hostnames and IPs', () => {
    assert.strictEqual(isLocalhost('http://localhost.com'), false);
    assert.strictEqual(isLocalhost('http://localhost.evil.com'), false);
    assert.strictEqual(isLocalhost('http://evillocalhost'), false);
    assert.strictEqual(isLocalhost('http://localhost-evil.com'), false);
    assert.strictEqual(isLocalhost('http://[email protected]'), false);
    assert.strictEqual(isLocalhost('http://128.0.0.1'), false);
    assert.strictEqual(isLocalhost('http://192.168.1.1'), false);
    assert.strictEqual(isLocalhost('http://127.0.0.256'), false); // out of range octet
    assert.strictEqual(isLocalhost('http://127.0.0.1.example.com'), false);
    assert.strictEqual(isLocalhost('http://0.0.0.0:8080'), false);
    assert.strictEqual(isLocalhost('https://example.com'), false);
    assert.strictEqual(isLocalhost('http://[::2]:8080'), false);
    assert.strictEqual(isLocalhost('http://[2001:db8::1]:8080'), false);
  });

  it('should return false for non-network schemes', () => {
    assert.strictEqual(isLocalhost('about:blank'), false);
    assert.strictEqual(isLocalhost('chrome://inspect'), false);
    assert.strictEqual(isLocalhost('chrome://version'), false);
    assert.strictEqual(isLocalhost('file:///etc/hosts'), false);
    assert.strictEqual(isLocalhost('ftp://localhost'), false);
    assert.strictEqual(isLocalhost('data:text/html,localhost'), false);
    assert.strictEqual(isLocalhost('javascript:alert(1)'), false);
  });

  it('should return false for invalid, empty, or undefined URLs', () => {
    assert.strictEqual(isLocalhost(undefined), false);
    assert.strictEqual(isLocalhost(''), false);
    assert.strictEqual(isLocalhost('   '), false);
    assert.strictEqual(isLocalhost('not a url'), false);
  });
});

const defaultOptions = {
  javascriptEvaluation: undefined,
  categoryExtensions: undefined,
  fileNavigations: undefined,
};

describe('validateUrl', () => {
  it('should return URL object for valid URLs', () => {
    assert.strictEqual(
      validateUrl('https://example.com', defaultOptions).href,
      'https://example.com/',
    );
    assert.strictEqual(
      validateUrl('http://localhost:3000', defaultOptions).href,
      'http://localhost:3000/',
    );
    assert.strictEqual(
      validateUrl('about:blank', defaultOptions).href,
      'about:blank',
    );
    assert.strictEqual(
      validateUrl('data:text/html,<div>test</div>', defaultOptions).href,
      'data:text/html,<div>test</div>',
    );
  });

  it('should reject URLs that do not parse with new URL', () => {
    assert.throws(
      () => validateUrl('not a url', defaultOptions),
      /Invalid URL: "not a url"/,
    );
    assert.throws(() => validateUrl('', defaultOptions), /Invalid URL: ""/);
    assert.throws(
      () => validateUrl('http://', defaultOptions),
      /Invalid URL: "http:\/\/"/,
    );
    assert.throws(
      () => validateUrl('://', defaultOptions),
      /Invalid URL: ":\/\/"/,
    );
  });

  it('should allow javascript, data, and vbscript URLs when javascriptEvaluation is true or omitted', () => {
    assert.strictEqual(
      validateUrl('javascript:alert(1)', defaultOptions).protocol,
      'javascript:',
    );
    assert.strictEqual(
      validateUrl('javascript:alert(1)', {
        javascriptEvaluation: true,
        categoryExtensions: undefined,
        fileNavigations: undefined,
      }).protocol,
      'javascript:',
    );
    assert.strictEqual(
      validateUrl('data:text/html,<div>test</div>', defaultOptions).protocol,
      'data:',
    );
    assert.strictEqual(
      validateUrl('data:text/html,<div>test</div>', {
        javascriptEvaluation: true,
        categoryExtensions: undefined,
        fileNavigations: undefined,
      }).protocol,
      'data:',
    );
    assert.strictEqual(
      validateUrl('vbscript:msgbox(1)', defaultOptions).protocol,
      'vbscript:',
    );
    assert.strictEqual(
      validateUrl('vbscript:msgbox(1)', {
        javascriptEvaluation: true,
        categoryExtensions: undefined,
        fileNavigations: undefined,
      }).protocol,
      'vbscript:',
    );
  });

  it('should reject javascript, data, and vbscript URLs when javascriptEvaluation is false', () => {
    assert.throws(
      () =>
        validateUrl('javascript:alert(1)', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to javascript: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
    assert.throws(
      () =>
        validateUrl('JAVASCRIPT:alert(1)', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to javascript: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
    assert.throws(
      () =>
        validateUrl('javascript:void(0)', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to javascript: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
    assert.throws(
      () =>
        validateUrl('data:text/html,<div>test</div>', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to data: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
    assert.throws(
      () =>
        validateUrl('DATA:text/html,<div>test</div>', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to data: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
    assert.throws(
      () =>
        validateUrl('vbscript:msgbox(1)', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to vbscript: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
    assert.throws(
      () =>
        validateUrl('VBSCRIPT:msgbox(1)', {
          javascriptEvaluation: false,
          categoryExtensions: undefined,
          fileNavigations: undefined,
        }),
      /Navigating to vbscript: URLs is not allowed when JavaScript evaluation is disabled\./,
    );
  });

  it('should allow chrome://newtab/ and chrome://inspect', () => {
    assert.strictEqual(
      validateUrl('chrome://newtab/', defaultOptions).href,
      'chrome://newtab/',
    );
    assert.strictEqual(
      validateUrl('chrome://newtab', defaultOptions).href,
      'chrome://newtab',
    );
    assert.strictEqual(
      validateUrl('chrome://inspect', defaultOptions).href,
      'chrome://inspect',
    );
    assert.strictEqual(
      validateUrl('chrome://inspect/#devices', defaultOptions).href,
      'chrome://inspect/#devices',
    );
  });

  it('should reject chrome: and chrome-untrusted: URLs', () => {
    assert.throws(
      () => validateUrl('chrome://settings', defaultOptions),
      /Navigating to chrome: URLs is not allowed\./,
    );
    assert.throws(
      () => validateUrl('chrome://version', defaultOptions),
      /Navigating to chrome: URLs is not allowed\./,
    );
    assert.throws(
      () => validateUrl('chrome:version', defaultOptions),
      /Navigating to chrome: URLs is not allowed\./,
    );
    assert.throws(
      () => validateUrl('CHROME://version', defaultOptions),
      /Navigating to chrome: URLs is not allowed\./,
    );
    assert.throws(
      () => validateUrl('chrome-untrusted://terminal', defaultOptions),
      /Navigating to chrome-untrusted: URLs is not allowed\./,
    );
    assert.throws(
      () => validateUrl('chrome-untrusted:terminal', defaultOptions),
      /Navigating to chrome-untrusted: URLs is not allowed\./,
    );
  });

  it('should reject chrome-extension: URLs unless categoryExtensions is enabled', () => {
    assert.throws(
      () => validateUrl('chrome-extension://abcdef/popup.html', defaultOptions),
      /Navigating to chrome-extension: URLs is not allowed without --categoryExtensions\./,
    );
    assert.throws(
      () =>
        validateUrl('chrome-extension://abcdef/popup.html', {
          javascriptEvaluation: undefined,
          categoryExtensions: false,
          fileNavigations: undefined,
        }),
      /Navigating to chrome-extension: URLs is not allowed without --categoryExtensions\./,
    );
    assert.strictEqual(
      validateUrl('chrome-extension://abcdef/popup.html', {
        javascriptEvaluation: undefined,
        categoryExtensions: true,
        fileNavigations: undefined,
      }).href,
      'chrome-extension://abcdef/popup.html',
    );
  });

  it('should reject devtools: URLs', () => {
    assert.throws(
      () =>
        validateUrl(
          'devtools://devtools/bundled/devtools_app.html',
          defaultOptions,
        ),
      /Navigating to devtools: URLs is not allowed\./,
    );
  });

  it('should allow file URLs when fileNavigations is true or omitted', () => {
    assert.strictEqual(
      validateUrl('file:///tmp/example.txt', defaultOptions).protocol,
      'file:',
    );
    assert.strictEqual(
      validateUrl('file:///tmp/example.txt', {
        javascriptEvaluation: undefined,
        categoryExtensions: undefined,
        fileNavigations: true,
      }).href,
      'file:///tmp/example.txt',
    );
  });

  it('should reject file URLs when fileNavigations is false', () => {
    const noFileNavigations = {
      javascriptEvaluation: undefined,
      categoryExtensions: undefined,
      fileNavigations: false,
    };
    assert.throws(
      () => validateUrl('file:///tmp/example.txt', noFileNavigations),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
    assert.throws(
      () => validateUrl('file:///etc/passwd', noFileNavigations),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
    // The host form resolves to the same scheme and is rejected too.
    assert.throws(
      () => validateUrl('file://localhost/tmp/example.txt', noFileNavigations),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
  });

  it('should reject view-source URLs that target a file URL when fileNavigations is false', () => {
    const noFileNavigations = {
      javascriptEvaluation: undefined,
      categoryExtensions: undefined,
      fileNavigations: false,
    };
    // `view-source:` wraps the inner URL and Chrome resolves it, so this reads
    // the file just as a bare `file:` URL would.
    assert.throws(
      () => validateUrl('view-source:file:///etc/passwd', noFileNavigations),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
    // An uppercase inner scheme normalises to `file:` when re-parsed.
    assert.throws(
      () => validateUrl('view-source:FILE:///etc/passwd', noFileNavigations),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
    // An uppercase outer scheme normalises too.
    assert.throws(
      () => validateUrl('VIEW-SOURCE:file:///etc/passwd', noFileNavigations),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
    // Nested wrapping unwraps to the same target.
    assert.throws(
      () =>
        validateUrl(
          'view-source:view-source:file:///etc/passwd',
          noFileNavigations,
        ),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
  });

  it('should reject view-source nesting deeper than the unwrap limit', () => {
    const noFileNavigations = {
      javascriptEvaluation: undefined,
      categoryExtensions: undefined,
      fileNavigations: false,
    };
    const notValid = /The view-source: wrapped content is not a valid URL\./;
    // Past the unwrap limit the target can no longer be inspected, so the
    // validator must fail closed instead of checking the outer wrapper.
    assert.throws(
      () =>
        validateUrl(
          'view-source:'.repeat(6) + 'file:///etc/passwd',
          noFileNavigations,
        ),
      notValid,
    );
    assert.throws(
      () =>
        validateUrl(
          'view-source:'.repeat(6) + 'chrome://settings',
          noFileNavigations,
        ),
      notValid,
    );
    // Exactly at the limit still unwraps to the real target.
    assert.throws(
      () =>
        validateUrl(
          'view-source:'.repeat(5) + 'file:///etc/passwd',
          noFileNavigations,
        ),
      /Navigating to file: URLs is not allowed when --file-navigations is disabled\./,
    );
  });

  it('should reject view-source URLs whose wrapped content is not a valid URL', () => {
    assert.throws(
      () =>
        validateUrl('view-source:example.com', {
          javascriptEvaluation: undefined,
          categoryExtensions: undefined,
          fileNavigations: false,
        }),
      /The view-source: wrapped content is not a valid URL\./,
    );
  });

  it('should reject view-source URLs that target devtools:, chrome:, chrome-untrusted:, and chrome-extension:', () => {
    // These previously bypassed validateUrl entirely: the devtools:/chrome:
    // checks were evaluated against the outer `view-source:` protocol
    // instead of the wrapped target, even though Chrome strips the
    // `view-source:` prefix at navigation time and loads the page under
    // the wrapped URL's own origin.
    assert.throws(
      () =>
        validateUrl(
          'view-source:devtools://devtools/bundled/devtools_app.html',
          defaultOptions,
        ),
      /Navigating to devtools: URLs is not allowed\./,
    );
    assert.throws(
      () => validateUrl('view-source:chrome://settings', defaultOptions),
      /Navigating to chrome: URLs is not allowed\./,
    );
    // chrome://inspect is intentionally allowlisted by isAllowedUrl, so
    // unwrapping view-source: and reaching chrome://inspect is expected
    // to succeed, matching the direct chrome://inspect behavior above.
    assert.strictEqual(
      validateUrl('view-source:chrome://inspect', defaultOptions).protocol,
      'view-source:',
    );
    assert.throws(
      () =>
        validateUrl('view-source:chrome-untrusted://terminal', defaultOptions),
      /Navigating to chrome-untrusted: URLs is not allowed\./,
    );
    assert.throws(
      () =>
        validateUrl(
          'view-source:chrome-extension://abcdef/popup.html',
          defaultOptions,
        ),
      /Navigating to chrome-extension: URLs is not allowed without --categoryExtensions\./,
    );
    // Still rejected even with categoryExtensions enabled, mirroring the
    // bare chrome-extension: behavior being unaffected by the unwrap.
    assert.strictEqual(
      validateUrl('view-source:chrome-extension://abcdef/popup.html', {
        javascriptEvaluation: undefined,
        categoryExtensions: true,
        fileNavigations: undefined,
      }).protocol,
      'view-source:',
    );
  });

  it('should not reject view-source URLs that target other schemes', () => {
    const noFileNavigations = {
      javascriptEvaluation: undefined,
      categoryExtensions: undefined,
      fileNavigations: false,
    };
    assert.strictEqual(
      validateUrl('view-source:http://example.com', noFileNavigations).protocol,
      'view-source:',
    );
    assert.strictEqual(
      validateUrl('view-source:https://example.com', noFileNavigations)
        .protocol,
      'view-source:',
    );
  });

  it('should allow view-source of a file URL when fileNavigations is true', () => {
    assert.strictEqual(
      validateUrl('view-source:file:///etc/passwd', {
        javascriptEvaluation: undefined,
        categoryExtensions: undefined,
        fileNavigations: true,
      }).protocol,
      'view-source:',
    );
  });

  it('should only reject file URLs when fileNavigations is false', () => {
    const noFileNavigations = {
      javascriptEvaluation: undefined,
      categoryExtensions: undefined,
      fileNavigations: false,
    };
    assert.strictEqual(
      validateUrl('https://example.com', noFileNavigations).href,
      'https://example.com/',
    );
    assert.strictEqual(
      validateUrl('about:blank', noFileNavigations).href,
      'about:blank',
    );
    assert.strictEqual(
      validateUrl('data:text/html,<div>test</div>', noFileNavigations).protocol,
      'data:',
    );
  });
});

describe('isAllowedUrl', () => {
  it('should allow chrome://newtab/ and chrome://inspect', () => {
    assert.strictEqual(
      isAllowedUrl('chrome://newtab/', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('chrome://newtab', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('CHROME://newtab/', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('chrome://inspect', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('chrome://inspect/', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('chrome://inspect/#devices', {
        categoryExtensions: undefined,
      }),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('CHROME://inspect', {categoryExtensions: undefined}),
      true,
    );
  });

  it('should disallow internal chrome: and chrome-untrusted: URLs', () => {
    assert.strictEqual(
      isAllowedUrl('chrome://settings', {categoryExtensions: undefined}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome://version', {categoryExtensions: undefined}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome:version', {categoryExtensions: undefined}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('CHROME://settings', {categoryExtensions: undefined}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome-untrusted://terminal', {
        categoryExtensions: undefined,
      }),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome-untrusted:terminal', {
        categoryExtensions: undefined,
      }),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('CHROME-UNTRUSTED://terminal', {
        categoryExtensions: undefined,
      }),
      false,
    );
  });

  it('should disallow chrome-extension: URLs when extensions are disabled and allow when enabled', () => {
    assert.strictEqual(
      isAllowedUrl('chrome-extension://abcdef/popup.html', {
        categoryExtensions: undefined,
      }),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome-extension://abcdef/popup.html', {
        categoryExtensions: false,
      }),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome-extension:abcdef', {categoryExtensions: false}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('chrome-extension://abcdef/popup.html', {
        categoryExtensions: true,
      }),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('chrome-extension:abcdef', {categoryExtensions: true}),
      true,
    );
  });

  it('should allow standard web and navigation URLs', () => {
    assert.strictEqual(
      isAllowedUrl('https://example.com', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('http://localhost:3000', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('about:blank', {categoryExtensions: undefined}),
      true,
    );
    assert.strictEqual(
      isAllowedUrl('data:text/html,<div>test</div>', {
        categoryExtensions: undefined,
      }),
      true,
    );
  });

  it('should return false for unparseable URLs', () => {
    assert.strictEqual(
      isAllowedUrl('not a url', {categoryExtensions: undefined}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('', {categoryExtensions: undefined}),
      false,
    );
    assert.strictEqual(
      isAllowedUrl('://', {categoryExtensions: undefined}),
      false,
    );
  });
});

describe('validateUrlPatterns', () => {
  it('rejects a regexp group with a specific error message', () => {
    for (const pattern of [
      String.raw`*://(127\.\d+\.\d+\.\d+):*/*`,
      '*://example.com/(foo|bar)',
      '(http|https)://example.com/*',
    ]) {
      assert.throws(
        () => validateUrlPatterns([pattern], '--blockedUrlPattern'),
        new Error(
          `Invalid --blockedUrlPattern "${pattern}": a regexp group is not enforced on redirects or subresources. Use an exact value or a "*" wildcard instead.`,
        ),
      );
    }
  });

  it('throws on the first offending pattern among several', () => {
    const offending = String.raw`*://(localhost|127\.0\.0\.1):*/*`;
    assert.throws(
      () =>
        validateUrlPatterns(
          ['*://127.0.0.1:*/*', '*://*.example.com/*', offending],
          '--allowedUrlPattern',
        ),
      new Error(
        `Invalid --allowedUrlPattern "${offending}": a regexp group is not enforced on redirects or subresources. Use an exact value or a "*" wildcard instead.`,
      ),
    );
  });

  it('allows plain wildcard patterns', () => {
    assert.doesNotThrow(() =>
      validateUrlPatterns(
        [
          '*://127.0.0.1:*/*',
          '*://127.0.0.1/*',
          '*://*.example.com/*',
          '*://*.123.example.com/*',
          'https://127.0.0.1:8080/secret',
        ],
        '--blockedUrlPattern',
      ),
    );
  });

  it('rejects a named group in any component with a specific error message', () => {
    for (const pattern of [
      '*://127.0.0.1::port/secret',
      '*://127.0.0.1:{:port}/secret',
      ':proto://example.com/*',
      '*://:[email protected]/*',
      '*://user::[email protected]/*',
      '*://:sub.example.com/*',
      '*://{:sub}.example.com/*',
      '*://127.0.0.:oct:*/blocked/:page',
      '*://example.com/:path',
      '*://example.com/{:path}',
      '*://example.com/path?:query',
      '*://example.com/path?token=:secret',
      '*://example.com/*#:hash',
    ]) {
      assert.throws(
        () => validateUrlPatterns([pattern], '--blockedUrlPattern'),
        new Error(
          `Invalid --blockedUrlPattern "${pattern}": a ":name" named group is not enforced on redirects or subresources. Use an exact value or a "*" wildcard instead.`,
        ),
      );
    }
  });

  it('rejects a partial IPv4 wildcard in the hostname with a specific error message', () => {
    for (const pattern of [
      '*://127.0.0.*/*',
      '*://127.*:*/*',
      '*://*.0.0.1/*',
      '*://127.*.0.1/*',
      '*://127.0.0*/*',
      '*://127.0.0.{*}/*',
      '*://{127.0.0.*}/*',
      '*://{*.0.0.1}/*',
      '*://*1*/*',
      '*://0x7f.0.0.*/*',
      '*://0x7f.*/*',
      '*://user:[email protected].*/*',
      '*://user:[email protected].*:8080/*',
      String.raw`*://127.0.0.*\:8080/*`,
      String.raw`*://127.0.\0.*/*`,
    ]) {
      assert.throws(
        () => validateUrlPatterns([pattern], '--blockedUrlPattern'),
        new Error(
          `Invalid --blockedUrlPattern "${pattern}": a partial IPv4 wildcard is not enforced on redirects or subresources. Use an exact IPv4 address or a "*" wildcard instead.`,
        ),
      );
    }
  });

  it('allows escaped colons unless an unescaped named group is also present', () => {
    assert.doesNotThrow(() =>
      validateUrlPatterns(
        [
          String.raw`http://[\:\:1]:8080/*`,
          String.raw`*://example.com/path?foo=a\:b#bar\:c`,
          String.raw`*://example.com/path?foo=a\\\:b#bar\\\:c`,
        ],
        '--blockedUrlPattern',
      ),
    );
    for (const pattern of [
      String.raw`*://example.com/path?foo=a\:b&bar=:baz`,
      String.raw`*://example.com/path?foo\\:bar`,
    ]) {
      assert.throws(
        () => validateUrlPatterns([pattern], '--blockedUrlPattern'),
        new Error(
          `Invalid --blockedUrlPattern "${pattern}": a ":name" named group is not enforced on redirects or subresources. Use an exact value or a "*" wildcard instead.`,
        ),
      );
    }
  });

  it('throws for a pattern that fails to construct', () => {
    assert.throws(
      () =>
        validateUrlPatterns(
          ['*://example.com/(unterminated'],
          '--blockedUrlPattern',
        ),
      /Invalid --blockedUrlPattern "\*:\/\/example\.com\/\(unterminated":/,
    );
  });

  it('allows an empty list', () => {
    assert.doesNotThrow(() => validateUrlPatterns([], '--blockedUrlPattern'));
  });
});