Phantomas

This release of phantomas brings:
- next set of reporter options (318) like `-R plain:no-color`, `-R tab:no-skip` and `-R statsd:localhost:8215:phantomas.`
- metric with number of static assets fetched from domains with cookie set (92)
- offenders are now added for `DOMqueriesByQuerySelectorAll`, `eventsBound` and `domainsWithCookies` metrics

phantomas CommonJS module now returns a promise (314) and passes events triggered from phantomas modules (322).

What's coming up with the next version? Support for running phantomas in SlimerJS (313). Stay tuned :)

Changelog

New metrics
- 92 - Add a metric with number of static assets fetched from domains with cookie set

Improvements
- 283 - File name prefix for filmstrip screenshots
- 318 - Implement next set of reporter options
- 329 - Offenders: add for DOMqueriesByQuerySelectorAll and eventsBound
- 331 - Cookies: add offenders for domainsWithCookies

Bug fixes
- 326 - incrMetric: passing incr = 0 increases the metrics by 1
- 335 - eventListener: events bound to window are not reported

Internals
- 314 - Use promise pattern in CommonJS module
- 320 - Internal API cleanup
- 322 - Pass custom events from phantomas to CommonJS module
- 330 - Use collection library
- 332 - Add debug mode for phantomas runner
- 334 - localStorage: cleanup

This release of phantomas brings:
- reporter options (264) like `-R json:pretty` or `-R csv:no-header:timestamp`
- ability to load external modules (292)
- ability to store HTML of the fully loaded page (291)

In multiple runs mode JSON reporter now emits metrics statistics (285).

phantomas now uses the latest version of [debug npm module](https://www.npmjs.org/package/debug) - messages emitted when `DEBUG=phantomas*` env variable is set are now sent to stdout (instead of stderr).

You can find more details below.

Changelog

Improvements
- 264 - Options for --reporter (suggested by AcousticRand)
- 285 - Provide metric statistics in JSON reporter like in Plain reporter
- 291 - Added pageSource module to save page source to file. (by gomezd)
- 292 - Added --include-dirs=dir[,dirs] option to load external modules from dirs (by gomezd)

Bug fixes
- 290 - fix: add timeToLastByte to onLoad and onContentLoad metrics (by william-p)
- 297 - globalVariables: remove the iframe when the list of variables is generated
- 298 - timeToFirstByte: fix race condition
- 303 - IPC: wrap JSON parsing inside try / catch block
- 304 - Detect PhantomJS crash message and report it

Internals
- 286 - Implement missing metrics meta data
- 293 - Move cookies handling to a core module
- 306 - Use 'send' and 'recv' events instead 'onResource*' (by william-p)
- 309 - requestMonitor: improvements
- 311 - Use 'entry.contentType' provided by 309 (by william-p)

This minor release of phantomas brings the support of HTTP authentication (274). An issue with Content-Length being reported incorrectly (277) is now fixed - page size related reports should be now far more reliable.

`headersBiggerThanContent` metric has been added counting responses that have bigger headers than the content.

Internally, most of the code has been ported to JavaScript strict mode.

Changelog

New metrics
- 278 - headersBiggerThanContent: add a metric

Improvements
- 266 - Add DOMContentLoaded information to HAR (by william-p)
- 274 - Support HTTP authentication
- 275 - Migrate staticAssets module to offenders

Bug fixes
- 277 - Content Length fixes
- 281 - har: fix title and address filling (by william-p)

Internals
- 269 - Use strict
- 270 - Initial version of contributions policy
- 271 - Modules: use strict

The next release will be marked with v1.0 milestone. Some time will be spent on improving documentation and tests, providing examples, use cases and polishing the API.

Changelog

New metrics
- 211 - Measure the time spent on redirects

Improvements
- 10 - StatsD integration
- 145 - Force the delay of report generation
- 205 - Web font with application/octet-stream MIME type (suggested by stefano-bortolotti)
- 213 - Force phone / tablet user agent and viewport
- 215 - TAP: add metric value when no assert is present
- 216 - Show requests that are responsible for timeout (suggested by stefanjudis)

Bug fixes
- 192 - 'undefined' is not an object (evaluating 'window.performance.timing')
- 197 - --no-externals fails when initial redirect changes the domain (reported by stefanjudis)
- 214 - Format YAMLish properly to make it work in Jenkins
- 217 - Fix timeout error for requests blocked by phantomjs (by stefanjudis)

Internals
- 186 - Run formatters in nodejs runner
- 201 - Port remaining notices to offenders framework

Trivia

_[L'Agent Secret](http://www.fantomas-lives.com/fanto3d.htm)_

**After 20 months of development and 850+ commits phantomas has reached version 1.0.**

Here's a short summary of what this release of phantomas brings:
- metrics can be stored in elasticsearch thanks to 256 by iNem0o
- phantomas can generated [HAR files](https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/HAR/Overview.html) thanks to 263 by william-p
- `run-multiple` helper script was removed, `phantomas` command now supports `--runs` option (172)
- URL can be now provided without `--url` option: e.g. `phantomas http://example.com`
- CommonJS module now emits events when metrics are set and on certain page loading milestones
- metrics metadata is available via CommonJS module (224)

Changelog

New metrics
- 232 - Report the use of Expires and Pragma caching headers
- 258 - Report global variables set to the value that casts to false
- 261 - Added the metric that shows how the main request progressed (e.g. followed redirects, etc) (by vgangan)

Improvements
- 172 - Add --runs option to phantomas
- 204 - Implement progress event in phantomas module
- 224 - Provide metrics metadata in phantomas npm module
- 229 - Update dependency on analyze-css
- 237 - Color the output only when stdout.isTTY
- 240 - Emit events via npm module for certain page loading milestones
- 243 - Multi-Run: Please add std deviation and variance to metrics output
- 249 - Allow URL to passed as a "main" option
- 253 - Introduce --progress option
- 256 - Add support to ouput metrics in elasticsearch (by iNem0o)
- 263 - HAR output (by william-p)
- 267 - cacheHits: analyze Age header

Bug fixes
- 225 - Block domains, some work others don't (by stefano-bortolotti)
- 227 - Confusing `metrics.globalVariables` vs `offenders.globalVariables` output (reported by pdehaan)
- 230 - Jserrors generate by injected Code ? (reported by jedi4ever)
- 244 - Responses with MIME type "font/*" not detected as webfonts
- 247 - run-multiple.js cannot find phantomas.js (by rupl)
- 248 - Pass envirnoment variables when running PhantomJS

Internals
- 190 - Improve documentation
- 257 - Render a visualization of phantomas commits history

The world is not perfect nor is the code. This minor release brings two bug fixes (including a fix for regression caused by 186).

Bug fix
- 221 - Handle "HTTP 303 See Other" redirects (reported by Sobia Ali)
- 222 - Script does not provide failedAsserts in programmatic mode (reported by ivn-cote)