chrome/browser/resources/chromeos/chromevox/cvox2/background/output_test.extjs

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 GEN_INCLUDE(['../../testing/assert_additions.js']);
   6 GEN_INCLUDE(['../../testing/chromevox_next_e2e_test_base.js']);
   7
   8 /**
   9  * Gets the braille output and asserts that it matches expected values.
  10  * Annotations in the output that are primitive strings are ignored.
  11  */
  12 function checkBrailleOutput(expectedText, expectedSpans, output) {
  13   var actualOutput = output.brailleOutputForTest;
  14   // Remove string annotations.  These are tested in the speech output and
  15   // there's no need to clutter the tests with the corresponding braille
  16   // annotations.
  17   actualOutput.spans_ = actualOutput.spans_.filter(function(span) {
  18     return (typeof span.value !== 'string');
  19   });
  20   assertEqualsJSON({string_: expectedText, spans_: expectedSpans},
  21                    actualOutput);
  22 }
  23
  24 /**
  25  * Test fixture for output.js.
  26  * @constructor
  27  * @extends {ChromeVoxNextE2ETestBase}
  28  */
  29 function OutputE2ETest() {
  30   ChromeVoxNextE2ETest.call(this);
  31 }
  32
  33 OutputE2ETest.prototype = {
  34   __proto__: ChromeVoxNextE2ETest.prototype,
  35
  36   /** @override */
  37   setUp: function() {
  38     window.Dir = AutomationUtil.Dir;
  39   }
  40 };
  41
  42 TEST_F('OutputE2ETest', 'Links', function() {
  43   this.runWithLoadedTree('<a href="#">Click here</a>',
  44     function(root) {
  45       var el = root.firstChild.firstChild;
  46       var range = cursors.Range.fromNode(el);
  47       var o = new Output().withSpeechAndBraille(range, null, 'navigate');
  48       assertEqualsJSON({string_: 'Click here|Link', 'spans_': [
  49         // Attributes.
  50         {value: 'name', start: 0, end: 10},
  51
  52         // Link earcon (based on the name).
  53         {value: {earconId: 'LINK'}, start: 0, end: 10},
  54
  55         {value: 'role', start: 11, end: 15}
  56       ]}, o.speechOutputForTest);
  57       checkBrailleOutput('Click here lnk', [], o);
  58   });
  59 });
  60
  61 TEST_F('OutputE2ETest', 'Checkbox', function() {
  62   this.runWithLoadedTree('<input type="checkbox">',
  63     function(root) {
  64       var el = root.firstChild.firstChild;
  65       var range = cursors.Range.fromNode(el);
  66       var o = new Output().withSpeechAndBraille(range, null, 'navigate');
  67       assertEqualsJSON({string_: '|Check box|not checked', 'spans_': [
  68         // Attributes.
  69         {value: 'name', start: 0, end: 0},
  70         {value: 'role', start: 1, end: 10},
  71         {value: 'state', start: 11, end: 22},
  72
  73         // Checkbox earcon (based on the state).
  74         {value: {earconId: 'CHECK_OFF'}, start: 11, end: 22}
  75       ]}, o.speechOutputForTest);
  76       checkBrailleOutput('chk ( )', [], o);
  77   });
  78 });
  79
  80 TEST_F('OutputE2ETest', 'InLineTextBoxValueGetsIgnored', function() {
  81   this.runWithLoadedTree('<p>OK',
  82     function(root) {
  83       var el = root.firstChild.firstChild.firstChild;
  84       assertEquals('inlineTextBox', el.role);
  85       var range = cursors.Range.fromNode(el);
  86       var o = new Output().withSpeechAndBraille(range, null, 'navigate');
  87       assertEqualsJSON({string_: 'OK', 'spans_': [
  88         // Attributes.
  89         {value: 'name', start: 0, end: 2}
  90       ]}, o.speechOutputForTest);
  91       checkBrailleOutput('OK', [], o);
  92
  93       el = root.firstChild.firstChild;
  94       assertEquals('staticText', el.role);
  95       range = cursors.Range.fromNode(el);
  96       o = new Output().withSpeechAndBraille(range, null, 'navigate');
  97       assertEqualsJSON({string_: 'OK|', 'spans_': [
  98         // Attributes.
  99         {value: 'value', start: 0, end: 2},
 100
 101         // The name is an empty string.
 102         {value: 'name', start: 3, end: 3}
 103       ]}, o.speechOutputForTest);
 104       checkBrailleOutput('OK', [], o);
 105   });
 106 });
 107
 108 TEST_F('OutputE2ETest', 'Headings', function() {
 109   this.runWithLoadedTree(function() {/*!
 110       <h1>a</h1><h2>b</h2><h3>c</h3><h4>d</h4><h5>e</h5><h6>f</h6>
 111       <h1><a href="a.com">b</a></h1> */},
 112     function(root) {
 113       var el = root.firstChild;
 114       for (var i = 1; i <= 6; ++i) {
 115         var range = cursors.Range.fromNode(el);
 116         var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 117         var letter = String.fromCharCode('a'.charCodeAt(0) + i -1);
 118         assertEqualsJSON({string_: 'Heading ' + i + '|' + letter, 'spans_': [
 119           // Attributes.
 120           {value: 'nameOrDescendants', start: 10, end: 11}
 121         ]}, o.speechOutputForTest);
 122         checkBrailleOutput('h' + i + ' ' + letter, [], o);
 123         el = el.nextSibling;
 124       }
 125
 126       range = cursors.Range.fromNode(el);
 127       o = new Output().withSpeechAndBraille(range, null, 'navigate');
 128       assertEqualsJSON({string_: 'Heading 1|b|Link', 'spans_': [
 129         // Link.
 130         {value: 'name', start: 10, end: 11},
 131         {value: {earconId: "LINK"}, start: 10, end: 11},
 132         {value: 'role', start: 12, end: 16}
 133       ]}, o.speechOutputForTest);
 134       checkBrailleOutput('h1 b lnk', [], o);
 135   });
 136 });
 137
 138 TEST_F('OutputE2ETest', 'Audio', function() {
 139   this.runWithLoadedTree('<audio src="foo.mp3" controls></audio>',
 140     function(root) {
 141       var el = root.firstChild.firstChild.firstChild.firstChild;
 142       var range = cursors.Range.fromNode(el);
 143       var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 144       assertEqualsJSON(
 145           {string_: 'media control|Tool bar|||play|begin playback|Button',
 146            spans_:
 147               // Entered container toolbar.
 148
 149               // Button.
 150               [{value: 'name', start: 23, end: 23},
 151
 152               // Button earcon.
 153               {value: {earconId: "BUTTON"}, start: 23, end: 23},
 154
 155               {value: 'value', start: 24, end: 24},
 156               {value: 'description', start: 25, end: 29},
 157               {value: 'help', start: 30, end: 44},
 158               {value: 'role', start: 45, end: 51}]
 159           }, o.speechOutputForTest);
 160       checkBrailleOutput('media control tlbar play begin playback btn', [], o);
 161
 162       el = el.nextSibling;
 163       var prevRange = range;
 164       range = cursors.Range.fromNode(el);
 165       var o = new Output().withSpeechAndBraille(range, prevRange, 'navigate');
 166       assertEqualsJSON({string_: '0, , slider|audio time scrubber',
 167           spans_:
 168               [{value: 'help', start: 12, end: 31}]
 169           }, o.speechOutputForTest);
 170       // TODO(plundblad): Investigate this.
 171       checkBrailleOutput('0, , slider audio time scrubber', [], o);
 172   });
 173 });
 174
 175 TEST_F('OutputE2ETest', 'Input', function() {
 176   this.runWithLoadedTree(
 177       '<input type="text"></input>' +
 178       '<input type="email"></input>' +
 179       '<input type="password"></input>' +
 180       '<input type="tel"></input>'          +
 181       '<input type="number"></input>' +
 182       '<input type="time"></input>' +
 183       '<input type="date"></input>',
 184     function(root) {
 185       var expected = {string_: '', 'spans_': [
 186               {value: 'name', start: 0, end: 0},
 187
 188               // Earcon
 189               {value: {earconId: 'EDITABLE_TEXT'}, start: 0, end: 0},
 190
 191               // Selection span.
 192               {value: {startIndex: 0, endIndex: 0}, start: 1, end: 1},
 193
 194               {value: 'value', start: 1, end: 1}
 195       ]};
 196
 197       var expectedSpeechValues = [
 198         '||Edit text',
 199         '||Edit text, email entry',
 200         '||Password edit text',
 201         '||Edit text, number entry',
 202         {string_: '||Spin button', spans_: [{value: 'name', start: 0, end: 0},
 203             {value: {earconId:'LISTBOX'}, start: 0, end: 0},
 204             {value: {startIndex: 0, endIndex: 0}, start: 1, end: 1},
 205             {value: 'value', start: 1, end: 1},
 206             {value: 'role', start: 2, end: 13}]},
 207         {string_: '||Time control', spans_: [{value: 'name', start: 0, end: 0},
 208             {value: 'value', start: 1, end: 1},
 209             {value: 'role', start: 2, end: 14}]},
 210         {string_: '||Date control', spans_: [{value: 'name', start: 0, end: 0},
 211             {value: 'value', start: 1, end: 1},
 212             {value: 'role', start: 2, end: 14}]}
 213       ];
 214       // TODO(plundblad): Some of these are wrong, there should be an initial
 215       // space for the cursor in edit fields.
 216       var expectedBrailleValues = [
 217         'ed',
 218         '@ed',
 219         'pwded',
 220         '#ed',
 221         'spnbtn',
 222         {string_: 'time', spans_: []},
 223         {string_: 'date', spans_: []}
 224       ];
 225       assertEquals(expectedSpeechValues.length, expectedBrailleValues.length);
 226
 227       var el = root.firstChild.firstChild;
 228       expectedSpeechValues.forEach(function(expectedValue) {
 229         var range = cursors.Range.fromNode(el);
 230         var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 231         if (typeof expectedValue == 'object') {
 232           assertEqualsJSON(expectedValue, o.speechOutputForTest);
 233         } else {
 234           expected.string_ = expectedValue;
 235           assertEqualsJSON(expected, o.speechOutputForTest);
 236         }
 237         el = el.nextSibling;
 238       });
 239
 240       el = root.firstChild.firstChild;
 241       expectedBrailleValues.forEach(function(expectedValue) {
 242         var range = cursors.Range.fromNode(el);
 243         var o = new Output().withBraille(range, null, 'navigate');
 244         if (typeof expectedValue === 'string') {
 245           checkBrailleOutput(expectedValue,
 246                              [{'value': {'startIndex': 0, 'endIndex':0},
 247                                'start': 0,
 248                                'end': 0}], o);
 249         } else {
 250           checkBrailleOutput(expectedValue.string_, expectedValue.spans_, o);
 251         }
 252         el = el.nextSibling;
 253       });
 254   });
 255 });
 256
 257 TEST_F('OutputE2ETest', 'List', function() {
 258   this.runWithLoadedTree(
 259       '<ul><li>a<li>b<li>c</ul>',
 260     function(root) {
 261       var el = root.firstChild.firstChild;
 262       var range = cursors.Range.fromNode(el);
 263       var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 264       assertEqualsJSON({string_: 'list|with 3 items|a||List item', spans_: [
 265           {value: 'name', start: 18, end: 19},
 266           {value: {earconId:'LIST_ITEM'}, start: 18, end: 19},
 267           {value: 'value', start:20, end: 20},
 268           {value: 'role', start: 21, end: 30}
 269       ]}, o.speechOutputForTest);
 270       // TODO(0lundblad): This output is wrong.  Add special handling for
 271       // braille here.
 272       checkBrailleOutput('list + a lstitm', [], o);
 273   });
 274 });
 275
 276 TEST_F('OutputE2ETest', 'Tree', function() {
 277   this.runWithLoadedTree(function() {/*!
 278     <ul role="tree">
 279       <li aria-expanded="true" role="treeitem">a
 280       <li role="treeitem">b
 281       <li aria-expanded="false" role="treeitem">c
 282     </ul>
 283   */},
 284   function(root) {
 285     var el = root.firstChild.children[0].firstChild;
 286     var range = cursors.Range.fromNode(el);
 287     var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 288     assertEqualsJSON(
 289         {string_: '|Tree|with 3 items|Tree item|Expanded| 1 of 3 | level 1 |a|',
 290         spans_: [
 291           // Enter rule.
 292
 293           // TreeItem.
 294           {value: 'role','start': 19, end: 28},
 295           {value: 'state', start: 29, end: 37},
 296
 297           // InLineTextBox.
 298           {value: 'value', start: 57, end: 58},
 299           {value: 'name', start: 59, end: 59}
 300     ]}, o.speechOutputForTest);
 301     // TODO(plundblad): Braille output is wrong.
 302     checkBrailleOutput('tree + tritm - 1/3  level 1  a', [], o);
 303
 304     el = root.firstChild.children[1].firstChild;
 305     var range = cursors.Range.fromNode(el);
 306     var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 307     assertEqualsJSON(
 308         {string_: '|Tree|with 3 items|Tree item| 2 of 3 | level 1 |b|',
 309         spans_: [
 310           // Enter rule.
 311
 312           // TreeItem.
 313           {value: 'role','start': 19, end: 28},
 314
 315           // InLineTextBox.
 316           {value: 'value', start: 48, end: 49},
 317           {value: 'name', start: 50, end: 50}
 318     ]}, o.speechOutputForTest);
 319     // TODO(plundblad): Braille output is wrong.
 320     checkBrailleOutput('tree + tritm 2/3  level 1  b', [], o);
 321
 322     el = root.firstChild.children[2].firstChild;
 323     var range = cursors.Range.fromNode(el);
 324     var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 325     assertEqualsJSON(
 326         {string_: '|Tree|with 3 items|Tree item|Collapsed| 3 of 3 | level 1 |c|',
 327         spans_: [
 328           // Enter rule.
 329
 330           // TreeItem.
 331           {value: 'role','start': 19, end: 28},
 332           {value: 'state', start: 29, end: 38},
 333
 334           // InLineTextBox.
 335           {value: 'value', start: 58, end: 59},
 336           {value: 'name', start: 60, end: 60}
 337     ]}, o.speechOutputForTest);
 338     // TODO(plundblad): Braille output is wrong.
 339     checkBrailleOutput('tree + tritm + 3/3  level 1  c', [], o);
 340   });
 341 });
 342
 343 TEST_F('OutputE2ETest', 'Menu', function() {
 344   this.runWithLoadedTree(function() {/*!
 345     <div role="menu">
 346       <div role="menuitem">a</div>
 347     </div>
 348   */},
 349   function(root) {
 350     var el = root.firstChild.firstChild;
 351     var range = cursors.Range.fromNode(el);
 352     var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 353     assertEqualsJSON({string_:
 354             '|Menu|with 1 item|a|Menu item| 1 of 1 ', spans_: [
 355         {value: 'name', start: 18, end: 19},
 356         {value: 'role', start:20, end: 29}
 357     ]}, o.speechOutputForTest);
 358     checkBrailleOutput('mnu + a mnuitm 1/1', [], o);
 359   });
 360 });
 361
 362 TEST_F('OutputE2ETest', 'ListBox', function() {
 363   this.runWithLoadedTree(function() {/*!
 364     <select multiple>
 365       <option>1</option>
 366       <option>2</option>
 367     </select>
 368   */},
 369   function(root) {
 370     var el = root.firstChild.firstChild.firstChild;
 371     var range = cursors.Range.fromNode(el);
 372     var o = new Output().withSpeechAndBraille(range, null, 'navigate');
 373     assertEqualsJSON({string_: '|List box|with 2 items||List item| 1 of 2 ',
 374         spans_: [
 375           // ListBox.
 376           // Earcon.
 377           {value: {earconId:'LISTBOX'}, start: 0, end: 0},
 378
 379           {value: 'name', start: 23, end: 23},
 380
 381           // Earcon.
 382           {value: {earconId: 'LIST_ITEM'}, start: 23, end: 23},
 383
 384           {value: 'role', start:24, end: 33}
 385     ]}, o.speechOutputForTest);
 386     checkBrailleOutput('lstbx + lstitm 1/2', [], o);
 387   });
 388 });
 389
 390 SYNC_TEST_F('OutputE2ETest', 'MessageIdAndEarconValidity', function() {
 391   for (var key in Output.ROLE_INFO_) {
 392     var value = Output.ROLE_INFO_[key];
 393     cvox.ChromeVox.msgs.getMsg(value.msgId);
 394     cvox.ChromeVox.msgs.getMsg(value.msgId + '_brl');
 395     assertFalse(/[A-Z]+/.test(value.msgId));
 396     if (value.earconId)
 397       assertNotNullNorUndefined(cvox.AbstractEarcons[value.earconId]);
 398   }
 399   for (var key in Output.STATE_INFO_) {
 400     var value = Output.STATE_INFO_[key];
 401     for (innerKey in value) {
 402       var innerValue = value[innerKey];
 403       cvox.ChromeVox.msgs.getMsg(innerValue.msgId);
 404       cvox.ChromeVox.msgs.getMsg(innerValue.msgId + '_brl');
 405       assertFalse(/[A-Z]+/.test(innerValue.msgId));
 406       if (innerValue.earconId)
 407         assertNotNullNorUndefined(cvox.AbstractEarcons[innerValue.earconId]);
 408     }
 409   }
 410 });