airtap-electron

August 23, 2020 · View on GitHub

Click to expand

Usage
- Programmatic
- With Airtap
API
- Electron()
- Browser options
Install
License

Usage

Programmatic

const Electron = require('airtap-electron')
const provider = new Electron()

// Get a list of desired browsers (there's just 1 here)
const wanted = [{ name: 'electron' }]
const manifests = await provider.manifests(wanted)

// Instantiate a browser
const target = { url: 'http://localhost:3000' }
const browser = provider.browser(manifests[0], target)

await browser.open()

With Airtap

providers:
  - airtap-electron

browsers:
  - name: electron

This provider also exposes a supports property to match on:

browsers:
  - name: electron
    supports:
      headless: true

API

`Electron()`

Constructor. Returns an instance of browser-provider.

Browser options

headless (boolean, default true): run in headless mode
window (object): custom options to pass to BrowserWindow()
devtools (object): custom options to pass to openDevTools() (unless headless)

In Airtap these can be set like so:

browsers:
  - name: electron
    options:
      headless: false
      window:
        webPreferences:
          sandbox: true
      devtools:
        mode: detach

Install

Electron must be installed separately. With npm do:

npm install airtap-electron electron