Files
orca/tests/e2e/browser-tab.spec.ts
Brennan Benson 80e0bee23b fix(floating-workspace): keep agent launches from moving the main window's tab (#22603)
* fix(floating-workspace): keep agent launches from moving the main window's tab

Launching an agent from the floating workspace's "+" menu switched the main
window off whatever chat or editor tab it was showing and onto its terminals.

The main window's selection is supposed to move only for the worktree it is
showing: browser and editor tab creation, splits, moves and drops all check
`activeWorktreeId === worktreeId` before touching it. Two places did not:

- `launchAgentInNewTab` called `setActiveTabType('terminal')` without a
  worktree, which targets the active worktree whatever worktree the launch
  landed in.
- terminal `createTab` wrote the global `activeTabId` for a tab in any
  worktree.

Both now follow the store rule. The launch still selects its tab within its
own worktree, which is what the floating panel renders.

The floating titlebar button had side-stepped this with an `activate: false`
opt-out plus manual selection. That opt-out had no other caller and is removed;
the button now launches and focuses like every other entry point.

* fix(tabs): scope the remaining launch surface writes to the launch's worktree

Three more launch paths create a terminal tab and then call
`setActiveTabType('terminal')` without a worktree, which targets whatever
worktree is active when the call runs rather than the one the tab landed in:

- the paired-host agent launch, after the host's asynchronous create
- Session History resume, which can target a worktree the user is not viewing
  and activates it only afterwards
- sleeping-agent resume, which the activation gate runs after asynchronous
  readiness checks, by which time the user may have moved to another worktree

Each now names its worktree, like the local agent launch. The new tab still
lands selected when the user switches to that worktree.

* test(tabs): pin the paired-host launch scope in its existing web-runtime test

* test(tabs): type the left-worktree resume fixture instead of casting it

* refactor(tabs): require the worktree that setActiveTabType applies to

`setActiveTabType(type, worktreeId?)` quietly fell back to the active
worktree when the caller left the worktree out. A caller acting on a tab in
another worktree (the floating workspace, a background launch, a reveal that
lands after an async step) therefore retyped whatever the main window was
showing. The launch paths fixed earlier in this branch were instances of that;
54 other callers still relied on the fallback.

The worktree is now a required argument (nullable only for the no-active-
worktree case), so every caller states which worktree it means and a new
unscoped call fails to compile. Each call site passes the worktree of the tab
it acts on; where that is by construction the active worktree (shortcuts,
palette, tab strip), the result is unchanged. `activateTabAndFocusPane`
resolves the tab's owning worktree the same way `setActiveTab` does.

End-to-end helpers that drive the store directly pass the active worktree,
which keeps their previous behaviour.

* fix(floating-workspace): let the floating New Terminal activate its own tab

The floating "+" New Terminal created its tab with `activate: false` and then
selected it with `activateTab`, because creating an active tab used to write
the main window's selected tab even for another worktree. `createTab` now
activates a tab only within its own worktree's group unless that worktree is
the one on screen, so the workaround is no longer needed.

Creating the tab active also moves the floating workspace's remembered tab to
the new one; before, it stayed on the previously selected floating tab, which
auto-acknowledge reads to decide which floating agent the user is looking at.

* refactor(floating-workspace): route every floating New Terminal through one creator

The floating "+" New Terminal had stopped deferring activation, but Cmd+T with the
floating panel focused still went through a separate creator that created the tab
inactive and activated it by hand, which left the floating workspace's remembered tab
on the previous tab. Both now call createFloatingWorkspaceTerminalTab, which creates
the tab active in its own group and focuses it.

* docs(tabs): say why an unowned tab id keeps the on-screen worktree scope
2026-09-24 10:54:43 -07:00

843 lines
29 KiB
TypeScript

