Port event watcher ChromeVox tests.

chrome/browser/resources/chromeos/chromevox/testing/chromevox_unittest_base.js

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 GEN_INCLUDE([
     'chrome/browser/resources/chromeos/chromevox/testing/assert_additions.js']);
 
 /**
  * Shortcut for document.getElementById.
  * @param {string} id of the element.
@@ skipping 123 matching lines @@
     var me = this;
     var calmArguments = Array.prototype.slice.call(arguments);
     calmArguments.shift();
     cvox.ChromeVoxEventWatcher.addReadyCallback(function() {
       func.apply(me, calmArguments);
     });
     return this; // for chaining.
   },
 
   /**
+   * Asserts the TTS engine spoken a certain string. Clears the TTS buffer.

[Peter Lundblad, 2014/09/23 09:40:01]

nit: grammar seems odd to this non-native speaker.

[dmazzoni, 2014/09/23 18:02:41]

Done.

+   * @param {string} expectedText The expected text.
+   * @return {cvox.TestCaseClass} this.

[Peter Lundblad, 2014/09/23 09:40:01]

nit: Type should be ChromeVoxUnitTestBase.

[dmazzoni, 2014/09/23 18:02:40]

Done.

+   */
+  assertSpoken: function(expectedText) {
+    assertEquals(expectedText,
+                 cvox.ChromeVoxTester.testTts().getUtterancesAsString());
+    cvox.ChromeVoxTester.clearUtterances();
+    return this; // for chaining.
+  },
+
+  /**
    * Asserts a list of utterances are in the correct queue mode.
    * @param {cvox.SpokenListBuilder|Array} expectedList A list
    *     of [text, queueMode] tuples OR a SpokenListBuilder with the expected
    *     utterances.
    * @return {ChromeVoxUnitTestBase} this.
    */
   assertSpokenList: function(expectedList) {
     if (expectedList instanceof cvox.SpokenListBuilder) {
       expectedList = expectedList.build();
     }
 
     var ulist = cvox.ChromeVoxTester.testTts().getUtteranceInfoList();
     for (var i = 0; i < expectedList.length; i++) {
       var text = expectedList[i][0];
       var queueMode = expectedList[i][1];
       this.assertSingleUtterance_(text, queueMode,
                                   ulist[i].text, ulist[i].queueMode);
     }
     cvox.ChromeVoxTester.clearUtterances();
     return this; // for chaining.
   },
 
   assertSingleUtterance_: function(
       expectedText, expectedQueueMode, text, queueMode) {
     assertEquals(expectedQueueMode, queueMode);
     assertEquals(expectedText, text);
+  },
+
+  /**
+   * Focuses an element.
+   * @param {string} eltName The name of the element to focus.

[Peter Lundblad, 2014/09/23 09:40:01]

Shouldn't this be the id of the element, not the name?

[dmazzoni, 2014/09/23 18:02:40]

Done.

+   * @return {ChromeVoxUnitTestBase} this.
+   */
+  setFocus: function(eltName) {
+    $(eltName).focus();
+    return this; // for chaining.
+  },
+
+  /**
+   * Executes a ChromeVox user command.
+   * @param {string} command The name of the command to run.
+   * @return {ChromeVoxUnitTestBase} this.
+   */
+  userCommand: function(command) {
+    cvox.ChromeVoxUserCommands.commands[command]();

[Peter Lundblad, 2014/09/23 09:40:00]

You should add cvox.ChromeVoxUserCommands to the closure dependency list and
make sure all tests that currently set that list append to it (or move the
utility to the test that needs it).

[dmazzoni, 2014/09/23 18:02:41]

Done.

+    return this; // for chaining.
+  },
+
+  /**
+   * @return {cvox.SpokenListBuilder} A new builder.
+   */
+  spokenList: function() {

[Peter Lundblad, 2014/09/23 09:40:00]

This also has an undeclared dependency, but I'd just get rid of this overly
trivial function.

[dmazzoni, 2014/09/23 18:02:41]

It's useful for chaining and will make porting other tests easier, so I'd prefer
to leave it and fix the dependency.

+    return new cvox.SpokenListBuilder();
   }
 };