Implement auto read on load complete

chrome/browser/resources/chromeos/chromevox/cvox2/background/desktop_automation_handler.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 Handles automation from a desktop automation node.
  */
 
 goog.provide('DesktopAutomationHandler');
 
@@ skipping 279 matching lines @@
   onLoadComplete: function(evt) {
     chrome.automation.getFocus(function(focus) {
       if (!focus || !AutomationUtil.isDescendantOf(focus, evt.target))
         return;
 
       // Create text edit handler, if needed, now in order not to miss initial
       // value change if text field has already been focused when initializing
       // ChromeVox.
       this.createTextEditHandlerIfNeeded_(focus);
 
+      // If auto read is set, skip focus recovery and start reading from the top.

[dmazzoni, 2016/12/15 17:07:02]

Have you considered doing auto-read only if there's no focus to recover?

I could be wrong but I think JAWS might do something more nuanced, because
for a simple document it reads from the top, but on apps with autofocus it
jumps right there, and I think it may be smart about reloads too.

I'm thinking good options would be:

Read the page when it finishes loading:
[ ] Never
[ ] Only the first time and when nothing has focus
[ ] Always

+      if (localStorage['autoRead'] == 'true' &&
+          AutomationUtil.getTopLevelRoot(evt.target) == evt.target) {
+        ChromeVoxState.instance.setCurrentRange(cursors.Range.fromNode(evt.target));
+        cvox.ChromeVox.tts.stop();
+        CommandHandler.onCommand('readFromHere');
+        return;
+      }
+
       // If initial focus was already placed on this page (e.g. if a user starts
       // tabbing before load complete), then don't move ChromeVox's position on
       // the page.
       if (ChromeVoxState.instance.currentRange &&
           ChromeVoxState.instance.currentRange.start.node.root == focus.root)
         return;
 
       var o = new Output();
       if (focus.role == RoleType.rootWebArea) {
         // Restore to previous position.
@@ skipping 208 matching lines @@
 DesktopAutomationHandler.init_ = function() {
   chrome.automation.getDesktop(function(desktop) {
     ChromeVoxState.desktopAutomationHandler =
         new DesktopAutomationHandler(desktop);
   });
 };
 
 DesktopAutomationHandler.init_();
 
 });  // goog.scope