/**
* E2E tests for the browser tab: creating browser tabs and state retention.
*
* User Prompt:
* - Browser works and also retains state when switching tabs etc.
*/
import { test, expect } from './helpers/orca-app'
import { createServer, type Server } from 'node:http'
import type { AddressInfo } from 'node:net'
import {
waitForSessionReady,
waitForActiveWorktree,
getActiveWorktreeId,
getActiveTabType,
getBrowserTabs,
getAllWorktreeIds,
switchToOtherWorktree,
switchToWorktree,
ensureTerminalVisible
} from './helpers/store'
import { startBrowserLinkServer } from './helpers/browser-link-server'
type CreatedBrowserTab = {
id: string
pageId: string | null
}
async function createBrowserTab(
page: Parameters<typeof getActiveWorktreeId>[0],
worktreeId: string,
url?: string,
title = 'New Browser Tab'
): Promise<CreatedBrowserTab | null> {
return page.evaluate(
({ targetWorktreeId, targetUrl, targetTitle }) => {
const store = window.__store
if (!store) {
return null
}
const state = store.getState()
const tab = state.createBrowserTab(
targetWorktreeId,
targetUrl ?? state.browserDefaultUrl ?? 'about:blank',
{
title: targetTitle,
activate: true
}
)
return { id: tab.id, pageId: tab.activePageId ?? null }
},
{ targetWorktreeId: worktreeId, targetUrl: url, targetTitle: title }
)
}
async function switchToTerminalTab(
page: Parameters<typeof getActiveWorktreeId>[0],
worktreeId: string
): Promise<void> {
await page.evaluate((targetWorktreeId) => {
const store = window.__store
if (!store) {
return
}
const state = store.getState()
const terminalTab = (state.tabsByWorktree[targetWorktreeId] ?? [])[0]
if (terminalTab) {
state.setActiveTab(terminalTab.id)
}
state.setActiveTabType('terminal', store.getState().activeWorktreeId)
}, worktreeId)
}
async function switchToBrowserTab(
page: Parameters<typeof getActiveWorktreeId>[0],
worktreeId: string,
browserTabId: string
): Promise<void> {
await page.evaluate(
({ targetWorktreeId, targetBrowserTabId }) => {
const store = window.__store
if (!store) {
return
}
const state = store.getState()
if (
(state.browserTabsByWorktree[targetWorktreeId] ?? []).some(
(tab) => tab.id === targetBrowserTabId
)
) {
state.setActiveBrowserTab(targetBrowserTabId)
}
},
{ targetWorktreeId: worktreeId, targetBrowserTabId: browserTabId }
)
}
async function startBrowserFormServer(host = '127.0.0.1'): Promise<{
url: (label: string) => string
close: () => Promise<void>
}> {
const server = createServer((request, response) => {
const label = new URL(request.url ?? '/', 'http://127.0.0.1').pathname.slice(1)
response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
response.end(`
<!doctype html>
<html>
<body>
<label>${label}<input id="q" /></label>
</body>
</html>
`)
})
await new Promise<void>((resolve) => server.listen(0, host, resolve))
const port = (server.address() as AddressInfo).port
return {
url: (label: string) => `http://${host}:${port}/${encodeURIComponent(label)}`,
close: () => closeServer(server)
}
}
async function startBrowserWindowCloseServer(): Promise<{
url: string
sourceUrl: string
close: () => Promise<void>
}> {
const server = createServer((request, response) => {
const origin = `http://127.0.0.1:${(server.address() as AddressInfo).port}`
const pathname = new URL(request.url ?? '/', origin).pathname
response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
if (pathname === '/source') {
response.end(`
<!doctype html>
<html>
<head><title>Close link source</title></head>
<body><a id="window-close-link" href="${origin}/window-close" target="_blank">Open close page</a></body>
</html>
`)
return
}
response.end(`
<!doctype html>
<html>
<head><title>Window close repro</title></head>
<body>
<p id="s">Attempting close…</p>
<script>
window.close()
setTimeout(() => {
document.getElementById('s').textContent =
'window.close() was blocked (expected).'
}, 200)
</script>
</body>
</html>
`)
})
await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve))
const port = (server.address() as AddressInfo).port
return {
url: `http://127.0.0.1:${port}/window-close`,
sourceUrl: `http://127.0.0.1:${port}/source`,
close: () => closeServer(server)
}
}
async function readBrowserWindowCloseStatus(
page: Parameters<typeof getActiveWorktreeId>[0],
browserTabId: string
): Promise<string> {
return page.evaluate(async (targetBrowserTabId) => {
const slot = document.querySelector(`[data-browser-overlay-tab-id="${targetBrowserTabId}"]`)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
return 'webview missing'
}
try {
return (await webview.executeJavaScript(
'document.querySelector("#s")?.textContent ?? "status missing"'
)) as string
} catch {
return 'guest lost'
}
}, browserTabId)
}
async function closeServer(server: Server): Promise<void> {
await new Promise<void>((resolve, reject) =>
server.close((error) => {
if (error) {
reject(error)
return
}
resolve()
})
)
}
async function clickBrowserLink(
page: Parameters<typeof getActiveWorktreeId>[0],
browserTabId: string,
selector: string,
options: {
modifiers?: ('meta' | 'control' | 'shift')[]
button?: 'left' | 'middle' | 'right'
frameSelector?: string
} = {}
): Promise<void> {
await page.evaluate(
async ({ targetBrowserTabId, targetSelector, inputModifiers, button, frameSelector }) => {
const slot = [...document.querySelectorAll('[data-browser-overlay-tab-id]')].find(
(candidate) => candidate.getAttribute('data-browser-overlay-tab-id') === targetBrowserTabId
)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
throw new Error(`Missing webview for browser tab ${targetBrowserTabId}`)
}
const point = (await webview.executeJavaScript(`(async () => {
const deadline = Date.now() + 5000
while (Date.now() < deadline) {
const frame = ${JSON.stringify(frameSelector)}
? document.querySelector(${JSON.stringify(frameSelector)})
: null
const root = frame?.contentDocument ?? document
const linkRect = root.querySelector(${JSON.stringify(targetSelector)})?.getBoundingClientRect()
if (linkRect) {
const frameRect = frame?.getBoundingClientRect()
return {
x: (frameRect?.left ?? 0) + linkRect.left + linkRect.width / 2,
y: (frameRect?.top ?? 0) + linkRect.top + linkRect.height / 2
}
}
await new Promise((resolve) => setTimeout(resolve, 25))
}
return null
})()`)) as { x: number; y: number } | null
if (!point) {
throw new Error(`Missing browser link ${targetSelector}`)
}
const holdShift = inputModifiers.includes('shift')
if (holdShift) {
await webview.sendInputEvent({ type: 'keyDown', keyCode: 'Shift', modifiers: ['shift'] })
}
try {
await webview.sendInputEvent({ type: 'mouseMove', modifiers: inputModifiers, ...point })
await webview.sendInputEvent({
type: 'mouseDown',
button,
clickCount: 1,
modifiers: inputModifiers,
...point
})
await webview.sendInputEvent({
type: 'mouseUp',
button,
clickCount: 1,
modifiers: inputModifiers,
...point
})
} finally {
if (holdShift) {
await webview.sendInputEvent({ type: 'keyUp', keyCode: 'Shift' })
}
}
},
{
targetBrowserTabId: browserTabId,
targetSelector: selector,
inputModifiers: options.modifiers ?? [],
button: options.button ?? 'left',
frameSelector: options.frameSelector ?? null
}
)
}
async function waitForTabIdByExactTitle(
page: Parameters<typeof getActiveWorktreeId>[0],
title: string
): Promise<string> {
const resolveTabId = (): Promise<string | null> =>
page.locator('[data-tab-id]').evaluateAll((tabs, exactTitle) => {
const tab = tabs.find((candidate) => candidate.textContent?.trim() === exactTitle)
return tab?.getAttribute('data-tab-id') ?? null
}, title)
await expect.poll(resolveTabId, { timeout: 10_000 }).not.toBeNull()
return (await resolveTabId()) as string
}
async function expectBrowserTabActive(
page: Parameters<typeof getActiveWorktreeId>[0],
title: string
): Promise<void> {
const tabId = await waitForTabIdByExactTitle(page, title)
await expect(page.locator(`[data-browser-overlay-tab-id="${tabId}"]`)).toHaveCSS('opacity', '1')
}
async function expectBrowserTabOpenedInBackground(
page: Parameters<typeof getActiveWorktreeId>[0],
sourceTabId: string,
title: string
): Promise<void> {
const openedTabId = await waitForTabIdByExactTitle(page, title)
await expect(page.locator(`[data-browser-overlay-tab-id="${sourceTabId}"]`)).toHaveCSS(
'opacity',
'1'
)
await expect(page.locator(`[data-browser-overlay-tab-id="${openedTabId}"]`)).toHaveCSS(
'opacity',
'0'
)
}
async function readBrowserInputValue(
page: Parameters<typeof getActiveWorktreeId>[0],
browserTabId: string
): Promise<string | null> {
return page.evaluate(async (targetBrowserTabId) => {
const slot = [...document.querySelectorAll('[data-browser-overlay-tab-id]')].find(
(candidate) => candidate.getAttribute('data-browser-overlay-tab-id') === targetBrowserTabId
)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
return null
}
try {
return await webview.executeJavaScript('document.querySelector("#q")?.value ?? null')
} catch {
return null
}
}, browserTabId)
}
async function writeBrowserInputValue(
page: Parameters<typeof getActiveWorktreeId>[0],
browserTabId: string,
value: string
): Promise<void> {
await expect
.poll(async () => readBrowserInputValue(page, browserTabId), { timeout: 5_000 })
.not.toBeNull()
await page.evaluate(
async ({ targetBrowserTabId, nextValue }) => {
const slot = [...document.querySelectorAll('[data-browser-overlay-tab-id]')].find(
(candidate) => candidate.getAttribute('data-browser-overlay-tab-id') === targetBrowserTabId
)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
throw new Error(`Missing webview for browser tab ${targetBrowserTabId}`)
}
await webview.executeJavaScript(
`document.querySelector("#q").value = ${JSON.stringify(nextValue)}`
)
},
{ targetBrowserTabId: browserTabId, nextValue: value }
)
await expect
.poll(async () => readBrowserInputValue(page, browserTabId), { timeout: 5_000 })
.toBe(value)
}
test.describe('Browser Tab', () => {
test.beforeEach(async ({ orcaPage }) => {
await waitForSessionReady(orcaPage)
await waitForActiveWorktree(orcaPage)
await ensureTerminalVisible(orcaPage)
})
/**
* User Prompt:
* - Browser works and also retains state when switching tabs etc.
*/
test('creating a browser tab adds it and activates browser view', async ({ orcaPage }) => {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const browserTabsBefore = await getBrowserTabs(orcaPage, worktreeId)
await createBrowserTab(orcaPage, worktreeId)
// Wait for the browser tab to appear in the store
await expect
.poll(async () => (await getBrowserTabs(orcaPage, worktreeId)).length, { timeout: 5_000 })
.toBe(browserTabsBefore.length + 1)
// The active tab type should switch to 'browser'
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 3_000 }).toBe('browser')
})
/**
* User Prompt:
* - Browser works and also retains state when switching tabs etc.
*/
test('browser tab is created and active in the store', async ({ orcaPage }) => {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
await createBrowserTab(orcaPage, worktreeId)
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 5_000 }).toBe('browser')
// Verify the browser tab exists in the store
const browserTabs = await getBrowserTabs(orcaPage, worktreeId)
expect(browserTabs.length).toBeGreaterThan(0)
// The active browser tab should have a URL (even if it's about:blank or the default)
const activeBrowserTabId = await orcaPage.evaluate(() => {
const store = window.__store
return store?.getState().activeBrowserTabId ?? null
})
expect(activeBrowserTabId).not.toBeNull()
})
/**
* User Prompt:
* - Browser works and also retains state when switching tabs etc.
*/
test('browser tab retains state when switching to terminal and back', async ({ orcaPage }) => {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
await createBrowserTab(orcaPage, worktreeId)
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 5_000 }).toBe('browser')
// Record the browser tab info
const browserTabsBefore = await getBrowserTabs(orcaPage, worktreeId)
expect(browserTabsBefore.length).toBeGreaterThan(0)
const browserTabId = browserTabsBefore.at(-1)?.id
expect(browserTabId).toBeTruthy()
// Switch to the terminal view
await switchToTerminalTab(orcaPage, worktreeId)
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 3_000 }).toBe('terminal')
// Switch back to browser tab
await switchToBrowserTab(orcaPage, worktreeId, browserTabId!)
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 3_000 }).toBe('browser')
// The browser tab should still exist with the same ID
const browserTabsAfter = await getBrowserTabs(orcaPage, worktreeId)
const tabStillExists = browserTabsAfter.some((tab) => tab.id === browserTabId)
expect(tabStillExists).toBe(true)
})
test('browser webview form state survives switching between browser tabs', async ({
orcaPage
}) => {
const formServer = await startBrowserFormServer()
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const firstTab = await createBrowserTab(
orcaPage,
worktreeId,
formServer.url('First search'),
'First Form'
)
expect(firstTab?.id).toBeTruthy()
await writeBrowserInputValue(orcaPage, firstTab!.id, 'first typed value')
const secondTab = await createBrowserTab(
orcaPage,
worktreeId,
formServer.url('Second search'),
'Second Form'
)
expect(secondTab?.id).toBeTruthy()
await writeBrowserInputValue(orcaPage, secondTab!.id, 'second typed value')
// Why: switching browser tabs used to unmount and reparent the inactive
// Electron webview, which recreated the guest document and erased form DOM.
await switchToBrowserTab(orcaPage, worktreeId, firstTab!.id)
await expect
.poll(async () => readBrowserInputValue(orcaPage, firstTab!.id), { timeout: 5_000 })
.toBe('first typed value')
await switchToBrowserTab(orcaPage, worktreeId, secondTab!.id)
await expect
.poll(async () => readBrowserInputValue(orcaPage, secondTab!.id), { timeout: 5_000 })
.toBe('second typed value')
} finally {
await formServer.close()
}
})
test('browser page reload restores the configured 100% zoom', async ({ orcaPage }) => {
const formServer = await startBrowserFormServer()
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const browserTab = await createBrowserTab(
orcaPage,
worktreeId,
formServer.url('Zoom reload'),
'Zoom Reload'
)
expect(browserTab?.id).toBeTruthy()
await expect
.poll(async () => readBrowserInputValue(orcaPage, browserTab!.id), { timeout: 5_000 })
.not.toBeNull()
const zoomLevels = await orcaPage.evaluate(async (browserTabId) => {
const slot = document.querySelector(`[data-browser-overlay-tab-id="${browserTabId}"]`)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
throw new Error(`Missing webview for browser tab ${browserTabId}`)
}
const levels = [webview.getZoomLevel()]
webview.setZoomLevel(0.5)
for (let reload = 0; reload < 3; reload += 1) {
await new Promise<void>((resolve) => {
webview.addEventListener('dom-ready', () => resolve(), { once: true })
if (reload === 1) {
webview.reloadIgnoringCache()
} else {
webview.reload()
}
})
levels.push(webview.getZoomLevel())
}
return levels
}, browserTab!.id)
expect(zoomLevels).toEqual([0, 0, 0, 0])
} finally {
await formServer.close()
}
})
test('Cmd/Ctrl+0 resets a zoomed browser page to 100%', async ({ orcaPage }) => {
const formServer = await startBrowserFormServer()
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const browserTab = await createBrowserTab(
orcaPage,
worktreeId,
formServer.url('Zoom reset'),
'Zoom Reset'
)
expect(browserTab?.id).toBeTruthy()
await expect
.poll(async () => readBrowserInputValue(orcaPage, browserTab!.id), { timeout: 5_000 })
.not.toBeNull()
await orcaPage.evaluate(
async ({ browserTabId, browserPageId, modifier }) => {
const slot = document.querySelector(`[data-browser-overlay-tab-id="${browserTabId}"]`)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
throw new Error(`Missing webview for browser tab ${browserTabId}`)
}
window.dispatchEvent(
new CustomEvent('orca:browser-page-zoom', {
detail: { browserPageId, direction: 'in' }
})
)
await webview.sendInputEvent({ type: 'keyDown', keyCode: '0', modifiers: [modifier] })
await webview.sendInputEvent({ type: 'keyUp', keyCode: '0', modifiers: [modifier] })
},
{
browserTabId: browserTab!.id,
browserPageId: browserTab!.pageId ?? browserTab!.id,
modifier: process.platform === 'darwin' ? 'meta' : 'control'
}
)
await expect
.poll(() =>
orcaPage.evaluate((browserTabId) => {
const slot = document.querySelector(`[data-browser-overlay-tab-id="${browserTabId}"]`)
return (slot?.querySelector('webview') as Electron.WebviewTag | null)?.getZoomLevel()
}, browserTab!.id)
)
.toBe(0)
} finally {
await formServer.close()
}
})
test('reloading one browser tab does not adopt another tab zoom', async ({ orcaPage }) => {
const [formServerA, formServerB] = await Promise.all([
startBrowserFormServer(),
startBrowserFormServer('localhost')
])
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const tabA = await createBrowserTab(orcaPage, worktreeId, formServerA.url('Zoom A'), 'Zoom A')
const tabB = await createBrowserTab(orcaPage, worktreeId, formServerB.url('Zoom B'), 'Zoom B')
expect(tabA?.id).toBeTruthy()
expect(tabB?.id).toBeTruthy()
for (const tab of [tabA, tabB]) {
await expect
.poll(async () => readBrowserInputValue(orcaPage, tab!.id), { timeout: 5_000 })
.not.toBeNull()
}
const levels = await orcaPage.evaluate(
async ({ tabAId, tabBId, pageBId }) => {
const webviewFor = (id: string): Electron.WebviewTag => {
const slot = document.querySelector(`[data-browser-overlay-tab-id="${id}"]`)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
throw new Error(`Missing webview for browser tab ${id}`)
}
return webview
}
const webviewA = webviewFor(tabAId)
const webviewB = webviewFor(tabBId)
// Zoom only tab B through the real renderer zoom path (also writes the shared setting).
for (let step = 0; step < 2; step += 1) {
window.dispatchEvent(
new CustomEvent('orca:browser-page-zoom', {
detail: { browserPageId: pageBId, direction: 'in' }
})
)
await new Promise((resolve) => setTimeout(resolve, 100))
}
const zoomedB = webviewB.getZoomLevel()
const untouchedA = webviewA.getZoomLevel()
await new Promise<void>((resolve) => {
webviewA.addEventListener('dom-ready', () => resolve(), { once: true })
webviewA.reload()
})
return { zoomedB, untouchedA, reloadedA: webviewA.getZoomLevel() }
},
{ tabAId: tabA!.id, tabBId: tabB!.id, pageBId: tabB!.pageId ?? tabB!.id }
)
expect(levels.zoomedB).toBeGreaterThan(0)
expect(levels.untouchedA).toBe(0)
// Regression: reasserting the shared default would drag tab A to tab B's zoom.
expect(levels.reloadedA).toBe(0)
} finally {
await Promise.all([formServerA.close(), formServerB.close()])
}
})
test('new-tab link gestures follow Chrome foreground and background behavior', async ({
electronApp,
orcaPage
}) => {
const linkServer = await startBrowserLinkServer()
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const sourceTab = await createBrowserTab(
orcaPage,
worktreeId,
linkServer.sourceUrl,
'Source page'
)
expect(sourceTab?.id).toBeTruthy()
const baseWindowCount = await electronApp.evaluate(
({ BaseWindow }) => BaseWindow.getAllWindows().length
)
// A plain main-frame target=_blank click must not navigate the source tab away.
const sourceTabLocator = orcaPage.locator(`[data-tab-id="${sourceTab!.id}"]`)
await clickBrowserLink(orcaPage, sourceTab!.id, '#blank-link')
await expectBrowserTabActive(orcaPage, 'Blank target destination')
await expect(sourceTabLocator).toContainText('Source page')
await switchToBrowserTab(orcaPage, worktreeId, sourceTab!.id)
// Context-menu links keep the source visible until the new tab is selected.
await clickBrowserLink(orcaPage, sourceTab!.id, '#external-link', { button: 'right' })
await orcaPage
.getByRole('menuitem', { name: 'Open Link In Orca Browser', exact: true })
.click()
await expectBrowserTabOpenedInBackground(orcaPage, sourceTab!.id, 'Linked destination')
await clickBrowserLink(orcaPage, sourceTab!.id, '#frame-link', {
frameSelector: '#link-frame'
})
await expectBrowserTabActive(orcaPage, 'Frame destination')
await switchToBrowserTab(orcaPage, worktreeId, sourceTab!.id)
await clickBrowserLink(orcaPage, sourceTab!.id, '#frame-modifier-link', {
frameSelector: '#link-frame',
modifiers: process.platform === 'darwin' ? ['meta'] : ['control']
})
await expectBrowserTabOpenedInBackground(
orcaPage,
sourceTab!.id,
'Frame modifier destination'
)
await clickBrowserLink(orcaPage, sourceTab!.id, '#frame-middle-link', {
button: 'middle',
frameSelector: '#link-frame'
})
await expectBrowserTabOpenedInBackground(orcaPage, sourceTab!.id, 'Frame middle destination')
await clickBrowserLink(orcaPage, sourceTab!.id, '#modifier-link', {
modifiers: process.platform === 'darwin' ? ['meta'] : ['control']
})
await expectBrowserTabOpenedInBackground(orcaPage, sourceTab!.id, 'Modifier destination')
await clickBrowserLink(orcaPage, sourceTab!.id, '#frame-shift-middle-link', {
button: 'middle',
modifiers: ['shift'],
frameSelector: '#link-frame'
})
await expectBrowserTabActive(orcaPage, 'Frame shift middle destination')
await switchToBrowserTab(orcaPage, worktreeId, sourceTab!.id)
const tabCountBeforeCancelledClick = await orcaPage.locator('[data-tab-id]').count()
await clickBrowserLink(orcaPage, sourceTab!.id, '#cancelled-link')
await expect(
orcaPage.locator('[data-tab-id]').filter({ hasText: 'Click handled in page' })
).toBeVisible({ timeout: 10_000 })
await expect(orcaPage.locator('[data-tab-id]')).toHaveCount(tabCountBeforeCancelledClick)
await clickBrowserLink(orcaPage, sourceTab!.id, '#middle-link', { button: 'middle' })
await expectBrowserTabOpenedInBackground(orcaPage, sourceTab!.id, 'Middle-click destination')
await expect
.poll(() => electronApp.evaluate(({ BaseWindow }) => BaseWindow.getAllWindows().length), {
timeout: 5_000
})
.toBe(baseWindowCount)
} finally {
await linkServer.close()
}
})
test('blocked window.close in a link-created tab does not break tab switching', async ({
orcaPage
}) => {
const closeServer = await startBrowserWindowCloseServer()
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const neighboringTab = await createBrowserTab(
orcaPage,
worktreeId,
'about:blank',
'Neighboring tab'
)
const sourceTab = await createBrowserTab(
orcaPage,
worktreeId,
closeServer.sourceUrl,
'Close link source'
)
expect(neighboringTab?.id).toBeTruthy()
expect(sourceTab?.id).toBeTruthy()
await clickBrowserLink(orcaPage, sourceTab!.id, '#window-close-link')
let closeTabId: string | null = null
await expect
.poll(async () => {
const tabs = await getBrowserTabs(orcaPage, worktreeId)
closeTabId = tabs.find((tab) => tab.url === closeServer.url)?.id ?? null
return closeTabId
})
.not.toBeNull()
await orcaPage.locator(`[data-tab-id="${neighboringTab!.id}"]`).click()
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 5_000 }).toBe('browser')
await expect
.poll(() => readBrowserWindowCloseStatus(orcaPage, closeTabId!), { timeout: 5_000 })
.toContain('window.close() was blocked')
} finally {
await closeServer.close()
}
})
test('directly created browser tabs block window.close and remain usable', async ({
orcaPage
}) => {
const closeServer = await startBrowserWindowCloseServer()
try {
const worktreeId = (await getActiveWorktreeId(orcaPage))!
const directTab = await createBrowserTab(
orcaPage,
worktreeId,
closeServer.url,
'Direct close tab'
)
expect(directTab?.id).toBeTruthy()
await expect
.poll(() => readBrowserWindowCloseStatus(orcaPage, directTab!.id), { timeout: 5_000 })
.toContain('window.close() was blocked')
await expect
.poll(
() =>
orcaPage.evaluate(async (targetBrowserTabId) => {
const slot = document.querySelector(
`[data-browser-overlay-tab-id="${targetBrowserTabId}"]`
)
const webview = slot?.querySelector('webview') as Electron.WebviewTag | null
if (!webview) {
return 'webview missing'
}
try {
return (await webview.executeJavaScript(`(() => {
window.close = () => 'replacement-called'
return window.close() === 'replacement-called' ? 'replacement-called' : 'blocked'
})()`)) as string
} catch {
return 'guest unavailable'
}
}, directTab!.id),
{ timeout: 5_000 }
)
.toBe('blocked')
} finally {
await closeServer.close()
}
})
/**
* User Prompt:
* - Browser works and also retains state when switching tabs etc.
*/
test('browser tab retains state when switching worktrees and back', async ({ orcaPage }) => {
const allWorktreeIds = await getAllWorktreeIds(orcaPage)
if (allWorktreeIds.length < 2) {
test.skip(true, 'Need at least 2 worktrees to test worktree switching')
}
const worktreeId = (await getActiveWorktreeId(orcaPage))!
await createBrowserTab(orcaPage, worktreeId)
await expect.poll(async () => getActiveTabType(orcaPage), { timeout: 5_000 }).toBe('browser')
const browserTabsBefore = await getBrowserTabs(orcaPage, worktreeId)
expect(browserTabsBefore.length).toBeGreaterThan(0)
// Switch to a different worktree via the store
const otherId = await switchToOtherWorktree(orcaPage, worktreeId)
expect(otherId).not.toBeNull()
await expect.poll(async () => getActiveWorktreeId(orcaPage), { timeout: 5_000 }).toBe(otherId)
// Switch back to the original worktree
await switchToWorktree(orcaPage, worktreeId)
await expect
.poll(async () => getActiveWorktreeId(orcaPage), { timeout: 5_000 })
.toBe(worktreeId)
// Browser tabs should still be preserved
const browserTabsAfter = await getBrowserTabs(orcaPage, worktreeId)
expect(browserTabsAfter.length).toBe(browserTabsBefore.length)
})
})