Adds getSynths() method to flock.band.

src/synths/band.js

@@ -6,7 +6,7 @@
  * Dual licensed under the MIT and GPL Version 2 licenses.
  */
 
-/*global require*/
+/*global require, flock*/
 /*jshint white: false, newcap: true, regexp: true, browser: true,
     forin: false, nomen: true, bitwise: false, maxerr: 100,
     indent: 4, plusplus: false, curly: true, eqeqeq: true,
@@ -37,6 +37,11 @@ var fluid = fluid || require("infusion");
 
             set: {
                 func: "{that}.events.onSet.fire"
+            },
+
+            getSynths: {
+                funcName: "flock.band.getSynths",
+                args: ["{that}"]
             }
         },
 
@@ -79,4 +84,15 @@ var fluid = fluid || require("infusion");
             }
         }
     });
+
+    flock.band.getSynths = function (that) {
+        var synths = [];
+        fluid.each(that.options.components, function (componentDef, name) {
+            if (fluid.hasGrade(that[name].options, "flock.synth")) {
+                synths.push(that[name]);
+            }
+        });
+
+        return synths;
+    };
 }());

tests/unit/js/core-tests.js

@@ -467,6 +467,47 @@ var fluid = fluid || require("infusion"),
             "as the environment itself.");
     });
 
+    test("getSynths", function () {
+        fluid.defaults("flock.test.band", {
+            gradeNames: "flock.band",
+
+            components: {
+                synth1: {
+                    type: "flock.synth",
+                    options: {
+                        synthDef: {
+                            ugen: "flock.ugen.sin"
+                        }
+                    }
+                },
+
+                synth2: {
+                    type: "flock.synth",
+                    options: {
+                        synthDef: {
+                            ugen: "flock.ugen.sin"
+                        }
+                    }
+                },
+
+                nonSynth: {
+                    type: "fluid.component"
+                }
+            }
+        });
+
+        var b = flock.test.band();
+        var synths = b.getSynths();
+
+        equal(synths.length, 2,
+            "The correct number of synths were returned from getSynths().");
+
+        fluid.each(synths, function (synth) {
+            ok(fluid.hasGrade(synth.options, "flock.synth"),
+                "All synths returned from getSynths() are of the appropriate grade.");
+        });
+    });
+
     test("Options clamping", function () {
         var enviro = flock.init({
             chans: 64,