Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Add local playwright E2E tests in browser extension for improved speed (#1404)

Leendert de Borstcdf661e29b15
diff --git a/apps/browser-extension/.gitignore b/apps/browser-extension/.gitignore
index 940e4b7c0..302b2e412 100644
--- a/apps/browser-extension/.gitignore
+++ b/apps/browser-extension/.gitignore
@@ -24,3 +24,8 @@ web-ext.config.ts
*.njsproj
*.sln
*.sw?
+
+# Test related output files
+playwright-report
+tests/screenshots
+test-results
diff --git a/apps/browser-extension/package-lock.json b/apps/browser-extension/package-lock.json
index efa3e883d..4c4714d0c 100644
--- a/apps/browser-extension/package-lock.json
+++ b/apps/browser-extension/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "aliasvault-browser-extension",
- "version": "0.25.0",
+ "version": "0.26.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "aliasvault-browser-extension",
- "version": "0.25.0",
+ "version": "0.26.0",
"hasInstallScript": true,
"dependencies": {
"@hookform/resolvers": "^5.1.1",
@@ -28,6 +28,7 @@
"yup": "^1.6.1"
},
"devDependencies": {
+ "@playwright/test": "^1.57.0",
"@types/chrome": "^0.0.280",
"@types/jsdom": "^21.1.7",
"@types/node": "^22.13.10",
@@ -1610,6 +1611,22 @@
"node": ">=14"
}
},
+ "node_modules/@playwright/test": {
+ "version": "1.57.0",
+ "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.57.0.tgz",
+ "integrity": "sha512-6TyEnHgd6SArQO8UO2OMTxshln3QMWBtPGrOCgs3wVEmQmwyuNtB10IZMfmYDE0riwNR1cu4q+pPcxMVtaG3TA==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "playwright": "1.57.0"
+ },
+ "bin": {
+ "playwright": "cli.js"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
"node_modules/@pnpm/config.env-replace": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/@pnpm/config.env-replace/-/config.env-replace-1.1.0.tgz",
@@ -9020,6 +9037,53 @@
"pathe": "^2.0.3"
}
},
+ "node_modules/playwright": {
+ "version": "1.57.0",
+ "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.57.0.tgz",
+ "integrity": "sha512-ilYQj1s8sr2ppEJ2YVadYBN0Mb3mdo9J0wQ+UuDhzYqURwSoW4n1Xs5vs7ORwgDGmyEh33tRMeS8KhdkMoLXQw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "playwright-core": "1.57.0"
+ },
+ "bin": {
+ "playwright": "cli.js"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "optionalDependencies": {
+ "fsevents": "2.3.2"
+ }
+ },
+ "node_modules/playwright-core": {
+ "version": "1.57.0",
+ "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.57.0.tgz",
+ "integrity": "sha512-agTcKlMw/mjBWOnD6kFZttAAGHgi/Nw0CZ2o6JqWSbMlI219lAFLZZCyqByTsvVAJq5XA5H8cA6PrvBRpBWEuQ==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "bin": {
+ "playwright-core": "cli.js"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/playwright/node_modules/fsevents": {
+ "version": "2.3.2",
+ "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz",
+ "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+ }
+ },
"node_modules/pngjs": {
"version": "5.0.0",
"resolved": "https://registry.npmjs.org/pngjs/-/pngjs-5.0.0.tgz",
diff --git a/apps/browser-extension/package.json b/apps/browser-extension/package.json
index 2bf59a635..51a3f4af0 100644
--- a/apps/browser-extension/package.json
+++ b/apps/browser-extension/package.json
@@ -15,6 +15,8 @@
"build:safari": "wxt build -b safari",
"test": "vitest",
"test:coverage": "vitest run --coverage",
+ "test:e2e": "playwright test",
+ "test:e2e:headed": "playwright test --headed",
"lint": "eslint src",
"lint:custom": "eslint",
"lint:fix": "eslint src --fix",
@@ -45,6 +47,7 @@
"yup": "^1.6.1"
},
"devDependencies": {
+ "@playwright/test": "^1.57.0",
"@types/chrome": "^0.0.280",
"@types/jsdom": "^21.1.7",
"@types/node": "^22.13.10",
diff --git a/apps/browser-extension/playwright.config.ts b/apps/browser-extension/playwright.config.ts
new file mode 100644
index 000000000..23d81905e
--- /dev/null
+++ b/apps/browser-extension/playwright.config.ts
@@ -0,0 +1,35 @@
+import { defineConfig, devices } from '@playwright/test';
+import path from 'path';
+
+/**
+ * Playwright configuration for browser extension E2E tests.
+ *
+ * These tests load the real extension and interact with it using Playwright.
+ * The extension must be built first using `npm run build:chrome`.
+ */
+export default defineConfig({
+ testDir: './tests',
+ fullyParallel: true,
+ forbidOnly: !!process.env.CI,
+ retries: process.env.CI ? 2 : 0,
+ workers: process.env.CI ? 1 : undefined,
+ reporter: 'html',
+ timeout: 30000,
+
+ use: {
+ trace: 'on-first-retry',
+ },
+
+ projects: [
+ {
+ name: 'chromium',
+ use: {
+ ...devices['Desktop Chrome'],
+ // Load extension in persistent context
+ contextOptions: {
+ // Extension path will be set in test fixtures
+ },
+ },
+ },
+ ],
+});
diff --git a/apps/browser-extension/src/utils/VaultMergeService.ts b/apps/browser-extension/src/utils/VaultMergeService.ts
index 23cbe123a..2e3ba9e21 100644
--- a/apps/browser-extension/src/utils/VaultMergeService.ts
+++ b/apps/browser-extension/src/utils/VaultMergeService.ts
@@ -1,4 +1,4 @@
-import initSqlJs, { Database } from 'sql.js';
+import initSqlJs, { Database, SqlJsStatic } from 'sql.js';
/**
* Entity record from a SyncableEntity table.
@@ -71,6 +71,16 @@ const SYNCABLE_TABLES: ITableConfig[] = [
* which version of a record wins in case of conflict.
*/
export class VaultMergeService {
+ private sqlJsInstance: SqlJsStatic | null = null;
+
+ /**
+ * Set a pre-initialized SQL.js instance (useful for testing).
+ * @param sql - The SQL.js static instance
+ */
+ public setSqlJs(sql: SqlJsStatic): void {
+ this.sqlJsInstance = sql;
+ }
+
/**
* Merge local vault changes with server vault using LWW strategy.
*
@@ -88,8 +98,8 @@ export class VaultMergeService {
};
try {
- // Initialize SQL.js
- const SQL = await initSqlJs({
+ // Use injected SQL.js instance or initialize a new one
+ const SQL = this.sqlJsInstance ?? await initSqlJs({
/**
* Locate the SQL.js WASM file.
* @param file - The file name to locate
diff --git a/apps/browser-extension/src/utils/__tests__/VaultMergeService.test.ts b/apps/browser-extension/src/utils/__tests__/VaultMergeService.test.ts
new file mode 100644
index 000000000..dc1077f16
--- /dev/null
+++ b/apps/browser-extension/src/utils/__tests__/VaultMergeService.test.ts
@@ -0,0 +1,385 @@
+import { describe, it, expect, beforeAll, beforeEach } from 'vitest';
+import initSqlJs, { SqlJsStatic } from 'sql.js';
+import { VaultMergeService } from '../VaultMergeService';
+
+/**
+ * Test suite for VaultMergeService - tests LWW (Last-Write-Wins) merge logic
+ * with real SQLite databases.
+ */
+
+let SQL: SqlJsStatic;
+
+/**
+ * Helper to create a test vault database with the Items table schema.
+ * This mimics the actual vault structure used in AliasVault.
+ */
+function createTestVault(items: Array<{
+ Id: string;
+ ServiceName: string;
+ CreatedAt: string;
+ UpdatedAt: string;
+ IsDeleted?: number;
+ DeletedAt?: string | null;
+}>): string {
+ const db = new SQL.Database();
+
+ // Create Items table matching actual schema
+ db.run(`
+ CREATE TABLE Items (
+ Id TEXT PRIMARY KEY,
+ ServiceName TEXT,
+ CreatedAt TEXT NOT NULL,
+ UpdatedAt TEXT NOT NULL,
+ IsDeleted INTEGER DEFAULT 0,
+ DeletedAt TEXT
+ )
+ `);
+
+ // Insert test records
+ for (const item of items) {
+ db.run(
+ `INSERT INTO Items (Id, ServiceName, CreatedAt, UpdatedAt, IsDeleted, DeletedAt)
+ VALUES (?, ?, ?, ?, ?, ?)`,
+ [
+ item.Id,
+ item.ServiceName,
+ item.CreatedAt,
+ item.UpdatedAt,
+ item.IsDeleted ?? 0,
+ item.DeletedAt ?? null,
+ ]
+ );
+ }
+
+ // Export to base64
+ const bytes = db.export();
+ db.close();
+
+ let binaryString = '';
+ for (let i = 0; i < bytes.length; i++) {
+ binaryString += String.fromCharCode(bytes[i]);
+ }
+ return btoa(binaryString);
+}
+
+/**
+ * Helper to read items from a base64 vault.
+ */
+function readItemsFromVault(vaultBase64: string): Array<{
+ Id: string;
+ ServiceName: string;
+ UpdatedAt: string;
+ IsDeleted: number;
+}> {
+ const binaryString = atob(vaultBase64);
+ const bytes = new Uint8Array(binaryString.length);
+ for (let i = 0; i < binaryString.length; i++) {
+ bytes[i] = binaryString.charCodeAt(i);
+ }
+
+ const db = new SQL.Database(bytes);
+ const stmt = db.prepare('SELECT Id, ServiceName, UpdatedAt, IsDeleted FROM Items');
+ const items: Array<{ Id: string; ServiceName: string; UpdatedAt: string; IsDeleted: number }> = [];
+
+ while (stmt.step()) {
+ const row = stmt.getAsObject() as { Id: string; ServiceName: string; UpdatedAt: string; IsDeleted: number };
+ items.push(row);
+ }
+ stmt.free();
+ db.close();
+
+ return items;
+}
+
+describe('VaultMergeService', () => {
+ let mergeService: VaultMergeService;
+
+ beforeAll(async () => {
+ // Initialize SQL.js once for all tests - use node_modules path for tests
+ SQL = await initSqlJs({
+ locateFile: (file: string) => `node_modules/sql.js/dist/${file}`,
+ });
+ });
+
+ beforeEach(() => {
+ mergeService = new VaultMergeService();
+ // Inject the SQL.js instance so tests don't need 'src/' path
+ mergeService.setSqlJs(SQL);
+ });
+
+ describe('LWW merge scenarios', () => {
+ it('should keep locally created records not present on server', async () => {
+ // Scenario: User created a new credential offline, server has nothing
+ const localVault = await createTestVault([
+ {
+ Id: 'local-only-1',
+ ServiceName: 'My Offline Credential',
+ CreatedAt: '2024-12-08T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z',
+ },
+ ]);
+
+ const serverVault = await createTestVault([]);
+
+ const result = await mergeService.merge(localVault, serverVault);
+
+ expect(result.success).toBe(true);
+ expect(result.stats.recordsCreatedLocally).toBe(1);
+
+ // Verify the local record exists in merged vault
+ const mergedItems = readItemsFromVault(result.mergedVaultBase64);
+ expect(mergedItems).toHaveLength(1);
+ expect(mergedItems[0].Id).toBe('local-only-1');
+ expect(mergedItems[0].ServiceName).toBe('My Offline Credential');
+ });
+
+ it('should use server record when server UpdatedAt is newer (conflict resolution)', async () => {
+ // Scenario: Same credential edited on both devices, server edit is newer
+ const localVault = await createTestVault([
+ {
+ Id: 'shared-item-1',
+ ServiceName: 'Local Edit',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z', // Earlier update
+ },
+ ]);
+
+ const serverVault = await createTestVault([
+ {
+ Id: 'shared-item-1',
+ ServiceName: 'Server Edit',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T11:00:00Z', // Later update - server wins
+ },
+ ]);
+
+ const result = await mergeService.merge(localVault, serverVault);
+
+ expect(result.success).toBe(true);
+ expect(result.stats.conflicts).toBe(1);
+ expect(result.stats.recordsFromServer).toBe(1);
+
+ // Verify server version won
+ const mergedItems = readItemsFromVault(result.mergedVaultBase64);
+ expect(mergedItems).toHaveLength(1);
+ expect(mergedItems[0].ServiceName).toBe('Server Edit');
+ });
+
+ it('should keep local record when local UpdatedAt is newer', async () => {
+ // Scenario: Same credential edited on both devices, local edit is newer
+ const localVault = await createTestVault([
+ {
+ Id: 'shared-item-1',
+ ServiceName: 'Local Edit (Newer)',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T12:00:00Z', // Later update - local wins
+ },
+ ]);
+
+ const serverVault = await createTestVault([
+ {
+ Id: 'shared-item-1',
+ ServiceName: 'Server Edit (Older)',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z', // Earlier update
+ },
+ ]);
+
+ const result = await mergeService.merge(localVault, serverVault);
+
+ expect(result.success).toBe(true);
+ expect(result.stats.recordsFromLocal).toBe(1);
+
+ // Verify local version won
+ const mergedItems = readItemsFromVault(result.mergedVaultBase64);
+ expect(mergedItems).toHaveLength(1);
+ expect(mergedItems[0].ServiceName).toBe('Local Edit (Newer)');
+ });
+
+ it('should add server-only records to merged vault', async () => {
+ // Scenario: Another device created a credential, local doesn't have it
+ const localVault = await createTestVault([
+ {
+ Id: 'local-item-1',
+ ServiceName: 'Existing Local',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-01T10:00:00Z',
+ },
+ ]);
+
+ const serverVault = await createTestVault([
+ {
+ Id: 'local-item-1',
+ ServiceName: 'Existing Local',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-01T10:00:00Z',
+ },
+ {
+ Id: 'server-only-1',
+ ServiceName: 'Created on Other Device',
+ CreatedAt: '2024-12-08T09:00:00Z',
+ UpdatedAt: '2024-12-08T09:00:00Z',
+ },
+ ]);
+
+ const result = await mergeService.merge(localVault, serverVault);
+
+ expect(result.success).toBe(true);
+
+ // Verify both records exist in merged vault
+ const mergedItems = readItemsFromVault(result.mergedVaultBase64);
+ expect(mergedItems).toHaveLength(2);
+
+ const serverOnlyItem = mergedItems.find((i) => i.Id === 'server-only-1');
+ expect(serverOnlyItem).toBeDefined();
+ expect(serverOnlyItem?.ServiceName).toBe('Created on Other Device');
+ });
+
+ it('should handle complex merge with local adds, server adds, and conflicts', async () => {
+ // Scenario: Realistic merge with multiple types of changes
+ const localVault = await createTestVault([
+ {
+ Id: 'item-unchanged',
+ ServiceName: 'Unchanged Item',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-01T10:00:00Z',
+ },
+ {
+ Id: 'item-local-wins',
+ ServiceName: 'Local Wins',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T15:00:00Z', // Local is newer
+ },
+ {
+ Id: 'item-server-wins',
+ ServiceName: 'Server Will Win',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z', // Server is newer
+ },
+ {
+ Id: 'item-local-only',
+ ServiceName: 'Created Offline',
+ CreatedAt: '2024-12-08T14:00:00Z',
+ UpdatedAt: '2024-12-08T14:00:00Z',
+ },
+ ]);
+
+ const serverVault = await createTestVault([
+ {
+ Id: 'item-unchanged',
+ ServiceName: 'Unchanged Item',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-01T10:00:00Z',
+ },
+ {
+ Id: 'item-local-wins',
+ ServiceName: 'Server Version (Older)',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T12:00:00Z', // Older than local
+ },
+ {
+ Id: 'item-server-wins',
+ ServiceName: 'Server Wins',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T16:00:00Z', // Newer than local
+ },
+ {
+ Id: 'item-server-only',
+ ServiceName: 'From Other Device',
+ CreatedAt: '2024-12-08T13:00:00Z',
+ UpdatedAt: '2024-12-08T13:00:00Z',
+ },
+ ]);
+
+ const result = await mergeService.merge(localVault, serverVault);
+
+ expect(result.success).toBe(true);
+ expect(result.stats.tablesProcessed).toBeGreaterThanOrEqual(1);
+
+ const mergedItems = readItemsFromVault(result.mergedVaultBase64);
+ expect(mergedItems).toHaveLength(5); // All unique items
+
+ // Verify each scenario
+ const unchanged = mergedItems.find((i) => i.Id === 'item-unchanged');
+ expect(unchanged?.ServiceName).toBe('Unchanged Item');
+
+ const localWins = mergedItems.find((i) => i.Id === 'item-local-wins');
+ expect(localWins?.ServiceName).toBe('Local Wins');
+
+ const serverWins = mergedItems.find((i) => i.Id === 'item-server-wins');
+ expect(serverWins?.ServiceName).toBe('Server Wins');
+
+ const localOnly = mergedItems.find((i) => i.Id === 'item-local-only');
+ expect(localOnly?.ServiceName).toBe('Created Offline');
+
+ const serverOnly = mergedItems.find((i) => i.Id === 'item-server-only');
+ expect(serverOnly?.ServiceName).toBe('From Other Device');
+ });
+ });
+
+ describe('resolveItemDeletionConflict', () => {
+ it('should keep delete when both are deleted', () => {
+ const local = {
+ Id: 'item-1',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z',
+ IsDeleted: 1,
+ DeletedAt: null,
+ };
+ const server = {
+ Id: 'item-1',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T11:00:00Z',
+ IsDeleted: 1,
+ DeletedAt: null,
+ };
+
+ const result = mergeService.resolveItemDeletionConflict(local, server);
+
+ expect(result.IsDeleted).toBe(1);
+ });
+
+ it('should keep local delete when local is newer', () => {
+ const local = {
+ Id: 'item-1',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T12:00:00Z', // Newer
+ IsDeleted: 1,
+ DeletedAt: null,
+ };
+ const server = {
+ Id: 'item-1',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z', // Older
+ IsDeleted: 0,
+ DeletedAt: null,
+ };
+
+ const result = mergeService.resolveItemDeletionConflict(local, server);
+
+ expect(result.IsDeleted).toBe(1);
+ });
+
+ it('should restore when server restore is newer than local delete', () => {
+ const local = {
+ Id: 'item-1',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T10:00:00Z', // Older
+ IsDeleted: 1,
+ DeletedAt: null,
+ };
+ const server = {
+ Id: 'item-1',
+ CreatedAt: '2024-12-01T10:00:00Z',
+ UpdatedAt: '2024-12-08T12:00:00Z', // Newer - restored
+ IsDeleted: 0,
+ DeletedAt: null,
+ };
+
+ const result = mergeService.resolveItemDeletionConflict(local, server);
+
+ // Server wins because it's newer and not deleted
+ expect(result.IsDeleted).toBe(0);
+ });
+ });
+});
diff --git a/apps/browser-extension/tests/extension.spec.ts b/apps/browser-extension/tests/extension.spec.ts
new file mode 100644
index 000000000..0fd629933
--- /dev/null
+++ b/apps/browser-extension/tests/extension.spec.ts
@@ -0,0 +1,62 @@
+import { test, expect, openPopup } from './fixtures';
+
+/**
+ * Basic browser extension E2E tests.
+ *
+ * These tests verify the extension loads correctly and basic UI interactions work.
+ * Run with: npm run test:e2e
+ *
+ * Prerequisites:
+ * 1. Build the extension: npm run build:chrome
+ * 2. Have an AliasVault API server running (or mock one)
+ */
+
+test.describe('Extension Popup', () => {
+ test('should load the popup and show login form', async ({ context, extensionId }) => {
+ const popup = await openPopup(context, extensionId);
+
+ // Wait for the popup to load
+ await popup.waitForLoadState('domcontentloaded');
+
+ // The popup should show something - either login form or vault content
+ // Check for common elements that indicate the popup loaded successfully
+ const body = popup.locator('body');
+ await expect(body).toBeVisible();
+
+ // Check that React rendered (the app container should exist)
+ const appContent = popup.locator('#root');
+ await expect(appContent).toBeVisible();
+
+ // Take a screenshot for debugging
+ await popup.screenshot({ path: 'tests/screenshots/popup-loaded.png' });
+ });
+
+ test('should have working navigation elements', async ({ context, extensionId }) => {
+ const popup = await openPopup(context, extensionId);
+ await popup.waitForLoadState('domcontentloaded');
+
+ // Wait for React to render
+ await popup.waitForSelector('#root', { state: 'visible' });
+
+ // Give React a moment to render content
+ await popup.waitForTimeout(500);
+
+ // The popup should contain some text (not be empty)
+ const rootContent = await popup.locator('#root').textContent();
+ expect(rootContent).toBeTruthy();
+ expect(rootContent!.length).toBeGreaterThan(0);
+ });
+});
+
+test.describe('Extension Service Worker', () => {
+ test('should have a running service worker', async ({ context, extensionId }) => {
+ // Service worker should be running
+ const serviceWorkers = context.serviceWorkers();
+ expect(serviceWorkers.length).toBeGreaterThan(0);
+
+ // The service worker URL should match our extension
+ const swUrl = serviceWorkers[0].url();
+ expect(swUrl).toContain(extensionId);
+ expect(swUrl).toContain('background');
+ });
+});
diff --git a/apps/browser-extension/tests/fixtures.ts b/apps/browser-extension/tests/fixtures.ts
new file mode 100644
index 000000000..f4fdc77a6
--- /dev/null
+++ b/apps/browser-extension/tests/fixtures.ts
@@ -0,0 +1,59 @@
+import { test as base, chromium, type BrowserContext } from '@playwright/test';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Path to the built Chrome extension.
+ * Run `npm run build:chrome` before running E2E tests.
+ */
+const EXTENSION_PATH = path.join(__dirname, '..', 'dist', 'chrome-mv3');
+
+/**
+ * Extended test fixture that provides a browser context with the extension loaded.
+ */
+export const test = base.extend<{
+ context: BrowserContext;
+ extensionId: string;
+}>({
+ // eslint-disable-next-line no-empty-pattern
+ context: async ({}, use) => {
+ const context = await chromium.launchPersistentContext('', {
+ headless: false, // Extensions require headed mode
+ args: [
+ `--disable-extensions-except=${EXTENSION_PATH}`,
+ `--load-extension=${EXTENSION_PATH}`,
+ '--no-first-run',
+ '--disable-gpu',
+ ],
+ });
+
+ await use(context);
+ await context.close();
+ },
+
+ extensionId: async ({ context }, use) => {
+ // Wait for service worker to be ready
+ let [background] = context.serviceWorkers();
+ if (!background) {
+ background = await context.waitForEvent('serviceworker');
+ }
+
+ // Extract extension ID from the service worker URL
+ const extensionId = background.url().split('/')[2];
+ await use(extensionId);
+ },
+});
+
+export const expect = test.expect;
+
+/**
+ * Helper to open the extension popup.
+ */
+export async function openPopup(context: BrowserContext, extensionId: string) {
+ const popupPage = await context.newPage();
+ await popupPage.goto(`chrome-extension://${extensionId}/popup.html`);
+ return popupPage;
+}
diff --git a/apps/browser-extension/vitest.config.ts b/apps/browser-extension/vitest.config.ts
index 92be6978a..bf2516df4 100644
--- a/apps/browser-extension/vitest.config.ts
+++ b/apps/browser-extension/vitest.config.ts
@@ -5,4 +5,7 @@ export default defineConfig({
plugins: [
WxtVitest(),
],
+ test: {
+ exclude: ['**/node_modules/**', '**/tests/**'],
+ },
});