grunt-report

0.0.4 • Public • Published

grunt-report Build Status

Grunt task that prints out a health report for a live URL, alerting you to any problems.

Intended for used at the end of an automated production deploy process, to verify that a page can be loaded without any of the following issues:

  • JavaScript errors
  • console messages
  • failed resource downloads

Usage

This is a multitask. Create named targets like this:

grunt.initConfig({
  report: {
    options: {
      // see below
    },
    wiki: {
      url: 'http://www.wikipedia.org/'
    }
  }
})

Output from running grunt report:wiki with the above config:

Terminal output

Notes:

  • If there are any JavaScript errors, you get a stack trace with line numbers.
  • Console messages get printed out in full
  • If there are failed downloads, you get the URLs and status codes
  • If any of the above problems are encountered, grunt will halt after this task (unless you use --force).

Options

You can use options to tell the grunt how much to care about each problem type:

  • consoleMessages (default: "warn")
  • javascriptErrors (default: "error")
  • resourceErrors (default: "error")

All three options accept any of the following values, which correspond to grunt error levels:

  • ok
  • warn
  • error

ok means (a) this type of problem won't cause grunt to halt, and (b) the terminal output will look green and soothing.

For example: if you don't mind console messages in production, you could set consoleMessages: "ok". You'll still see any console logs in your terminal, but they won't be seen as a problem.

Readme

Keywords

none

Package Sidebar

Install

npm i grunt-report

Weekly Downloads

1

Version

0.0.4

License

none

Last publish

Collaborators

  • callumlocke