Complete live region support in ChromeVox Next.

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

 // Copyright 2015 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.
 
 /**
  * @fileoverview This file contains the |MockFeedback| class which is
  * a combined mock class for speech, braille, and earcon feedback.  A
  * test that uses this class may add expectations for speech
  * utterances, braille display content to be output, and earcons
  * played (by name).  The |install| method sets appropriate mock
@@ skipping 142 matching lines @@
           return !!MockFeedback.matchAndConsume_(
               text, {}, this.pendingUtterances_);
         }.bind(this),
         toString: function() { return 'Speak \'' + text + '\''; }
       });
     }.bind(this));
     return this;
   },
 
   /**
+   * Adds an expectation for one spoken utterance that will be enqueued
+   *     with a given queue mode.
+   * @param {string|RegExp} text One utterance expectation.
+   * @param {cvox.QueueMode} queueMode The expected queue mode.
+   * @return {MockFeedback} |this| for chaining
+   */
+  expectSpeechWithQueueMode: function(text, queueMode) {
+    assertFalse(this.replaying_);
+    this.pendingActions_.push({
+      perform: function() {
+        return !!MockFeedback.matchAndConsume_(
+            text, {queueMode: queueMode}, this.pendingUtterances_);
+        }.bind(this),
+      toString: function() {
+        return 'Speak \'' + text + '\' with mode ' + queueMode;
+      }
+    });
+    return this;
+  },
+
+  /**
+   * Adds an expectation for one spoken utterance that will be queued.
+   * @param {string|RegExp} text One utterance expectation.
+   * @return {MockFeedback} |this| for chaining
+   */
+  expectQueue: function(text) {

[Peter Lundblad, 2015/11/20 13:42:58]

expectQueuedSpeech?

[dmazzoni, 2015/11/23 20:16:50]

Done.

+    return this.expectSpeechWithQueueMode(text, cvox.QueueMode.QUEUE);
+  },
+
+  /**
+   * Adds an expectation for one spoken utterance that will be flushed.
+   * @param {string|RegExp} text One utterance expectation.
+   * @return {MockFeedback} |this| for chaining
+   */
+  expectFlush: function(text) {

[Peter Lundblad, 2015/11/20 13:42:59]

expectFlushingSpeech?

[dmazzoni, 2015/11/23 20:16:50]

Done.

+    return this.expectSpeechWithQueueMode(text, cvox.QueueMode.FLUSH);
+  },
+
+  /**
+   * Adds an expectation for one spoken utterance that will be queued
+   *     with the category flush mode.
+   * @param {string|RegExp} text One utterance expectation.
+   * @return {MockFeedback} |this| for chaining
+   */
+  expectCategoryFlush: function(text) {

[Peter Lundblad, 2015/11/20 13:42:58]

expectCategoryFlushSpeech?

[dmazzoni, 2015/11/23 20:16:50]

Done.

+    return this.expectSpeechWithQueueMode(text, cvox.QueueMode.CATEGORY_FLUSH);
+  },
+
+  /**
    * Adds an expectation that the next spoken utterances do *not* match
    * the given arguments.
    *
    * This is only guaranteed to work for the immediately following utterance.
    * If you use it to check an utterance other than the immediately following
    * one the results may be flaky.
    *
    * @param {...(string|RegExp)} var_args One or more utterance to add as
    *     negative expectations.
    * @return {MockFeedback} |this| for chaining
@@ skipping 119 matching lines @@
     if (properties && (properties.startCallback || properties.endCallback)) {
       var startCallback = properties.startCallback;
       var endCallback = properties.endCallback;
       callback = function() {
         startCallback && startCallback();
         endCallback && endCallback();
       };
     }
     this.pendingUtterances_.push(
         {text: textString,
+         queueMode: queueMode,
          callback: callback});
     this.process_();
   },
 
   /** @private */
   addBraille_: function(navBraille) {
     this.pendingBraille_.push(navBraille);
     this.process_();
   },
 
@@ skipping 91 matching lines @@
   }
   if (candidate) {
     var consumed = pending.splice(0, i + 1);
     consumed.forEach(function(item) {
       if (item.callback)
         item.callback();
     });
   }
   return candidate;
 };