Page-check NPM

Page Check

Webpage tester based on Puppeteer and Node.js

Module runs your webpage, app or banner within virtual browser. While running, it registers next few things:

javascript errors (including errors inside onresize handler)
missing files
console events (log, warn, etc.)
requests to a different hosts

Installation

npm install page-check

API

PageCheck(input, options)

input

Type: String | Array

options.timeout

Type: Number
Default: 60
Keep checking for this amout of seconds

options.clones

Type: Boolean
Default: false
If set to false, the same errors will be removed from the list

options.filter

Type: Function
This function will be used by Array.filter() to filter final list of errors.
For example we could leave only js errors and external request:

Here is the codes for quick filtering:

Code	Event
1	page error
2	failed request
3	external request
4	iframe attached
6	console.log
7	console.error
8	console.warn, console.info ...
9	dialog, alert ...
10	not existing page or any else errors

options.args

Type: Array
Array of arguments that would be passed into puppeteer.launch(args)

options.spoof_list

Type: Array
List of requests that should be replaced. For example, you don't want to wait until some heavy library is downloaded from remote server:

PageCheck(page_url, {
   args: [ '--disable-web-security' ],
   spoof_list: [
      { 
         rule: 'https://cdnjs.cloudflare.com/ajax/libs/pixi.js/4.8.2/pixi.js', 
         body: fs.readFileSync('./libs/pixi.js'), 
         status: 200, 
         contentType: 'text/plain'
      }, 
   ]
})

Note: set args: [ '--disable-web-security' ] if you have the CORS error

options.screenshot

Type: Boolean
Default: false

options.screenshot.delay

Type: Number
Default: 3
Wait for this number of seconds before taking a screenshot

options.viewport

Type: Object
Default: { width: 1000, height: 600 }

options.headless

Type: Boolean
Default: true

options.devtools

Type: Boolean
Default: false

Usage

const PageCheck = require('page-check');

let results = await PageCheck('http://localhost/page', {
   timeout: 15, 
   filter: err => /[1234]/.test(err.code), 
   screenshot: {
      delay: 5,
      path: `./screenshots/${Date.now()}.png`
   }
});

console.log(results);

Output

{
  "screenshot": <Buffer>,
  "errors": [
    {
      "code": 3,
      "type": "external request",
      "details": "http://domain.com/favicon.ico"
    },
    {
      "code": 6,
      "type": "console.log",
      "details": "Boop!"
    },
    {
      "code": 7,
      "type": "console.error",
      "details": "Failed to load resource: the server responded with a status of 404 (Not Found)"
    }
  ]
}