/** * Reusable test actions — common UI operations used across spec files. * * All actions use browser.execute() for DOM queries with fallback selectors * to support both Tauri and Electrobun UIs (WebKitGTK reliability pattern). */ import { browser } from '@wdio/globals'; import * as S from './selectors.ts'; /** * Wait for a TCP port to accept connections. Used by CDP-based E2E configs * to wait for the debugging port before connecting WebDriverIO. * * Polls `http://localhost:{port}/json` (CDP discovery endpoint) every 500ms. */ export async function waitForPort(port: number, timeout: number): Promise { const start = Date.now(); while (Date.now() - start < timeout) { try { const res = await fetch(`http://localhost:${port}/json`); if (res.ok) return; } catch { // Port not ready yet — retry } await new Promise(r => setTimeout(r, 500)); } throw new Error(`CDP port ${port} not ready after ${timeout}ms`); } /** Open settings panel via gear icon click */ export async function openSettings(): Promise { // Try clicking settings button — may need multiple attempts on WebKitGTK await browser.execute(() => { const btn = document.querySelector('[data-testid="settings-btn"]') ?? document.querySelector('.sidebar-icon') ?? document.querySelector('.rail-btn'); if (btn) (btn as HTMLElement).click(); }); await browser.pause(300); // Check if panel opened; if not, try keyboard shortcut (Ctrl+,) const opened = await browser.execute(() => document.querySelector('.sidebar-panel, .settings-drawer, .settings-panel') !== null, ); if (!opened) { await browser.keys(['Control', ',']); await browser.pause(300); } // Wait for either settings panel class (Tauri: .sidebar-panel, Electrobun: .settings-drawer) await browser.waitUntil( async () => browser.execute(() => document.querySelector('.sidebar-panel, .settings-drawer, .settings-panel') !== null, ) as Promise, { timeout: 5_000 }, ); } /** Close settings panel */ export async function closeSettings(): Promise { await browser.execute(() => { const btn = document.querySelector('.settings-close') ?? document.querySelector('.panel-close'); if (btn) (btn as HTMLElement).click(); }); await browser.pause(400); } /** Switch to a settings category by index (0-based) */ export async function switchSettingsCategory(index: number): Promise { await browser.execute((idx: number) => { // Tauri: .settings-sidebar .sidebar-item | Electrobun: .settings-tab or .cat-btn const tabs = document.querySelectorAll('.settings-sidebar .sidebar-item, .settings-tab, .cat-btn'); if (tabs[idx]) (tabs[idx] as HTMLElement).click(); }, index); await browser.pause(300); } /** Switch active group by clicking the nth group button (0-based) */ export async function switchGroup(index: number): Promise { await browser.execute((idx: number) => { const groups = document.querySelectorAll('.group-btn:not(.add-group-btn)'); if (groups[idx]) (groups[idx] as HTMLElement).click(); }, index); await browser.pause(300); } /** Type text into the agent prompt input */ export async function sendPrompt(text: string): Promise { const textarea = await browser.$(S.CHAT_INPUT_TEXTAREA); if (await textarea.isExisting()) { await textarea.setValue(text); return; } const input = await browser.$(S.CHAT_INPUT_ALT); if (await input.isExisting()) { await input.setValue(text); } } /** Open command palette via Ctrl+K */ export async function openCommandPalette(): Promise { await browser.keys(['Control', 'k']); await browser.pause(400); } /** Close command palette via Escape */ export async function closeCommandPalette(): Promise { await browser.keys('Escape'); await browser.pause(300); } /** Open search overlay via Ctrl+Shift+F */ export async function openSearch(): Promise { await browser.keys(['Control', 'Shift', 'f']); await browser.pause(400); } /** Close search overlay via Escape */ export async function closeSearch(): Promise { await browser.keys('Escape'); await browser.pause(300); } /** Add a new terminal tab by clicking the add button */ export async function addTerminalTab(): Promise { await browser.execute(() => { const btn = document.querySelector('.tab-add-btn'); if (btn) (btn as HTMLElement).click(); }); await browser.pause(500); } /** Click a project-level tab (model, docs, files, etc.) */ export async function clickProjectTab(tabName: string): Promise { await browser.execute((name: string) => { // Tauri: .ptab | Electrobun: .project-tab or .tab-btn const tabs = document.querySelectorAll('.ptab, .project-tab, .tab-btn'); for (const tab of tabs) { if ((tab as HTMLElement).textContent?.toLowerCase().includes(name.toLowerCase())) { (tab as HTMLElement).click(); return; } } }, tabName); await browser.pause(300); } /** Wait until an element with given selector is displayed */ export async function waitForElement(selector: string, timeout = 5_000): Promise { const el = await browser.$(selector); await el.waitForDisplayed({ timeout }); } /** Check if an element exists and is displayed (safe for optional elements) */ export async function isVisible(selector: string): Promise { return browser.execute((sel: string) => { const el = document.querySelector(sel); if (!el) return false; const style = getComputedStyle(el); return style.display !== 'none' && style.visibility !== 'hidden'; }, selector); } /** Get the display CSS value for an element (for display-toggle awareness) */ export async function getDisplay(selector: string): Promise { return browser.execute((sel: string) => { const el = document.querySelector(sel); if (!el) return 'not-found'; return getComputedStyle(el).display; }, selector); } /** Open notification drawer by clicking bell */ export async function openNotifications(): Promise { await browser.execute(() => { // Tauri: .bell-btn | Electrobun: .notif-btn const btn = document.querySelector('.notif-btn') ?? document.querySelector('.bell-btn') ?? document.querySelector('[data-testid="notification-bell"]'); if (btn) (btn as HTMLElement).click(); }); await browser.pause(400); } /** Close notification drawer */ export async function closeNotifications(): Promise { await browser.execute(() => { // Tauri: .notification-center .backdrop | Electrobun: .notif-backdrop const backdrop = document.querySelector('.notif-backdrop') ?? document.querySelector('.notification-center .backdrop'); if (backdrop) (backdrop as HTMLElement).click(); }); await browser.pause(300); }