[#1037] Popcorn.dom, Popcorn.dom.find( selector ) tests.

Signed-off-by: Rick Waldron waldron.rick@gmail.com <waldron.rick@gmail.com>

test/popcorn.unit.js

@@ -1263,6 +1263,98 @@ test( "Popcorn.events.hooks: canplayall fires immediately if ready", function()
 
 */
 
+module( "Popcorn.dom" );
+
+test( "Popcorn.dom API", 2, function() {
+
+  ok( Popcorn.dom, "Popcorn.dom exists" );
+  ok( Popcorn.dom.find, "Popcorn.dom.find exists" );
+
+});
+
+test( "Popcorn.dom.find( selector ) Returns single node matching selector", function() {
+
+  var fixture = document.getElementById("video"),
+      allowed = [
+        { desc: "nodeName",       selector: "video" },
+        { desc: "id, w/ #",       selector: "#video" },
+        { desc: "id, w/o #",      selector: "video" },
+        { desc: "class",          selector: ".dom-tests" },
+        { desc: "attr, data",     selector: "[data-custom]" },
+        { desc: "attr, controls", selector: "[controls]" },
+        { desc: "attr, preload",  selector: "[preload]" }
+      ];
+
+  expect( allowed.length * 3 );
+
+  allowed.forEach(function( set ) {
+
+    // selector as is
+    deepEqual( Popcorn.dom.find( set.selector ), fixture, set.desc + ", selector as-is" );
+
+    // selector with leading whitespace
+    deepEqual( Popcorn.dom.find( "  " + set.selector ), fixture, set.desc + ", selector w/ leading whitespace" );
+
+    // selector with trailing whitespace
+    deepEqual( Popcorn.dom.find( set.selector + "  " ), fixture, set.desc + ", selector w/ trailing whitespace" );
+
+  });
+});
+
+test( "Popcorn.dom.find( selector, context ) Returns single node matching selector within context", function() {
+
+  var context = document.getElementById("popcorn-dom-find-context"),
+      fixture = document.getElementById("inside-context"),
+      allowed = [
+        { desc: "nodeName",       selector: "div" },
+        { desc: "class",          selector: ".contextual" },
+        { desc: "attr, data",     selector: "[data-contextual]" }
+      ];
+
+  expect( allowed.length );
+
+  allowed.forEach(function( set ) {
+
+    // selector as is
+    deepEqual( Popcorn.dom.find( set.selector, context ), fixture, set.desc );
+  });
+});
+
+test( "Popcorn.dom.find() Returns null for unmatched selector", function() {
+
+  var fixture = document.getElementById("video"),
+      allowed = [
+        { desc: "nodeName",       selector: "object" },
+        { desc: "id, w/ #",       selector: "#wontfind" },
+        { desc: "id, w/o #",      selector: "wontfind" },
+        { desc: "class",          selector: ".missing" },
+        { desc: "attr, data",     selector: "[data-nope]" }
+      ];
+
+  expect( allowed.length );
+
+  allowed.forEach(function( set ) {
+    // selector as is
+    deepEqual( Popcorn.dom.find( set.selector ), null, set.desc );
+  });
+});
+
+test( "Popcorn.dom.find() Returns null for invalid selectors", function() {
+
+  var fixture = document.getElementById("video"),
+      allowed = [
+        { desc: "closing bracket",       selector: "]" },
+        { desc: "escapes \\",       selector: "\/" }
+      ];
+
+  expect( allowed.length );
+
+  allowed.forEach(function( set ) {
+    // selector as is
+    deepEqual( Popcorn.dom.find( set.selector ), null, set.desc );
+  });
+});
+
 module( "Popcorn Position" );
 test( "position", function() {