Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/g-plane/rize

High-level, fluent and chainable API provided library for puppeteer.
https://github.com/g-plane/rize

chainable-interface chainable-methods chrome fluent-api googlechrome puppeteer rize

Last synced: 26 days ago
JSON representation

High-level, fluent and chainable API provided library for puppeteer.

Awesome Lists containing this project

README

        

Rize


Circle CI Build Status
Coverage
License
NPM Version
NPM Downloads

Rize is a high-level, fluent and chainable API provided library which let you use puppeteer simply.

"Rize" is pronounced like /ɾize/, not /raɪzɪ/. "Rize" is one of characters in [*Is the Order a Rabbit?*](https://en.wikipedia.org/wiki/Is_the_Order_a_Rabbit%3F).

### Translations

[简体中文](https://rize.js.org/zh-CN/)

We need your help to translate the docs!

## Installation

You should install `puppeteer` at the same time.

```bash
yarn add --dev puppeteer rize
```

or via npm:

```bash
npm install --save-dev puppeteer rize
```

If you are in China, you may specify Chromium binary mirror.

On Linux or macOS:

```bash
PUPPETEER_DOWNLOAD_HOST=https://npm.taobao.org/mirrors yarn add --dev puppeteer rize
```

On Windows:

```shell
SET PUPPETEER_DOWNLOAD_HOST=https://npm.taobao.org/mirrors yarn add --dev puppeteer rize
```

## Basic Usage

### Import

It's recommended to use ES-style import:

```javascript
import Rize from 'rize'
```

Or using CommonJS-style import, if you don't use any build tools:

```javascript
const Rize = require('rize')
```

### Getting Started

Just like this:

```javascript
const rize = new Rize()
```

You can pass some options to the constructor,
and these options are `puppeteer`'s options:

```javascript
const rize = new Rize({ headless: false })
```

All `Rize`'s APIs are chainable, so you can do something like this:

```javascript
const rize = new Rize()
rize
.goto('https://github.com/')
.type('input.header-search-input', 'node')
.press('Enter')
.waitForNavigation()
.assertSee('Node.js')
.end() // Don't forget to call `end` function to exit browser!
```

All available APIs are listed [here](https://rize.js.org/api/classes/_index_.rize.html).

## Documentation

Please visit [rize.js.org](https://rize.js.org)

## Contribution

Before you contribute to Rize, please read [Contributing Guide](./.github/CONTRIBUTING.md).

## License

MIT License

Copyright (c) 2018-present Pig Fang