Merge pull request ericdrowell#1033 from pronebird/master

Add findOne() convenience method on Container

src/Container.js

@@ -179,6 +179,9 @@
 
             return Kinetic.Collection.toCollection(retArr);
         },
+        findOne: function(selector) {
+            return this.find(selector)[0];
+        },
         _getNodeById: function(key) {
             var node = Kinetic.ids[key];
 

test/unit/Container-test.js

@@ -1024,6 +1024,21 @@ suite('Container', function() {
         layer.draw();
     });
 
+    // ======================================================
+    test('test findOne() selector by quering existing and non-existing nodes by name', function () {
+        var stage = addStage();
+        var layer = new Kinetic.Layer();
+
+        var rect = new Kinetic.Rect({
+            name: 'rect'
+        });
+
+        layer.add(rect);
+
+        assert.equal(layer.findOne('.rect'), rect, 'findOne() on existing node must return a single node.');
+        assert.equal(layer.findOne('.doesNotExist'), undefined, 'findOne() on non-existing node must return undefined.');
+    });
+
     // ======================================================
     test('add layer then shape', function() {
         var stage = addStage();