abstract-browser

Interface for opening and closing a browser. Uses nanoresource for state management, browser-manifest for metadata. Pairs well with browser-provider.

Usage

With promises:

const Browser = require('abstract-browser').promises

class MyBrowser extends Browser {
  async _open () {
    // open the browser
    console.log('opening', this.target.url)
  }

  async _close () {
    // close the browser
  }
}

With callbacks:

const Browser = require('abstract-browser')

class MyBrowser extends Browser {
  _open (callback) {
    // ..
  }

  _close (callback) {
    // ..
  }
}

API

`browser = new Browser(manifest, target)`

Constructor. Takes a browser-manifest and a target object in the form of { url }.

Implementors are free to change the signature of their constructor. User-facing options specific to an implementation should be passed in via manifest.options.

`browser.open([callback])`

Open the browser. Returns a promise if no callback is provided.

`browser.close([callback])`

Close the browser. Returns a promise if no callback is provided.

`browser.status(ok[, callback])`

Set status by a boolean ok. Returns a promise if no callback is provided. Useful for remote browsers like Sauce Labs where you can set the remote job status e.g. after running tests on a browser.

`browser.manifest`

The manifest that was passed to the constructor.

`browser.target`

The target that was passed to the constructor.

Events

Browsers may emit error events. It's recommended to only do so after open() has completed and not after close() has been called. The transient-error module may be used to signal that the error is temporary and that running (a new instance of) the browser can be retried.

Install

With npm do:

npm install abstract-browser

License

MIT © 2020-present Airtap contributors

License

airtap/abstract-browser

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages