psi

PageSpeed Insights With Reporting

Run mobile and desktop performance tests for your deployed site using Google PageSpeed Insights with tidy reporting for your build process. A sample Gulpfile demonstrating use is also available.

Uses gpagespeed and the reporter in grunt-pagespeed.

Install

$ npm install --save psi

Preview

Usage

Note: By default we recommend using the nokey option to test-drive PageSpeed Insights. This doesn't require any extra work on your part nor an API key.

For a production-level build process, registering for an API key is recommented from the Google Developer Console in order to use this module.

var psi = require('psi');

psi({
	// key: '...', optional
	nokey: 'true',
	url: 'http://html5rocks.com',
	paths: '',           // optional
	locale: 'en_GB',     // optional
	strategy: 'mobile',  // optional
	threshold: 80        // optional
});

Optionally, a callback is also available with access to the response:

psi(options, function(err, data){
	console.log(data.score);
	console.log(data.pageStats);
});

###Supported properties

####url Type: String

URL of the page for which the PageSpeed Insights API should generate results.

####locale Type: String

The locale that results should be generated in (e.g 'en_GB').

####strategy Type: String

The strategy to use when analyzing the page. Valid values are desktop and mobile.

####threshold Type: Number

Threshold score that is needed to pass the pagespeed test

####paths Type: Array

An array of URL paths that are appended to the URL

###Options

####key Type: String

Google API Key

####nokey Type: String

Specify to use the free tier on PageSpeed Insights. Good for getting a feel for how well it works for you.

####url Type: String

The URL of the page for which the PageSpeed Insights API should generate results.

CLI support

You will probably want to globally install psi if using as a CLI. This can be done as follows:

npm install -g psi

You can then casually use it with your key:

$ psi http://www.google.com --key 'YOUR_KEY_GOES_HERE'

Similar to gpagespeed, the following optional flags are also supported:

$ psi <url> --key=<key> --prettyprint=<true> --userIp=<userIp> --locale=<locale> --strategy=<desktop|mobile>

Most people will probably just want to run this using the free tier key. You can specify this with the --nokey flag:

$ psi http://www.html5rocks.com --nokey --strategy=mobile

Getting PSI into your build

A sample Gulp project using PSI is available.

If you use Grunt, grunt-pagespeed is a task by James Cryer that uses PSI under the hood.

License

Apache 2.0
Copyright 2014 Google Inc