feat: Allow saving screenshots in addition to snapshots

* Rename the `dest` directory to `snapshots` and leave it still working
as deprecated.
* Introduce `screenshots` directory for PNGs.
* Remove file extensions from file names. .html and .png is added for
snapshots and screenshots.
* Set the viewport size only, if it changes.
* Upgrade dependencies.
* Update the license.
* Mention additional Grunt tasks, which are usually used to support test
automation.

Author: prantlf

.gitignore

@@ -2,4 +2,5 @@
 coverage
 node_modules
 npm-debug.log
+test/screenshots
 test/snapshots

.npmignore

@@ -8,4 +8,5 @@ coverage
 Gruntfile.js
 node_modules
 npm-debug.log
+test/screenshots
 test/snapshots

.vscode/settings.json

@@ -4,6 +4,7 @@
     "coverage": true,
     "node_modules": true,
     "npm-debug.log": true,
+    "test/screenshots": true,
     "test/snapshots": true
   }
 }

Gruntfile.js

@@ -10,7 +10,7 @@ module.exports = function (grunt) {
         'tasks/*.js',
         '<%= nodeunit.tests %>'
       ]
-	},
+    },
 
     instrument: {
       files: 'tasks/*.js',
@@ -55,50 +55,64 @@ module.exports = function (grunt) {
 
     clean: {
       coverage: ['coverage/**'],
-      snapshots: ['test/snapshots/*']
+      snapshots: ['test/snapshots/*'],
+      screenshots: ['test/screenshots/*']
     },
 
     'html-dom-snapshot': {
       options: {
         browserCapabilities: {
           browserName: 'phantomjs'
         },
-        dest: 'test/snapshots'
+        snapshots: 'test/snapshots'
       },
       'single-target.html': {
         url: 'http://localhost:8881/test/pages/single-target.html'
       },
       others: {
         commands: [
           {
+            options: {
+              snapshots: null,
+              screenshots: 'test/screenshots'
+            },
             file: 'static.html',
             url: 'http://localhost:8881/test/pages/static.html'
           },
           {
-            file: 'delayed.html',
+            file: 'delayed',
             url: 'http://localhost:8881/test/pages/delayed.html',
             wait: 200
           },
           {
-            file: 'dynamic.html',
+            options: {
+              screenshots: 'test/screenshots'
+            },
+            file: 'dynamic',
             url: 'http://localhost:8881/test/pages/dynamic.html',
             wait: '.dynamic'
           },
           {
-            file: 'dynamic-reverse.html',
+            options: {
+              viewport: {
+                width: 1600,
+                height: 900
+              }
+            },
+            file: 'dynamic-reverse',
             url: 'http://localhost:8881/test/pages/dynamic-reverse.html',
             wait: '!.dynamic'
           },
           {
-            file: 'dynamic-delayed.html',
+            file: 'dynamic-delayed',
             url: 'http://localhost:8881/test/pages/dynamic-delayed.html',
             wait: [
               '.dynamic',
               200
             ]
           },
           {
-            file: 'dynamic-custom.html',
+            file: 'dynamic-custom',
             url: 'http://localhost:8881/test/pages/dynamic-custom.html',
             wait: function (browser) {
               return browser.waitForExist('.dynamic', 1000);
@@ -108,24 +122,24 @@ module.exports = function (grunt) {
             options: {
               doctype: ''
             },
-            file: 'no-doctype.html',
+            file: 'no-doctype',
             url: 'http://localhost:8881/test/pages/no-doctype.html'
           },
           {
             url: 'http://localhost:8881/test/pages/dynamic-multiple.html'
           },
           {
-            file: 'dynamic-first.html'
+            file: 'dynamic-first'
           },
           {
             wait: '.second',
-            file: 'dynamic-second.html'
+            file: 'dynamic-second'
           },
           {
             wait: '.third'
           },
           {
-            file: 'dynamic-third.html'
+            file: 'dynamic-third'
           }
         ]
       },
@@ -139,28 +153,45 @@ module.exports = function (grunt) {
       },
       'invalid-file': {
         options: {
+          screenshots: 'test/screenshots',
           force: true
         },
         pages: [
           {
             url: 'http://localhost:8881',
-            file: '//'
+            file: '/\\//\\'
           }
         ]
       },
       'invalid-dest': {
         options: {
-          dest: '//',
+          dest: '/ /',
           force: true
         },
         dummy: {
-          url: 'http://localhost:8881'
+          url: 'http://localhost:8881',
+          file: 'dummy'
         }
+      },
+      'invalid-screenshots': {
+        options: {
+          screenshots: '/ /',
+          force: true
+        },
+        pages: [
+          {
+            url: 'http://localhost:8881',
+            file: 'dummy'
+          }
+        ]
       }
     },
 
     'selenium_standalone': {
-      serverConfig: {
+      options: {
+        stopOnExit: true
+      },
+      server: {
         seleniumVersion: '3.7.1',
         seleniumDownloadURL: 'http://selenium-release.storage.googleapis.com',
         drivers: {
@@ -181,16 +212,14 @@ module.exports = function (grunt) {
   grunt.loadNpmTasks('grunt-selenium-standalone');
   grunt.loadTasks(coverage ? 'coverage/tasks' : 'tasks');
 
-  grunt.registerTask('default', coverage ? [
-    'clean', 'eslint', 'instrument',
-    'selenium_standalone:serverConfig:install',
-    'selenium_standalone:serverConfig:start',
-    'connect', 'html-dom-snapshot',
-    'selenium_standalone:serverConfig:stop',
-    'nodeunit', 'storeCoverage', 'makeReport'] : [
-    'clean', 'eslint',
-    'selenium_standalone:serverConfig:install',
-    'selenium_standalone:serverConfig:start',
-    'connect', 'html-dom-snapshot',
-    'selenium_standalone:serverConfig:stop', 'nodeunit']);
+  const start = ['clean', 'eslint'],
+        instrument = coverage ? ['instrument'] : [],
+        test = ['selenium_standalone:server:install',
+                'selenium_standalone:server:start',
+                'connect', 'html-dom-snapshot',
+                'selenium_standalone:server:stop', 'nodeunit'],
+        report = coverage ? ['storeCoverage', 'makeReport'] : [];
+  grunt.registerTask('default', start.concat(instrument)
+                                     .concat(test)
+                                     .concat(report));
 };

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017 Ferdinand Prantl
+Copyright (c) 2017-2018 Ferdinand Prantl
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal