Pupest NPM | npm.io

Pupest

The easiest end-to-end test automation using Puppeteer

Installation

yarn add pupest

npm install pupest

Usage

Pupest CLI automatically detects all files *.pupest.js

// login.pupest.js

import pupest from 'pupest';

pupest()
  .go('https://github.com/login')
  .type('user123', '#login_field')
  .type('pass456', '#password')
  .test('Login into GitHub')

CLI

Run for all *.pupest.js files

pupest --visible --verbose

Run for custom glob

pupest **/auth --visible --verbose

Commands

Command	Params	Description
`click`	`selector: string`	Clicks the element matching the selector.
`contains`	`text: string`, `selector?: string`	Checks if the element matching the selector contains the specified text.
`file`	`selector: string`, `...paths: string[]`	Attaches one or more files to the element matching the selector.
`find`	`selector: string`	Returns the first element matching the selector.
`frame`	`selector?: string`	Switches to the frame matching the selector (or to the main frame if no selector is provided).
`go`	`url: string`	Navigates to the specified URL.
`puppeteer`	`handler({ browser: Browser, page: Page, scope: Frame })`	Executes a custom handler function that receives an object with instances of the browser, page, and current frame.
`press`	`key: KeyInput`	Presses the specified key.
`screenshot`	`path?: string`	Captures a screenshot of the current page and saves it to the specified path (or in the test file directory).
`scroll`	`selector: string`	Scrolls the page until the element matching the selector is visible.
`select`	`selector: string`, `...values: string[]`	Selects the specified options on the element matching the selector.
`type`	`text: string`	Types the specified text.
`wait`	`milliseconds: number`	Waits for the specified number of milliseconds before continuing.