wv3-auto

A CommonJS Node.js package for installing WV3 browser components, launching Playwright browsers, and working with the WV3AutoClient.

Install

npm install wv3-auto

For local development:

npm install

Features

• CLI support for install, uninstall, and initialize
• Playwright browser launcher
• Base client class
• WV3AutoClient wrapper
• CommonJS package structure

Files

wv3-auto/
  index.js
  browser.js
  installer.js
  client.js
  wv3-auto-client.js
  package.json

CLI Usage

wv3-auto --help
wv3-auto --version
wv3-auto --install --browser chromium
wv3-auto --uninstall
wv3-auto --initialize --browser firefox

CLI Options

• -h, --help display help information
• -v, --version display version information
• -i, --install install WV3 components
• -u, --uninstall uninstall WV3 components
• -l, --initialize initialize browser instance

Examples

wv3-auto -i --browser chromium
wv3-auto -i --browser firefox
wv3-auto -u
wv3-auto -l --browser chrome --headless
wv3-auto -l --browser firefox --url https://example.com

Browser Launcher

The browser launcher lives in browser.js.

Example:

const { launchPlaywrightBrowser } = require('./browser');

async function main() {
  const session = await launchPlaywrightBrowser({
    browser: 'chromium',
    headless: true,
    url: 'https://example.com'
  });

  console.log(session.browserName);
  console.log(await session.page.title());

  await session.browser.close();
}

main().catch(console.error);

BaseClient

The base client provides reusable browser session handling.

Example:

const BaseClient = require('./client');

async function main() {
  const client = new BaseClient({
    browser: 'chromium',
    headless: true
  });

  client.on('ready', (data) => {
    console.log('Client ready:', data);
  });

  await client.initialize();
  await client.goto('https://example.com');

  console.log(await client.getPage().title());

  await client.close();
}

main().catch(console.error);

WV3AutoClient

WV3AutoClient extends the base client and adds install, uninstall, launch, and page helpers.

Example:

const WV3AutoClient = require('./wv3-auto-client');

async function main() {
  const client = new WV3AutoClient({
    browser: 'chromium',
    headless: true
  });

  client.on('install:start', (data) => {
    console.log('Installing:', data);
  });

  client.on('ready', (data) => {
    console.log('Ready:', data);
  });

  await client.install({ browser: 'chromium' });
  await client.launch({ url: 'https://example.com' });

  console.log('Title:', await client.title());
  console.log('URL:', await client.url());

  await client.close();
}

main().catch(console.error);

Exports

Example package export:

const BaseClient = require('./client');
const WV3AutoClient = require('./wv3-auto-client');

module.exports = {
  BaseClient,
  WV3AutoClient
};

Notes

• Uses CommonJS
• Requires Node.js 18+
• Requires Playwright for browser automation
• WV3 component install and uninstall are handled in installer.js

License

MIT