Viff

Find visual differences between web pages in different environments (developing, staging, production) and browsers.

Join discussion in

Video Quick Introduction

Installation

Viff runs on selenium sever. Don't worry, you can easily set up selenium server using wdm.

$ npm install wdm -g
$ wdm update --standalone // install selenium and webdrivers

Then install viff command line.

npm install -g viff

Examples

Checkout viff-examples repository for more examples, including:

1. Tiny CSS difference
2. Chart difference
3. Content difference
4. Partial difference
5. Event Handling
6. Responsive
7. Multiple browsers
8. Multiple Environments
9. Browserstack
10. Programmable
11. Using Viff Server (beta)

Quick example

Start server

$ wdm start // open selenium webdriver server

You could run it using a xx.config.js file.

// build_prod.config.js
'use strict'

module.exports = {
  seleniumHost: 'http://localhost:4444/wd/hub',
  browsers: ['firefox'/*, 'chrome', 'safari', 'opera'*/],
  envHosts: {
    build: 'http://localhost:4000',
    prod: 'http://www.ishouldbeageek.me'
  },
  paths: [
    '/404.html',
    '/',
    '/page2',
    '/page3',
    '/page4',
    '/page5',
    '/strict-mode',
    ['/', function clickLink(browser) {
      // need to return a promise
      return browser.elementByPartialLinkText('viff').click();
    }],
    ['/', '#main-content'/*, function (browser) { } */],
    { 'this is a testcase description' : ['/', '#main-content', function(browser) {
      return browser.maximize();
    }]}
  ],
  maxInstance: 3
};

Then, you could run

viff ./build_prod.config.js

Programmable

Use viff in your own project.

var Viff = require('viff');
var viff = new Viff('http://localhost:4444/wd/hub');

viff.takeScreenshot('firefox', 'http://localhost:3000', '/path1', function (bufferImg) {
  /* buffer of images */  
});

// partial of web pages
viff.takeScreenshot('firefox', 'http://localhost:3000', ['path1', '#css-selecor'], function (bufferPartialImg) {});

// responsive of web pages
function size(width) {
  return function (driver) {
    driver.setWindowSize(width, 600 /* any height*/);
  };
}

viff.takeScreenshot('firefox', 'http://localhost:3000', ['path', size(1024)], function (bufferImg) {});

// Q promise
viff.takeScreenshot('firefox', 'http://localhost:3000', ['path', size(1024)])
  .done(function (bufferImg) {
    /* generate image here */
  })
  .catch(function (err) {
    /* handle err here */
  })

// using browserstack
viff = new Viff('http://hub.browserstack.com/wd/hub');
viff.takeScreenshot({
  'browserName' : 'iPhone',
  'platform' : 'MAC',
  'device' : 'iPhone 5',
  'browserstack.user': /* your name */,
  'browserstack.key': /* your key */
}, 'http://www.google.com', 'path1', function (bufferImg) {});

file report embeded in viff reporter

repo for viff reporter is ViffReport

Using Viff Server (beta)

You could try viffserver and viff-client to do the viff testing with your functional testing.

Run the viff server first.

$ viffserver

And integrated viffclient.post method in your functional testing code. Check more in Viff Examples or Viff Client.

History

2014-08-07 viff@0.10.3 no need to install coffee-script before hand.

2014-06-08 viff@0.10.x could use multi viff instances to improve testing performance (maxInstance property).

2014-05-18 viff@0.9.0 finally replace canvas by phantomjs, so easy installation starts from now, even in Windows System.

2014-03-15 viff@0.8.2 could setup viff server and wait for screenshots from the place out of viff. Check out the viff client example.

2014-03-11 viff@0.8.0 use wd to replace selenium-webdriver, so that you could use beautiful Q Promised API in your code.

---

2014-02-26 viff@0.7.6 simplify console output DEMO.

2014-02-17 viff@0.7.2 make viff programmable.

2013-12-25 viff@0.7.0 refactor testcases and compare differences cross browsers !!! Merry Christmas !!!

2013-11-13 viff@0.6.1 optimise memory usage and only support file report format

2013-10-30 viff@0.5.0 add testcase running status in console.

2013-10-27 viff@0.4.2 won't stop testing if one of them fail.

2013-09-22 viff@0.4.1 could write testcase description.

2013-08-08 viff@0.4.0 add partial screenshot support. working perfectly in firefox, phantomjs.

2013-08-01 viff@0.3.0 add new report format file, which will generate images.

2013-07-24 viff@0.2.0 use resemble.js to replace imagemagick

2013-07-16 viff@0.1.2 support resizing images before finding diff

License

Copyright (c) 2013 - 2016 Wang Qiu (winsonwq@gmail.com)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.