Prepare for an (aspirational) JavaScript testing environment.

This commit includes BackboneJS as part of our `package.json`'s
`devDependencies` and configures Karma to load it as necessary. This
means we are mostly ready for testing Backbone components when and if we
figure out what, exactly, we'd like to test.

Previous to this commit, there was a rather contrived test for a single
method. However, that was only ever being used in one place, so I've
refactored it and removed it from the test suite as it's a single jQuery
call, anyway.

buoy.js

@@ -86,19 +86,9 @@ var BUOY = (function () {
         });
     };
 
-    /**
-     * Helper to get the number of Buoy Alerts shown in the admin bar.
-     *
-     * @return {number}
-     */
-    var countIncidentMenuItems = function () {
-        return jQuery('#wp-admin-bar-buoy-alerts-menu').length;
-    };
-
     return {
         'init': init,
         'installWebApp': installWebApp,
-        'countIncidentMenuItems': countIncidentMenuItems,
         'Models': Models,
         'Views': Views,
         'Collections': Collections

includes/alert.js

@@ -206,13 +206,6 @@
         this.$el.removeClass('hidden');
     };
 
-    /**
-     * Hide the Choose Teams Panel.
-     */
-    BUOY.Views.ChooseTeamsPanel.prototype.hide = function () {
-        this.$el.addClass('hidden');
-    };
-
     /**
      * Handles the alert submission form (a new alert).
      *
@@ -363,7 +356,7 @@
         jQuery.post(this.$el.attr('href'), data, function (response) {
             if (response.success) {
                 item.$el.remove();
-                if (0 === BUOY.countIncidentMenuItems()) {
+                if (0 === jQuery('#wp-admin-bar-buoy-alerts-menu a').length) {
                     jQuery('#wp-admin-bar-buoy-alerts-menu').remove();
                 }
             }

karma.conf.js

@@ -16,7 +16,10 @@ module.exports = function(config) {
     // list of files / patterns to load in the browser
     files: [
       'bower_components/*/dist/**/*.js',
+      'node_modules/underscore/underscore.js',
+      'node_modules/backbone/backbone.js',
       'buoy.js',
+      'includes/alert.js',
       'tests/**/*.js'
     ],
 

package.json

@@ -24,6 +24,7 @@
   },
   "homepage": "https://meitar.github.io/better-angels/",
   "devDependencies": {
+    "backbone": "^1.3.3",
     "jasmine-core": "^2.4.1",
     "karma": "^0.13.19",
     "karma-firefox-launcher": "^0.1.7",

tests/my_first_test.js

@@ -1,8 +1,33 @@
+/**
+ * Aspirational JavaScript testing file for Buoy client-side.
+ *
+ * @file Client-side Buoy tests.
+ *
+ * @see {@link https://github.com/betterangels/buoy/wiki/Setting-up-a-development-environment#running-tests}
+ *
+ * @todo Look into SinonJS for mocking Ajax calls and other difficult
+ *       testing stuff.
+ */
+
 'use strict';
 
-describe("BUOY main class", function() {
-    it("counts number of menu items", function() {
-        $(document.body).append('<div id="wp-admin-bar-buoy-alerts-menu"> <a> test </a> <a> test2 </a> </div>')
-        expect(BUOY.countIncidentMenuItems()).toBe(2)
-    });
+/**
+ * Main Buoy module tests.
+ */
+describe("Buoy main class", function() {
+    // TODO
+});
+
+/**
+ * Buoy Alert module tests.
+ */
+describe('Buoy Alert module', function () {
+    // TODO
+});
+
+/**
+ * Buoy Map module tests.
+ */
+describe('Buoy Map module', function () {
+    // TODO
 });