Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { describe, expect, it } from 'vitest'
import { ORCA_BROWSER_BLANK_URL } from './constants'
import {
buildSearchUrl,
classifySchemeLessLocalDevAddress,
isEligibleLocalCertificateHost,
normalizeKagiSessionLink,
normalizeBrowserNavigationUrl,
normalizeExternalBrowserUrl,
redactKagiSessionToken,
resolveRemoteFailureExternalUrl,
toSecureCertificateEndpoint
} from './browser-url'
describe('browser-url helpers', () => {
it('normalizes manual local-dev inputs to http', () => {
expect(normalizeBrowserNavigationUrl('localhost:3000')).toBe('http://localhost:3000/')
expect(normalizeBrowserNavigationUrl('127.0.0.1:5173')).toBe('http://127.0.0.1:5173/')
expect(normalizeBrowserNavigationUrl('localhost:3000?debug=1')).toBe(
'http://localhost:3000/?debug=1'
)
expect(normalizeBrowserNavigationUrl('localhost:3000#preview')).toBe(
'http://localhost:3000/#preview'
)
})
it('keeps the legacy scheme-less local-dev classifier broader than certificate eligibility', () => {
for (const input of [
'localhost:3000/path',
'127.0.0.1:5173',
'0.0.0.0:8080',
'[::1]:3000',
'[2001:db8::1]:3000'
]) {
expect(classifySchemeLessLocalDevAddress(input), input).not.toBeNull()
}
expect(classifySchemeLessLocalDevAddress('app.localhost:3000')).toBeNull()
expect(isEligibleLocalCertificateHost('0.0.0.0')).toBe(false)
expect(isEligibleLocalCertificateHost('[2001:db8::1]')).toBe(false)
})
it('recognizes only canonical loopback certificate hosts', () => {
for (const hostname of [
'localhost',
'LOCALHOST.',
'app.localhost',
'deep.app.localhost.',
'127.0.0.1',
'127.255.255.255',
'::1',
'[::1]'
]) {
expect(isEligibleLocalCertificateHost(hostname), hostname).toBe(true)
}
for (const hostname of [
'0.0.0.0',
'::',
'[2001:db8::1]',
'192.168.1.1',
'localhost.example.com',
'notlocalhost',
'.localhost',
'-bad.localhost',
'bad-.localhost',
'127.0.0.999',
'127.00.0.1'
]) {
expect(isEligibleLocalCertificateHost(hostname), hostname).toBe(false)
}
})
it('canonicalizes secure certificate endpoints without path or credential data', () => {
expect(toSecureCertificateEndpoint('https://User:secret@LOCALHOST.:443/path?q=1')).toBe(
'https://localhost:443'
)
expect(toSecureCertificateEndpoint('wss://localhost:3000/socket')).toBe(
'https://localhost:3000'
)
expect(toSecureCertificateEndpoint('https://[::1]/')).toBe('https://[::1]:443')
expect(toSecureCertificateEndpoint('http://localhost:3000/')).toBeNull()
expect(toSecureCertificateEndpoint('not a url')).toBeNull()
})
it('offers Open Externally for a remote failure only when the URL is desktop-reachable', () => {
// Loopback / wildcard hosts are unreachable from the desktop system browser.
expect(resolveRemoteFailureExternalUrl('https://localhost:3000/')).toBeNull()
expect(resolveRemoteFailureExternalUrl('https://127.0.0.1:3000/')).toBeNull()
expect(resolveRemoteFailureExternalUrl('https://127.0.0.9:3000/')).toBeNull()
expect(resolveRemoteFailureExternalUrl('https://[::1]:3000/')).toBeNull()
expect(resolveRemoteFailureExternalUrl('https://app.localhost:3000/')).toBeNull()
expect(resolveRemoteFailureExternalUrl('http://0.0.0.0:3000/')).toBeNull()
expect(resolveRemoteFailureExternalUrl('http://[::]:3000/')).toBeNull()
// Public hosts are reachable, so the action is offered.
expect(resolveRemoteFailureExternalUrl('https://example.com/app')).toBe(
'https://example.com/app'
)
expect(resolveRemoteFailureExternalUrl('http://example.com:8080/x')).toBe(
'http://example.com:8080/x'
)
// Non-web schemes and garbage never become an external target.
expect(resolveRemoteFailureExternalUrl('file:///etc/passwd')).toBeNull()
expect(resolveRemoteFailureExternalUrl('not a url')).toBeNull()
})
it('keeps normal web URLs and blank tabs in the allowed set', () => {
expect(normalizeBrowserNavigationUrl('https://example.com')).toBe('https://example.com/')
expect(normalizeBrowserNavigationUrl('')).toBe(ORCA_BROWSER_BLANK_URL)
expect(normalizeBrowserNavigationUrl('about:blank')).toBe(ORCA_BROWSER_BLANK_URL)
})
it('rejects non-web schemes for in-app navigation', () => {
expect(normalizeBrowserNavigationUrl('javascript:alert(1)')).toBeNull()
expect(normalizeExternalBrowserUrl('about:blank')).toBeNull()
})
// Local HTML preview stays inside the sandboxed guest (createMainWindow will-attach-webview).
it('allows file:// URLs so local HTML can be previewed', () => {
expect(normalizeBrowserNavigationUrl('file:///Users/me/site/index.html')).toBe(
'file:///Users/me/site/index.html'
)
})
it('normalizes pasted absolute local paths to file URLs', () => {
expect(normalizeBrowserNavigationUrl('/Users/me/Downloads/Example.ipynb')).toBe(
'file:///Users/me/Downloads/Example.ipynb'
)
expect(normalizeBrowserNavigationUrl('C:\\Users\\me\\Downloads\\Example.ipynb')).toBe(
'file:///C:/Users/me/Downloads/Example.ipynb'
)
expect(normalizeBrowserNavigationUrl('\\\\server\\share\\Example.ipynb')).toBe(
'file://server/share/Example.ipynb'
)
expect(
normalizeBrowserNavigationUrl('\\\\wsl.localhost\\Ubuntu\\home\\me\\Example.ipynb')
).toBe('file://wsl.localhost/Ubuntu/home/me/Example.ipynb')
})
it('normalizes absolute local paths with spaces and reserved URL characters', () => {
expect(normalizeBrowserNavigationUrl('/Users/me/My Site/index #1.html')).toBe(
'file:///Users/me/My%20Site/index%20%231.html'
)
expect(normalizeBrowserNavigationUrl('C:\\Users\\me\\My Site\\index #1.html')).toBe(
'file:///C:/Users/me/My%20Site/index%20%231.html'
)
expect(normalizeBrowserNavigationUrl('C:\\tmp\\orca & 100% ! ^\\index.html')).toBe(
'file:///C:/tmp/orca%20%26%20100%25%20!%20%5E/index.html'
)
})
// Refuse file URLs externally: a remote page must not drive Finder/Explorer to arbitrary paths.
it('rejects file:// for external opens even though it is allowed in-app', () => {
expect(normalizeExternalBrowserUrl('file:///etc/passwd')).toBeNull()
expect(normalizeExternalBrowserUrl('\\\\server\\share\\Example.ipynb')).toBeNull()
})
it('returns null for non-URL input without search engine opt-in', () => {
expect(normalizeBrowserNavigationUrl('not a url')).toBeNull()
})
it('attempts https:// prefix for bare words without search opt-in', () => {
expect(normalizeBrowserNavigationUrl('singleword')).toBe('https://singleword/')
})
it('treats bare words and multi-word input as search queries when search is enabled', () => {
expect(normalizeBrowserNavigationUrl('react hooks', null)).toBe(
'https://www.google.com/search?q=react%20hooks'
)
expect(normalizeBrowserNavigationUrl('what is typescript', null)).toBe(
'https://www.google.com/search?q=what%20is%20typescript'
)
expect(normalizeBrowserNavigationUrl('singleword', null)).toBe(
'https://www.google.com/search?q=singleword'
)
})
it('respects the search engine parameter', () => {
expect(normalizeBrowserNavigationUrl('react hooks', 'duckduckgo')).toBe(
'https://duckduckgo.com/?q=react%20hooks'
)
expect(normalizeBrowserNavigationUrl('react hooks', 'bing')).toBe(
'https://www.bing.com/search?q=react%20hooks'
)
expect(normalizeBrowserNavigationUrl('react hooks', 'kagi')).toBe(
'https://kagi.com/search?q=react%20hooks'
)
})
it('treats domain-like inputs as URLs, not searches', () => {
expect(normalizeBrowserNavigationUrl('example.com', null)).toBe('https://example.com/')
expect(normalizeBrowserNavigationUrl('github.com/org/repo', null)).toBe(
'https://github.com/org/repo'
)
})
it.each([
['example.com:8443/docs?q=one#section', 'https://example.com:8443/docs?q=one#section'],
['EXAMPLE.COM:443', 'https://example.com/'],
['example.com:80', 'https://example.com:80/'],
['app.localhost:3000', 'http://app.localhost:3000/'],
['app.localhost:443', 'http://app.localhost:443/'],
['app.localhost:80', 'http://app.localhost/'],
['deep.app.localhost:5173/path?x=1#preview', 'http://deep.app.localhost:5173/path?x=1#preview'],
['https://app.localhost:3000', 'https://app.localhost:3000/'],
['http://example.com:80/docs', 'http://example.com/docs'],
['example.com:65535/docs', 'https://example.com:65535/docs'],
['example.com:0', 'https://example.com:0/'],
['APP.LOCALHOST.:443/docs', 'http://app.localhost.:443/docs'],
['[::1]:3000/docs', 'http://[::1]:3000/docs'],
['https://user:[email protected]:8443/docs', 'https://user:[email protected]:8443/docs'],
[
'example.com:8443/[email protected]?next=:80#part',
'https://example.com:8443/[email protected]?next=:80#part'
]
])('navigates a domain with a port: %s', (input, expected) => {
expect(normalizeBrowserNavigationUrl(input, 'google')).toBe(expected)
expect(normalizeBrowserNavigationUrl(input)).toBe(expected)
})
it.each([
'javascript:1234',
'data:1234',
'custom:3000',
'example.com:65536',
'example.com:[email protected]',
'example.com:8443\\evil.test',
'example.com:-1',
'example.com:3.5',
'example.com:8443evil.test'
])('does not turn an unsupported scheme or invalid port into a navigation: %s', (input) => {
expect(normalizeBrowserNavigationUrl(input, 'google')).toBeNull()
})
it('builds search URLs correctly', () => {
expect(buildSearchUrl('hello world', 'google')).toBe(
'https://www.google.com/search?q=hello%20world'
)
expect(buildSearchUrl('hello world', 'duckduckgo')).toBe(
'https://duckduckgo.com/?q=hello%20world'
)
expect(buildSearchUrl('hello world', 'kagi')).toBe('https://kagi.com/search?q=hello%20world')
})
it('encodes Unicode, reserved characters, and emoji for every search engine', () => {
const query = 'snow 雪 &?# 😀'
const encoded = 'snow%20%E9%9B%AA%20%26%3F%23%20%F0%9F%98%80'
for (const engine of ['google', 'duckduckgo', 'bing', 'kagi'] as const) {
expect(buildSearchUrl(query, engine)).toContain(encoded)
}
})
it('replaces unmatched surrogates without changing valid pairs', () => {
expect(buildSearchUrl('\ud800a\udc00😀', 'google')).toBe(
'https://www.google.com/search?q=%EF%BF%BDa%EF%BF%BD%F0%9F%98%80'
)
expect(buildSearchUrl('\ud800', 'google')).toBe('https://www.google.com/search?q=%EF%BF%BD')
})
it('uses a Kagi private session link when configured', () => {
const sessionLink = 'https://kagi.com/search?token=secret&q=%s#ignored'
expect(normalizeKagiSessionLink(sessionLink)).toBe('https://kagi.com/search?token=secret')
expect(
buildSearchUrl('hello world', 'kagi', {
kagiSessionLink: sessionLink
})
).toBe('https://kagi.com/search?token=secret&q=hello+world')
expect(
normalizeBrowserNavigationUrl('hello world', 'kagi', {
kagiSessionLink: sessionLink
})
).toBe('https://kagi.com/search?token=secret&q=hello+world')
})
it('rejects invalid Kagi private session links', () => {
expect(normalizeKagiSessionLink('https://kagi.com/search?q=%s')).toBeNull()
expect(normalizeKagiSessionLink('http://kagi.com/search?token=secret')).toBeNull()
expect(normalizeKagiSessionLink('https://example.com/search?token=secret')).toBeNull()
expect(normalizeKagiSessionLink('https://user:[email protected]/search?token=secret')).toBeNull()
expect(normalizeKagiSessionLink('https://kagi.com:8443/search?token=secret')).toBeNull()
})
it('accepts kagi.com/search/ with trailing slash', () => {
expect(normalizeKagiSessionLink('https://kagi.com/search/?token=secret')).toBe(
'https://kagi.com/search/?token=secret'
)
})
it('collapses duplicate token params in Kagi private session links', () => {
expect(normalizeKagiSessionLink('https://kagi.com/search?token=A&token=B')).toBe(
'https://kagi.com/search?token=A'
)
})
it('redacts Kagi private session tokens from displayable URLs', () => {
expect(redactKagiSessionToken('https://kagi.com/search?token=secret&q=hello+world')).toBe(
'https://kagi.com/search?q=hello+world'
)
expect(redactKagiSessionToken('https://kagi.com/search?q=hello+world')).toBe(
'https://kagi.com/search?q=hello+world'
)
expect(redactKagiSessionToken('https://kagi.com/search/?token=secret&q=hi')).toBe(
'https://kagi.com/search/?q=hi'
)
})
})