Browser service

This package provides the BrowserService class for initializing and managing a Playwright browser context, network configurations, and wallets (EOA or WalletConnect). It facilitates automated testing of interactions with Web3 wallets (e.g., Metamask) and offers convenient methods for network switching, connecting to a fork node, etc.

Installation

npm install browser-service
# or
yarn add browser-service

Quick Start

import { test, expect } from '@playwright/test';
import { BrowserService } from 'browser-service';

test.describe('Example usage of BrowserService', () => {
  let browserService: BrowserService;

  test.beforeAll(async () => {
    browserService = new BrowserService({
      networkConfig: {
        chainName: 'Holesky',
        chainId: 17000,
        rpcUrl: 'https://holesky.infura.io/v3/<YOUR_INFURA_KEY>',
      },
      walletConfig: {
        COMMON: {
          WALLET_NAME: 'METAMASK',
          EXTENSION_WALLET_NAME: 'METAMASK',
          WALLET_TYPE: 'EOA', // or 'WC' for WalletConnect
          STORE_EXTENSION_ID: 'metamask', 
          LATEST_STABLE_DOWNLOAD_LINK: 'https://example.com/metamask.crx',
        },
        SECRET_PHRASE: 'test test test test test test test test test test test junk',
        NETWORK_NAME: 'Holesky',
      },
      nodeConfig: {
        rpcUrlToMock: '**/api/rpc?chainId=17000',
      },
      enableBrowserContext: true,
    });

    // Initialize the wallet (without fork)
    await browserService.initWalletSetup();
  });

  test('Example test', async () => {
    const browserContext = await browserService.getBrowserContext();
    const page = await browserService.getBrowserContextPage();

    // Perform browser actions, testing wallet interaction with an application
    await page.goto('https://example.org');
    expect(await page.title()).toBe('Example Domain');
  });

  test.afterAll(async () => {
    // Clean up after tests
    await browserService.teardown();
  });
});

Options

• networkConfig – describes the network (chainId, rpcUrl, chainName).
• walletConfig – wallet settings (wallet type, extension info, etc.).
• nodeConfig – configuration for mocking RPC requests (e.g., URL pattern).
• browserOptions – options for launching the browser (headless, executable paths, etc.).
• enableBrowserContext – enables or disables the use of a custom data dir for the browser context.

Methods

• initWalletSetup(useFork?: boolean) - Launches the main wallet initialization procedure by setting up the chosen network. If useFork = true, the wallet will work through a local fork node (started automatically).
• setupWithNode() - Explicitly starts the fork node, creates a test account, and configures the wallet to use the local network.
• setup(commonWalletConfig?: CommonWalletConfig) - Creates the extension service, sets up the browser context, downloads and initializes the wallet in Playwright.
• teardown() - Closes the browser context and stops the local node (if it was started).