Skip to content

This is the Open-source repository for the Boozang test runner based on Puppeteer

License

Notifications You must be signed in to change notification settings

ljunggren/bz-puppeteer

Repository files navigation

Boozang Puppeteer Test runner

Usage

USAGE: boozang [--token] [--headfull] [--verbose] [--screenshot] [--file=report] [--device=default] url

Introduction

This is a helper package for Boozang test platform and allows for test execution from the command line. The test runner is designed to run Boozang tests (http://boozang.com) both in headless and non-headless mode, and is based on the amazing npm package Puppeteer (https://github.com/GoogleChrome/puppeteer) by Chrome developers. Just like Puppeteer it can be configured to use both headless Chrome and "full" Chrome.

Requirements

Installing Node v8.9.0+ is recommended.

Installation

To install the command-line package run

npm install -g boozang

To run

boozang http://ai.boozang.com/extension/abc...

To clone the repository run

git clone https://github.com/ljunggren/bz-puppeteer

To run the application from source simply run

node index.js http://ai.boozang.com/extension/abc...

Commands

Headless run

boozang [testurl-including-auth-token]

"Full" mode

boozang --headfull [testurl-including-auth-token]

Run with Boozang authentification token

boozang --token=auth-token [testurl-excluding-auth-token]

Options

USAGE: boozang [--token] [--headfull] [--verbose] [--screenshot] [--file=report] [--device=default] url

  • token: The Boozang authorization token. The recommended way of generating a token is to create a team member with CI credentials on your project. In the management UI (ai.boozang.com) login as CI member and generate a token under Account->Get Token. You can now simply control CI access and consolidate all email notifications under the CI team member email address.

  • headfull: Runs Boozang in full mode (non-headless). Will be triggered authomatically for URL with extension dependencies

  • verbose: Turn on verbose logging

  • screenshot: Generates a screenshot instead of runs a test. Used to generate tool screenshots for Boozang documentation.

  • file: Overrides default report name "result".

  • device: Emulate device. Find devices here: https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts

Built With

  • Puppeteer - Headless Chrome Node API from Google Chrome

Authors

  • Mats Ljunggren - Initial work - ljunggren

  • Wensheng Li - Initial work - lwshome

License

This project is licensed under the MIT License - see the LICENSE.md file for details

About

This is the Open-source repository for the Boozang test runner based on Puppeteer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published