Skip to content

Chrome DevTools for coding agents

fix: treat IPv4-mapped IPv6 loopback as localhost (#3255)

kevin6cfb34c0e246
diff --git a/src/utils/url.ts b/src/utils/url.ts
index e7def775..2506df1c 100644
--- a/src/utils/url.ts
+++ b/src/utils/url.ts
@@ -10,6 +10,7 @@ import {URLPattern} from '../third_party/cli.js';
const ALLOWED_PROTOCOLS = new Set(['http:', 'https:', 'ws:', 'wss:']);
const IPV4_LOOPBACK_REGEX = /^127(?:\.(?:25[0-5]|2[0-4]\d|[01]?\d\d?)){3}$/;
+const IPV4_MAPPED_LOOPBACK_REGEX = /^\[::ffff:7f[0-9a-f]{2}:[0-9a-f]{1,4}\]$/;
/**
* Determines whether a given URL string points to a localhost / loopback address.
@@ -50,6 +51,12 @@ export function isLocalhost(url?: string): boolean {
return true;
}
+ // 4. Check IPv4-mapped IPv6 loopback. URL serializes [::ffff:127.0.0.1]
+ // as [::ffff:7f00:1].
+ if (IPV4_MAPPED_LOOPBACK_REGEX.test(hostname)) {
+ return true;
+ }
+
return false;
}
diff --git a/tests/utils/url.test.ts b/tests/utils/url.test.ts
index 37077b30..bc5fb87c 100644
--- a/tests/utils/url.test.ts
+++ b/tests/utils/url.test.ts
@@ -55,6 +55,14 @@ describe('isLocalhost', () => {
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);
});