airtap-system

Browser provider for locally installed browsers. List and run browsers on your machine. Supports Chrome, Chromium, Firefox, IE, Edge, Brave, Opera and Safari, on Linux, Mac & Windows, with cross-platform headless mode on Chromium, Chrome, Edge, Brave and Firefox.


Table of Contents

Usage

$3

``js
const System = require('airtap-system')
const system = new System()

// Get a list of desired browsers
const wanted = [{ name: 'firefox', version: 79 }]
const manifests = await system.manifests(wanted)

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

await browser.open()
`

If you just want to open a single browser:

`js
const browser = await system.open('chrome', 'https://example.com', {
headless: false
})
`

Or find a single browser:

`js
const manifest = await system.find({
name: 'chrome',
channel: 'canary',
supports: { headless: true }
})
`

$3

`yaml
providers:
- airtap-system

browsers:
- name: firefox
version: 79
- name: chrome
`

This provider also exposes a supports property to match on:

`yaml
browsers:
- name: chrome
supports:
headless: true
`

As well as a release channel and (Windows-only) arch:

`yaml
browsers:
- name: chrome
channel: beta
- name: firefox
channel: nightly
- name: ie
arch: i386
`

API

$3

Constructor. Returns an instance of browser-provider.

$3

- headless (boolean, default true if supported): run in headless mode.

In Airtap these can be set like so:

`yaml
browsers:
- name: chrome
options:
headless: false
`

Install

With npm do:

`
npm install airtap-system
``

License

MIT © 2020-present Airtap contributors