add test suite (katspaugh#427)

.gitignore

@@ -3,3 +3,7 @@
 /node_modules
 /bower_components
 /npm-debug.log
+/.grunt
+/bin
+/_SpecRunner.html
+.DS_Store

Gruntfile.js

@@ -96,6 +96,33 @@ module.exports = function(grunt) {
         src: ['<%= concat.dist.src %>', 'plugin/*.js']
       },
     },
+    jasmine: {
+      core: {
+        src: '<%= concat.dist.src %>',
+        options: {
+          specs: 'spec/*Spec.js',
+          helpers: 'spec/helpers/*Helper.js',
+          vendor: [
+            'node_modules/jasmine-expect/dist/jasmine-matchers.js'
+          ]
+        }
+      },
+      coverage: {
+        src: '<%= concat.dist.src %>',
+        options: {
+          specs: ['spec/*Spec.js'],
+          helpers: 'spec/helpers/*Helper.js',
+          vendor: [
+            'node_modules/jasmine-expect/dist/jasmine-matchers.js'
+          ],
+          template: require('grunt-template-jasmine-istanbul'),
+          templateOptions: {
+            coverage: 'bin/coverage/coverage.json',
+            report: 'bin/coverage'
+          }
+        }
+      }
+    }
   });
 
   // ==========================================================================
@@ -127,8 +154,11 @@ module.exports = function(grunt) {
   grunt.loadNpmTasks('grunt-contrib-concat');
   grunt.loadNpmTasks('grunt-contrib-uglify');
   grunt.loadNpmTasks('grunt-contrib-jshint');
+  grunt.loadNpmTasks('grunt-contrib-jasmine');
 
   // Default task.
-  grunt.registerTask('default', ['jshint', 'concat', 'commonjs', 'amd', 'uglify']);
-
+  grunt.registerTask('test', ['jasmine:core']);
+  grunt.registerTask('coverage', ['jasmine:coverage']);
+  grunt.registerTask('default', ['jshint', 'test', 'coverage', 'concat', 'commonjs',
+                                 'amd', 'uglify']);
 };

README.md

@@ -205,7 +205,7 @@ General events:
 Install `grunt-cli` using npm:
 
 ```
-npm install -g grunt-cli
+npm install -g grunt-cli jasmine istanbul
 ```
 
 Install development dependencies:
@@ -215,14 +215,28 @@ npm install
 ```
 
 Build a minified version of the library and plugins. This command also checks
-for code-style mistakes:
+for code-style mistakes and runs the tests:
 
 ```
 grunt
 ```
 
 Generated files are placed in the `dist` directory.
 
+Running tests only:
+
+```
+grunt test
+```
+
+Creating a coverage report:
+
+```
+grunt coverage
+```
+
+The HTML report can be found in `bin/coverage/index.html`.
+
 # Credits
 
 Initial idea by [Alex Khokhulin](https://github.com/xoxulin). Many

package.json

@@ -7,7 +7,7 @@
     "example": "example"
   },
   "scripts": {
-    "test": "echo No tests yet!"
+    "test": "grunt test"
   },
   "repository": {
     "type": "git",
@@ -22,7 +22,10 @@
     "grunt": ">=0.4.5",
     "grunt-contrib-concat": ">=0.4.0",
     "grunt-contrib-uglify": ">=0.5.0",
-    "grunt-contrib-jshint": ">=0.10.0"
+    "grunt-contrib-jshint": ">=0.10.0",
+    "grunt-contrib-jasmine": ">=0.8.2",
+    "grunt-template-jasmine-istanbul": ">=0.3.3",
+    "jasmine-expect": ">=1.22.3"
   },
   "homepage": "https://github.com/katspaugh/wavesurfer.js"
 }

spec/UtilSpec.js

@@ -0,0 +1,7 @@
+describe("util", function() {
+
+    it("getId returns a unique string", function() {
+        expect(WaveSurfer.util.getId()).toStartWith('wavesurfer_');
+    });
+
+});

spec/helpers/SpecHelper.js

@@ -0,0 +1,15 @@
+beforeEach(function () {
+  jasmine.addMatchers({
+    toBePlaying: function () {
+      return {
+        compare: function (actual, expected) {
+          var player = actual;
+
+          return {
+            pass: player.currentlyPlayingSong === expected && player.isPlaying
+          }
+        }
+      };
+    }
+  });
+});

spec/support/jasmine.json

@@ -0,0 +1,9 @@
+{
+  "spec_dir": "/spec/",
+  "spec_files": [
+    "**/*[sS]pec.js"
+  ],
+  "helpers": [
+    "spec/helpers/*[hH]elper.js"
+  ]
+}