Add top-level reset method.

Resolves #175

Author: jamesplease

README.md

@@ -421,12 +421,23 @@ may overwrite it with your own logging message if you wish.
 
 ### 'Top-level' API
 
-If you'd like to execute a method on a channel, yet you don't need to keep a handle of the channel around, you can do so with the proxy
-functions directly on the `Backbone.Radio` object.
+If you'd like to execute a method on a channel, yet you don't need to keep a handle of the
+channel around, you can do so with the proxy functions directly on the `Backbone.Radio` object.
 
 ```js
 // Trigger 'some:event' on the settings channel
 Backbone.Radio.trigger('settings', 'some:event');
 ```
 
 All of the methods for all three messaging systems are available from the top-level API.
+
+#### `reset( [channelName] )`
+
+You can also reset a single channel, or all Channels, from the `Radio` object directly. Pass a
+`channelName` to reset just that specific channel, or call the method without any arguments
+to reset every channel.
+
+```js
+// Reset all channels
+Radio.reset();
+```

src/backbone.radio.js

@@ -392,3 +392,8 @@ _.each(systems, function(system) {
     };
   });
 });
+
+Radio.reset = function(channelName) {
+  var channels = !channelName ? this._channels : [this._channels[channelName]];
+  _.invoke(channels, 'reset');
+};

test/setup/helpers.js

@@ -7,7 +7,7 @@ function setupTestHelpers() {
 
   afterEach(function() {
     Backbone.Radio.DEBUG = false;
-    _.invoke(Backbone.Radio._channels, 'reset');
+    Backbone.Radio.reset();
     this.sinon.restore();
     delete global.stub;
     delete global.spy;

test/spec/top-level.js

@@ -4,6 +4,43 @@ describe('Top-level API:', function() {
     stub(this.channel);
   });
 
+  describe('Reset', function() {
+    beforeEach(function() {
+      this.channelOne = Backbone.Radio.channel('channelOne');
+      this.channelTwo = Backbone.Radio.channel('channelTwo');
+
+      stub(this.channelOne, 'reset');
+      stub(this.channelTwo, 'reset');
+    });
+
+    describe('when passing a channel name', function() {
+      beforeEach(function() {
+        Backbone.Radio.reset('channelOne');
+      });
+
+      it('should reset that channel', function() {
+        expect(this.channelOne.reset).to.have.been.calledOnce;
+      });
+
+      it('should not reset the other channels', function() {
+        expect(this.channel.reset).to.not.have.been.called;
+        expect(this.channelTwo.reset).to.not.have.been.called;
+      });
+    });
+
+    describe('when not passing a channel name', function() {
+      beforeEach(function() {
+        Backbone.Radio.reset();
+      });
+
+      it('should reset all channels', function() {
+        expect(this.channel.reset).to.have.been.calledOnce;
+        expect(this.channelOne.reset).to.have.been.calledOnce;
+        expect(this.channelTwo.reset).to.have.been.calledOnce;
+      });
+    });
+  });
+
   describe('when executing Commands methods', function() {
     beforeEach(function() {
       Backbone.Radio.comply('myChannel', 'some:command', 'firstArg1', 'secondArg1');