// apps/desktop/tests/e2e/support/electron-app.ts // 데스크톱 E2E 의 단일 진입점. // // 이 픽스처가 책임지는 것: // 1. `out/main/index.js` 빌드 산출물 확인 (없으면 "빌드부터 하라"는 메시지로 즉시 실패) // 2. 테스트마다 고유한 user-data 디렉터리 → 스펙 간 오염·순서 의존 제거 (Playwright Best Practices: isolation) // 3. 메인 창 판별(팝업 창 제외)과 온보딩 우회를 한 곳에서 // 4. 렌더러 pageerror/console error 수집 → 각 테스트가 마지막에 단정 // // 여기서 하는 모든 조작은 사용자가 보는 표면(창·브라우저·IPC 설정)뿐이다. // 스크린샷은 남기지 않는다. 실패 진단은 Playwright trace 가 담당한다(playwright.config.ts). import { randomUUID } from 'node:crypto' import { access, mkdtemp, rm } from 'node:fs/promises' import { tmpdir } from 'node:os' import path from 'node:path' import { _electron as electron, expect as baseExpect, test as base } from '@playwright/test' import type { ElectronApplication, Page } from '@playwright/test' const APP_ENTRY = path.resolve(__dirname, '../../../out/main/index.js') const MAIN_WINDOW_TIMEOUT_MS = 30_000 export interface MainWindowContext { app: ElectronApplication window: Page /** 렌더러에서 예상치 못하게 찍힌 console.error (Electron 보안 경고/CSP/리소스 로드 실패는 제외) */ consoleErrors: string[] /** 잡히지 않은 렌더러 예외 */ pageErrors: string[] } interface Options { /** false 면 온보딩을 우회하지 않고 첫 실행 상태로 띄운다. */ onboardingCompleted: boolean } const IGNORED_CONSOLE_PATTERNS = [ 'Electron Security Warning', 'Content Security Policy', 'Failed to load resource', 'favicon.ico', 'net::ERR_', ] function isIgnoredConsoleError(text: string): boolean { return IGNORED_CONSOLE_PATTERNS.some((pattern) => text.includes(pattern)) } async function waitForMainWindow(app: ElectronApplication): Promise { const deadline = Date.now() + MAIN_WINDOW_TIMEOUT_MS while (Date.now() < deadline) { for (const candidate of app.windows()) { try { const url = candidate.url() if (url.includes('index.html') && !url.includes('popups/')) return candidate } catch { // 창이 아직 이동 중이다. 다음 폴링에서 다시 본다. } } await new Promise((resolve) => setTimeout(resolve, 250)) } throw new Error( `메인 창이 ${MAIN_WINDOW_TIMEOUT_MS}ms 안에 나타나지 않았습니다. 열린 창: ${app .windows() .map((w) => { try { return w.url() } catch { return '' } }) .join(', ')}`, ) } interface ConfigBridge { config?: { set(params: { key: string; value: unknown }): Promise } } async function applyConfigBypass(window: Page, onboardingCompleted: boolean): Promise { await window.evaluate(async (completed) => { const bridge = (window as unknown as { electronAPI?: ConfigBridge }).electronAPI if (!bridge?.config) { throw new Error('electronAPI.config 가 없습니다. preload 브리지가 노출되지 않았습니다.') } await bridge.config.set({ key: 'onboardingCompleted', value: completed }) await bridge.config.set({ key: 'appUsageMode', value: 'online' }) await bridge.config.set({ key: 'llmBackend', value: 'online' }) }, onboardingCompleted) await window.reload() await window.waitForLoadState('domcontentloaded') await baseExpect(window.getByRole('navigation')).toBeVisible({ timeout: 15_000 }) } export const test = base.extend({ onboardingCompleted: [true, { option: true }], mainWindow: async ({ onboardingCompleted }, use) => { await access(APP_ENTRY).catch(() => { throw new Error( `데스크톱 E2E 는 빌드 산출물이 필요합니다: ${APP_ENTRY} 가 없습니다. ` + '`npm run build --workspace=@d3ro/desktop` 를 먼저 실행하세요.', ) }) const userDataDir = await mkdtemp(path.join(tmpdir(), `d3ro-e2e-${randomUUID()}-`)) const consoleErrors: string[] = [] const pageErrors: string[] = [] const app = await electron.launch({ args: [APP_ENTRY, '--disable-gpu', '--no-sandbox', `--user-data-dir=${userDataDir}`], env: { ...process.env, NODE_ENV: 'test' }, }) try { const window = await waitForMainWindow(app) await window.waitForLoadState('domcontentloaded') window.on('pageerror', (error) => pageErrors.push(error.message)) window.on('console', (message) => { if (message.type() !== 'error') return const text = message.text() if (!isIgnoredConsoleError(text)) consoleErrors.push(text) }) await applyConfigBypass(window, onboardingCompleted) await use({ app, window, consoleErrors, pageErrors }) } finally { await app.close().catch(() => undefined) await rm(userDataDir, { recursive: true, force: true }).catch(() => undefined) } }, }) export { expect } from '@playwright/test' /** 렌더러가 조용히 실패하지 않았음을 테스트 끝에서 확인한다. */ export function expectNoRuntimeErrors(context: MainWindowContext): void { baseExpect(context.pageErrors, '잡히지 않은 렌더러 예외').toEqual([]) baseExpect(context.consoleErrors, '렌더러 console.error').toEqual([]) } /** 사이드바 항목을 눌러 화면을 옮긴다. 현재 화면 표시(aria-current)까지 확인한다. */ export async function goToRoute(context: MainWindowContext, route: string): Promise { const button = context.window.getByRole('navigation').getByTestId(`nav-${route}`) await button.click() await baseExpect(button).toHaveAttribute('aria-current', 'page') }