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: about 2 months 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 (almost 6 years ago)
• Last Synced: 2024-10-01T08:40:01.022Z (3 months 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/