Home

Awesome

<h1 align="center">Rize</h1> <p align="center"> <a href="https://circleci.com/gh/g-plane/rize/"><img src="https://flat.badgen.net/circleci/github/g-plane/rize" alt="Circle CI Build Status"></a> <a href="https://codecov.io/gh/g-plane/rize"><img src="https://flat.badgen.net/codecov/c/github/g-plane/rize" alt="Coverage"></a> <a href="https://github.com/g-plane/rize/blob/master/LICENSE"><img src="https://flat.badgen.net/github/license/g-plane/rize" alt="License"></a> <a href="https://www.npmjs.com/package/rize"><img src="https://flat.badgen.net/npm/v/rize" alt="NPM Version"></a> <a href="https://www.npmjs.com/package/rize"><img src="https://flat.badgen.net/npm/dm/rize" alt="NPM Downloads"></a> </p>

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?.

Translations

简体中文

We need your help to translate the docs!

Installation

You should install puppeteer at the same time.

yarn add --dev puppeteer rize

or via npm:

npm install --save-dev puppeteer rize

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

On Linux or macOS:

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

On Windows:

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:

import Rize from 'rize'

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

const Rize = require('rize')

Getting Started

Just like this:

const rize = new Rize()

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

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

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

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.

Documentation

Please visit rize.js.org

Contribution

Before you contribute to Rize, please read Contributing Guide.

License

MIT License

Copyright (c) 2018-present Pig Fang