Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/EasyWebApp/puppeteer-browser

Multiple Web browser controller based on Puppeteer API
https://github.com/EasyWebApp/puppeteer-browser

automation browser puppeteer testing web

Last synced: 11 days ago
JSON representation

Multiple Web browser controller based on Puppeteer API

Host: GitHub
URL: https://github.com/EasyWebApp/puppeteer-browser
Owner: EasyWebApp
License: apache-2.0
Archived: true
Created: 2018-06-06T08:32:56.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2019-03-09T14:39:19.000Z (over 5 years ago)
Last Synced: 2024-10-01T08:40:01.022Z (about 1 month ago)
Topics: automation, browser, puppeteer, testing, web
Language: JavaScript
Homepage: https://web-cell.dev/puppeteer-browser/
Size: 478 KB
Stars: 30
Watchers: 2
Forks: 4
Open Issues: 0
Metadata Files:
- Readme: ReadMe.md
- License: LICENSE

Awesome Lists containing this project

README

        # Puppeteer browser

Multiple **Web browser** controller based on [Puppeteer API][1], wraps [`puppeteer`][2], [`puppeteer-fx`][3] & [`puppeteer-ie`][4] in one package.

[![NPM Dependency](https://david-dm.org/EasyWebApp/puppeteer-browser.svg)](https://david-dm.org/EasyWebApp/puppeteer-browser)

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FEasyWebApp%2Fpuppeteer-browser.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2FEasyWebApp%2Fpuppeteer-browser?ref=badge_shield)

[![Build Status](https://travis-ci.com/EasyWebApp/puppeteer-browser.svg?branch=master)](https://travis-ci.com/EasyWebApp/puppeteer-browser)

[![NPM](https://nodei.co/npm/puppeteer-browser.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/puppeteer-browser/)

([Windows users please note](https://github.com/TechQuery/Puppeteer-IE#installation))

## Use as a Test runner

Create `your_script.js`

```JavaScript

import PuppeteerBrowser from 'puppeteer-browser';

(async () => {

    const page = await PuppeteerBrowser.getPage(

        'path/to/start/server', 'path/to/open/page'

    );

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

})();

```

then run one command below in your terminal

```Shell

# Chrome

node your_script

# Firefox

npm set PUPPETEER_BROWSER firefox  &&  node your_script

# Internet Explorer

npm set PUPPETEER_BROWSER IE  &&  node your_script

```

[ Notice ]  Option started with `--inspect` in the command-line will disable Headless mode.

## Use as a developing viewer

`directories.lib` field of `package.json` or `process.cwd()` will be watched.

[Example from WebCell DevCLI](https://github.com/EasyWebApp/DevCLI/blob/master/source/index.js#L60)

## API Document

 - Online: [URL](https://web-cell.tk/puppeteer-browser) or `npm docs`

 - Offline: `npm start`

## License

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FEasyWebApp%2Fpuppeteer-browser.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FEasyWebApp%2Fpuppeteer-browser?ref=badge_large)

 [1]: https://pptr.dev/#?product=Puppeteer&version=v1.5.0

 [2]: https://pptr.dev/

 [3]: https://github.com/autonome/puppeteer-fx

 [4]: https://tech-query.me/Puppeteer-IE/