# grunt-lib-phantomjs **Repository Path**: mirrors_FGRibreau/grunt-lib-phantomjs ## Basic Information - **Project Name**: grunt-lib-phantomjs - **Description**: Grunt and PhantomJS, sitting in a tree. - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-09-24 - **Last Updated**: 2026-07-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # grunt-lib-phantomjs > Grunt and PhantomJS, sitting in a tree. ## Usage The best way to understand how this lib should be used is by looking at the [grunt-contrib-qunit](https://github.com/gruntjs/grunt-contrib-qunit) plugin. Mainly, look at how [the lib is required](https://github.com/gruntjs/grunt-contrib-qunit/blob/d99291713d32f84e50303d6e51eb2dab40b1deb6/tasks/qunit.js#L17), how [event handlers are bound](https://github.com/gruntjs/grunt-contrib-qunit/blob/d99291713d32f84e50303d6e51eb2dab40b1deb6/tasks/qunit.js#L61-L144) and how [PhantomJS is actually spawned](https://github.com/gruntjs/grunt-contrib-qunit/blob/d99291713d32f84e50303d6e51eb2dab40b1deb6/tasks/qunit.js#L177-L190). Also, in the case of the grunt-contrib-qunit plugin, it's important to know that the page being loaded into PhantomJS *doesn't* know it will be loaded into PhantomJS, and as such doesn't have any PhantomJS->Grunt code in it. That communication code, aka. the ["bridge"](https://github.com/gruntjs/grunt-contrib-qunit/blob/d99291713d32f84e50303d6e51eb2dab40b1deb6/phantomjs/bridge.js), is dynamically [injected into the html page](https://github.com/gruntjs/grunt-contrib-qunit/blob/d99291713d32f84e50303d6e51eb2dab40b1deb6/tasks/qunit.js#L152). ## An inline example If a Grunt task looked something like this: ```js grunt.registerTask('mytask', 'Integrate with phantomjs.', function() { var phantomjs = require('grunt-lib-phantomjs').init(grunt); var errorCount = 0; // Handle any number of namespaced events like so. phantomjs.on('mytask.ok', function(msg) { grunt.log.writeln(msg); }); phantomjs.on('mytask.error', function(msg) { errorCount++; grunt.log.error(msg); }); // Create some kind of "all done" event. phantomjs.on('mytask.done', function() { phantomjs.halt(); }); // Built-in error handlers. phantomjs.on('fail.load', function(url) { phantomjs.halt(); grunt.warn('PhantomJS unable to load URL.'); }); phantomjs.on('fail.timeout', function() { phantomjs.halt(); grunt.warn('PhantomJS timed out.'); }); // This task is async. var done = this.async(); // Spawn phantomjs phantomjs.spawn('test.html', { // Additional PhantomJS options. options: {}, // Complete the task when done. done: function(err) { done(err || errorCount === 0); } }); }); ``` And `test.html` looked something like this (note the "bridge" is hard-coded into this page and not injected): ```html ``` Then running Grunt would behave something like this: ```shell $ grunt mytask Running "mytask" task Something worked. >> Something failed. Warning: Task "mytask" failed. Use --force to continue. Aborted due to warnings. ``` ## OS Dependencies PhantomJS requires these dependencies **On Ubuntu/Debian** apt-get install libfontconfig1 fontconfig libfontconfig1-dev libfreetype6-dev ## Release History * 2013-02-28 - v0.3.0 - Use PhantomJS 1.9.0-1. * 2013-02-28 - v0.2.0 - Use PhantomJS 1.8.1. * 2012-12-21 - v0.1.0 - Use PhantomJS 1.7.0.