1 files changed, 457 insertions, 0 deletions
diff --git a/tools/addon-sdk-1.12/test/test-selection.js b/tools/addon-sdk-1.12/test/test-selection.js
new file mode 100644
index 0000000..9985ca4
--- /dev/null
+++ b/tools/addon-sdk-1.12/test/test-selection.js
@@ -0,0 +1,457 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+let timer = require("sdk/timers");
+let {Cc,Ci} = require("chrome");
+
+// Arbitrary delay needed to avoid weird behavior.
+// TODO: We need to find all uses of this and replace them
+// with more deterministic solutions.
+const ARB_DELAY = 100;
+
+// Select all divs elements in an HTML document
+function selectAllDivs(window) {
+  let divs = window.document.getElementsByTagName("div");
+  let s = window.getSelection();
+  if (s.rangeCount > 0)
+    s.removeAllRanges();
+  for (let i = 0; i < divs.length; i++) {
+    let range = window.document.createRange();
+    range.selectNode(divs[i]);
+    s.addRange(range);
+  }
+}
+
+function selectTextarea(window, from, to) {
+  let textarea = window.document.getElementsByTagName("textarea")[0];
+
+  from = from || 0;
+  to = to || textarea.value.length;
+
+  textarea.setSelectionRange(from, to);
+  textarea.focus();
+}
+
+function primeTestCase(html, test, callback) {
+  let tabBrowser = require("sdk/deprecated/tab-browser");
+  let dataURL = "data:text/html;charset=utf-8," + encodeURI(html);
+  let tracker = tabBrowser.whenContentLoaded(
+    function(window) {
+      if (window.document.location.href != dataURL)
+        return;
+      callback(window, test);
+      timer.setTimeout(function() {
+          tracker.unload();
+          test.done();
+          window.close();
+        },
+        ARB_DELAY);
+    }
+  );
+  tabBrowser.addTab(dataURL);
+}
+
+const DIV1 = '<div id="foo">bar</div>';
+const DIV2 = '<div>noodles</div>';
+const HTML_MULTIPLE = '<html><body>' + DIV1 + DIV2 + '</body></html>';
+const HTML_SINGLE = '<html><body>' + DIV1 + '</body></html>';
+
+// Tests of contiguous
+
+exports.testContiguousMultiple = function testContiguousMultiple(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_MULTIPLE, test, function(window, test) {
+    selectAllDivs(window);
+    test.assertEqual(selection.isContiguous, false,
+      "selection.isContiguous multiple works.");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testContiguousSingle = function testContiguousSingle(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_SINGLE, test, function(window, test) {
+    selectAllDivs(window);
+    test.assertEqual(selection.isContiguous, true,
+      "selection.isContiguous single works.");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testContiguousWithoutSelection =
+  function testContiguousWithoutSelection(test) {
+    let selection = require("sdk/selection");
+    primeTestCase(HTML_SINGLE, test, function(window, test) {
+      test.assertEqual(selection.isContiguous, false,
+        "selection.isContiguous without selection works.");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+/**
+ * Test that setting the contiguous property has no effect.
+ */
+/*exports.testSetContiguous = function testSetContiguous(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_MULTIPLE, test, function(window, test) {
+    selectAllDivs(window);
+    try {
+      selection.isContiguous = true;
+      test.assertEqual(selection.isContiguous, false,
+        "setting selection.isContiguous doesn't work (as expected).");
+    }
+    catch (e) {
+      test.pass("setting selection.isContiguous doesn't work (as expected).");
+    }
+  });
+
+  test.waitUntilDone(5000);
+};*/
+
+
+// HTML tests
+
+exports.testGetHTMLSingleSelection = function testGetHTMLSingleSelection(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_SINGLE, test, function(window, test) {
+    selectAllDivs(window);
+    test.assertEqual(selection.html, DIV1, "get html selection works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+/* Myk's comments: This is fine.  However, it reminds me to figure out and
+   specify whether iteration is ordered.  If so, we'll want to change this
+   test in the future to test that the discontiguous selections are returned in
+   the appropriate order. In the meantime, add a comment to that effect here */
+exports.testGetHTMLMultipleSelection =
+  function testGetHTMLMultipleSelection(test) {
+    let selection = require("sdk/selection");
+    primeTestCase(HTML_MULTIPLE, test, function(window, test) {
+      selectAllDivs(window);
+      let assertions = false;
+      for each (let i in selection) {
+        test.assertEqual(true, [DIV1, DIV2].some(function(t) t == i.html),
+          "get multiple selection html works");
+        assertions = true;
+      }
+      // Ensure we ran at least one assertEqual()
+      test.assert(assertions, "No assertions were called");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+exports.testGetHTMLNull = function testGetHTMLNull(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_SINGLE, test, function(window, test) {
+    test.assertEqual(selection.html, null, "get html null works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testGetHTMLWeird = function testGetHTMLWeird(test) {
+  let selection = require("sdk/selection");
+  // If the getter is used when there are contiguous selections, the first
+  // selection should be returned
+  primeTestCase(HTML_MULTIPLE, test, function(window, test) {
+    selectAllDivs(window);
+    test.assertEqual(selection.html, DIV1, "get html weird works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testGetHTMLNullInTextareaSelection =
+  function testGetHTMLNullInTextareaSelection(test) {
+      let selection = require("sdk/selection");
+
+      primeTestCase(TEXT_FIELD, test, function(window, test) {
+        selectTextarea(window);
+
+        test.assertEqual(selection.html, null, "get html null in textarea works")
+      });
+
+      test.waitUntilDone(5000);
+};
+
+const REPLACEMENT_HTML = "<b>Lorem ipsum dolor sit amet</b>";
+
+exports.testSetHTMLSelection = function testSetHTMLSelection(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_SINGLE, test, function(window, test) {
+    selectAllDivs(window);
+    selection.html = REPLACEMENT_HTML;
+    test.assertEqual(selection.html, "<span>" + REPLACEMENT_HTML +
+      "</span>", "selection html works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testSetHTMLException = function testSetHTMLException(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(HTML_SINGLE, test, function(window, test) {
+    try {
+      selection.html = REPLACEMENT_HTML;
+      test.fail("set HTML throws when there's no selection.");
+    }
+    catch (e) {
+      test.pass("set HTML throws when there's no selection.");
+    }
+  });
+
+  test.waitUntilDone(5000);
+};
+
+const TEXT1 = "foo";
+const TEXT2 = "noodles";
+const TEXT_MULTIPLE = "<html><body><div>" + TEXT1 + "</div><div>" + TEXT2 +
+  "</div></body></html>";
+const TEXT_SINGLE = "<html><body><div>" + TEXT1 + "</div></body></html>";
+const TEXT_FIELD = "<html><body><textarea>" + TEXT1 + "</textarea></body></html>";
+
+// Text tests
+
+exports.testSetHTMLinTextareaSelection =
+  function testSetHTMLinTextareaSelection(test) {
+    let selection = require("sdk/selection");
+
+    primeTestCase(TEXT_FIELD, test, function(window, test) {
+      selectTextarea(window);
+
+      // HTML string is set as plain text in textareas, that's because
+      // `selection.html` and `selection.text` are basically aliases when a
+      // value is set. See bug 677269
+      selection.html = REPLACEMENT_HTML;
+
+      test.assertEqual(selection.text, REPLACEMENT_HTML,
+        "set selection html in textarea works");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+exports.testGetTextSingleSelection =
+  function testGetTextSingleSelection(test) {
+  let selection = require("sdk/selection");
+    primeTestCase(TEXT_SINGLE, test, function(window, test) {
+      selectAllDivs(window);
+      test.assertEqual(selection.text, TEXT1, "get text selection works");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+exports.testGetTextMultipleSelection =
+  function testGetTextMultipleSelection(test) {
+  let selection = require("sdk/selection");
+    primeTestCase(TEXT_MULTIPLE, test, function(window, test) {
+      selectAllDivs(window);
+      let assertions = false;
+      for each (let i in selection) {
+        test.assertEqual(true, [TEXT1, TEXT2].some(function(t) t == i.text),
+          "get multiple selection text works");
+        assertions = true;
+      }
+      // Ensure we ran at least one assertEqual()
+      test.assert(assertions, "No assertions were called");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+exports.testGetTextNull = function testGetTextNull(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(TEXT_SINGLE, test, function(window, test) {
+    test.assertEqual(selection.text, null, "get text null works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testGetTextWeird = function testGetTextWeird(test) {
+  let selection = require("sdk/selection");
+  // If the getter is used when there are contiguous selections, the first
+  // selection should be returned
+  primeTestCase(TEXT_MULTIPLE, test, function(window, test) {
+    selectAllDivs(window);
+    test.assertEqual(selection.text, TEXT1, "get text weird works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testGetTextNullInTextareaSelection =
+  function testGetTextInTextareaSelection(test) {
+    let selection = require("sdk/selection");
+
+    primeTestCase(TEXT_FIELD, test, function(window, test) {
+      test.assertEqual(selection.text, null, "get text null in textarea works")
+    });
+
+    test.waitUntilDone(5000);
+};
+
+exports.testGetTextInTextareaSelection =
+  function testGetTextInTextareaSelection(test) {
+    let selection = require("sdk/selection");
+
+    primeTestCase(TEXT_FIELD, test, function(window, test) {
+      selectTextarea(window);
+
+      test.assertEqual(selection.text, TEXT1, "get text null in textarea works")
+    });
+
+    test.waitUntilDone(5000);
+};
+
+const REPLACEMENT_TEXT = "Lorem ipsum dolor sit amet";
+
+exports.testSetTextSelection = function testSetTextSelection(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(TEXT_SINGLE, test, function(window, test) {
+    selectAllDivs(window);
+    selection.text = REPLACEMENT_TEXT;
+    test.assertEqual(selection.text, REPLACEMENT_TEXT, "selection text works");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testSetHTMLException = function testSetHTMLException(test) {
+  let selection = require("sdk/selection");
+  primeTestCase(TEXT_SINGLE, test, function(window, test) {
+    try {
+      selection.text = REPLACEMENT_TEXT;
+      test.fail("set HTML throws when there's no selection.");
+    }
+    catch (e) {
+      test.pass("set HTML throws when there's no selection.");
+    }
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testSetTextInTextareaSelection =
+  function testSetTextInTextareaSelection(test) {
+    let selection = require("sdk/selection");
+
+    primeTestCase(TEXT_FIELD, test, function(window, test) {
+      selectTextarea(window);
+
+      selection.text = REPLACEMENT_TEXT;
+
+      test.assertEqual(selection.text, REPLACEMENT_TEXT,
+        "set selection text in textarea works");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+// Iterator tests
+
+exports.testIterator = function testIterator(test) {
+  let selection = require("sdk/selection");
+  let selectionCount = 0;
+  primeTestCase(TEXT_MULTIPLE, test, function(window, test) {
+    selectAllDivs(window);
+    for each (let i in selection)
+      selectionCount++;
+    test.assertEqual(2, selectionCount, "iterator works.");
+  });
+
+  test.waitUntilDone(5000);
+};
+
+exports.testIteratorWithTextareaSelection =
+  function testIteratorWithTextareaSelection(test) {
+    let selection = require("sdk/selection");
+    let selectionCount = 0;
+
+    primeTestCase(TEXT_FIELD, test, function(window, test) {
+      selectTextarea(window);
+
+      for each (let i in selection)
+        selectionCount++;
+
+      test.assertEqual(1, selectionCount, "iterator works in textarea.");
+    });
+
+    test.waitUntilDone(5000);
+};
+
+/* onSelect tests */
+
+/*
+function sendSelectionSetEvent(window) {
+  const Ci = Components['interfaces'];
+  let utils = window.QueryInterface(Ci.nsIInterfaceRequestor).
+                                    getInterface(Ci.nsIDOMWindowUtils);
+  if (!utils.sendSelectionSetEvent(0, 1, false))
+    dump("**** sendSelectionSetEvent did not select anything\n");
+  else
+    dump("**** sendSelectionSetEvent succeeded\n");
+}
+
+// testOnSelect() requires nsIDOMWindowUtils, which is only available in
+// Firefox 3.7+.
+exports.testOnSelect = function testOnSelect(test) {
+  let selection = require("sdk/selection");
+  let callbackCount = 0;
+  primeTestCase(TEXT_SINGLE, test, function(window, test) {
+    selection.onSelect = function() {callbackCount++};
+    // Now simulate the user selecting stuff
+    sendSelectionSetEvent(window);
+    selection.text = REPLACEMENT_TEXT;
+    test.assertEqual(1, callbackCount, "onSelect text listener works.");
+    //test.pass();
+    //test.done();
+  });
+
+  test.waitUntilDone(5000);
+};
+
+// testOnSelectExceptionNoBubble() requires nsIDOMWindowUtils, which is only
+// available in Firefox 3.7+.
+exports.testOnSelectExceptionNoBubble =
+  function testOnSelectTextSelection(test) {
+    let selection = require("sdk/selection");
+    primeTestCase(HTML_SINGLE, test, function(window, test) {
+      selection.onSelect = function() {
+        throw new Error("Exception thrown in testOnSelectExceptionNoBubble");
+      };
+      // Now simulate the user selecting stuff
+      sendSelectionSetEvent(window);
+      test.pass("onSelect catches exceptions.");
+    });
+
+    test.waitUntilDone(5000);
+};
+*/
+
+// If the module doesn't support the app we're being run in, require() will
+// throw.  In that case, remove all tests above from exports, and add one dummy
+// test that passes.
+try {
+  require("sdk/selection");
+}
+catch (err) {
+  // This bug should be mentioned in the error message.
+  let bug = "https://bugzilla.mozilla.org/show_bug.cgi?id=560716";
+  if (err.message.indexOf(bug) < 0)
+    throw err;
+
+  module.exports = {
+    testAppNotSupported: function (test) {
+      test.pass("the selection module does not support this application.");
+    }
+  }
+}