perfbudget is a stand-alone version of Tim Kadlec's (@tkadlec) grunt-perfbudget plugin. It is a node package for enforcing a performance budget. It uses webpagetest.org and the WebPagetest API Wrapper for NodeJS created by Marcel Duran.

perfbudget uses either a public or private instance of WebPagetest to perform tests on a specified URL. It compares test results to budgets you specify. If the budget is met, the tasks successfully completes. If the page exceeds your performance budgets, the task fails and informs you why.

# CLI
$ npm install -g perfbudget

# Node Module
$ npm install perfbudget

# using www.webpagetest.org
$ perfbudget --url http://www.bbc.co.uk --key [api_key]

# using private instance
$ perfbudget --url http://www.bbc.co.uk --instance [instance_url] --key [api_key] --location [location]

# setting budgets
$ perfbudget --url http://www.bbc.co.uk --key [api_key] --SpeedIndex 2000 --render 400

Flags

Config:

• --url - URL you want WPT to run against | default : ""
• --key - API key for WPT instance | default : ""
• --instance - WPT instance to use | default : www.webpagetest.org
• --location - WPT location to use | default : Dulles:Chrome

Budget:

• --visualComplete | default : ""
• --render | default : "1000"
• --loadTime | default : ""
• --docTime | default : ""
• --fullyLoaded | default : ""
• --bytesIn | default : ""
• --bytesInDoc | default : ""
• --requests | default : ""
• --requestsDoc | default : ""
• --SpeedIndex | default : "1000"

var perfbudget = require('perfbudget');

perfbudget.runTest(options, function(err, result) {
  if (err) {
    return console.log(err);
  }

  if (!result.pass) {
    console.log(
      '\n-----------------------------------------------' +
      '\nTest for ' + result.options.url + ' \t ' + colors.red('[FAILED]') +
      '\n-----------------------------------------------\n'
    );
    console.log(result.msg);
    console.log('Summary: ' + result.summary);
  } else {
    console.log(
      '\n-----------------------------------------------' +
      '\nTest for ' + result.options.url + ' \t ' + colors.green('[PASSED]') +
      '\n-----------------------------------------------\n'
    );
    console.log(result.msg);
    console.log('Summary: ' + result.summary);
  }
});

• Remove the need for a --url flag. Instead just assume that whatever follows perfbudget is the URL.

This is still a work in progress and things are likely to change with each release. As it stands this package works directly in CLI. I'll be working to make it easier to integrate with a Node project.