/** * Copyright 2018 Google Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ module.exports.addTests = function({testRunner, expect}) { const {describe, xdescribe, fdescribe} = testRunner; const {it, fit, xit} = testRunner; const {beforeAll, beforeEach, afterAll, afterEach} = testRunner; describe('Accessibility', function() { it('should work', async function({page}) { await page.setContent(` Accessibility Test
Hello World

Inputs

`); expect(await page.accessibility.snapshot()).toEqual({ role: 'WebArea', name: 'Accessibility Test', children: [ {role: 'text', name: 'Hello World'}, {role: 'heading', name: 'Inputs', level: 1}, {role: 'textbox', name: 'Empty input', focused: true}, {role: 'textbox', name: 'readonly input', readonly: true}, {role: 'textbox', name: 'disabled input', disabled: true}, {role: 'textbox', name: 'Input with whitespace', value: ' '}, {role: 'textbox', name: '', value: 'value only'}, {role: 'textbox', name: 'placeholder', value: 'and a value'}, {role: 'textbox', name: 'placeholder', value: 'and a value', description: 'This is a description!'}, {role: 'combobox', name: '', value: 'First Option', children: [ {role: 'menuitem', name: 'First Option', selected: true}, {role: 'menuitem', name: 'Second Option'}]}] }); }); it('should report uninteresting nodes', async function({page}) { await page.setContent(``); expect(findFocusedNode(await page.accessibility.snapshot({interestingOnly: false}))).toEqual({ role: 'textbox', name: '', value: 'hi', focused: true, multiline: true, children: [{ role: 'GenericContainer', name: '', children: [{ role: 'text', name: 'hi' }] }] }); }); describe('filtering children of leaf nodes', function() { it('should not report text nodes inside controls', async function({page}) { await page.setContent(`
Tab1
Tab2
`); expect(await page.accessibility.snapshot()).toEqual({ role: 'WebArea', name: '', children: [{ role: 'tab', name: 'Tab1', selected: true }, { role: 'tab', name: 'Tab2' }] }); }); it('rich text editable fields should have children', async function({page}) { await page.setContent(`
Edit this image: my fake image
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'GenericContainer', name: '', value: 'Edit this image: ', children: [{ role: 'text', name: 'Edit this image:' }, { role: 'img', name: 'my fake image' }] }); }); it('rich text editable fields with role should have children', async function({page}) { await page.setContent(`
Edit this image: my fake image
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'textbox', name: '', value: 'Edit this image: ', children: [{ role: 'text', name: 'Edit this image:' }, { role: 'img', name: 'my fake image' }] }); }); it('plain text field with role should not have children', async function({page}) { await page.setContent(`
Edit this image:my fake image
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'textbox', name: '', value: 'Edit this image:' }); }); it('plain text field without role should not have content', async function({page}) { await page.setContent(`
Edit this image:my fake image
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'GenericContainer', name: '' }); }); it('plain text field with tabindex and without role should not have content', async function({page}) { await page.setContent(`
Edit this image:my fake image
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'GenericContainer', name: '' }); }); it('non editable textbox with role and tabIndex and label should not have children', async function({page}) { await page.setContent(`
this is the inner content yo
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'textbox', name: 'my favorite textbox', value: 'this is the inner content ' }); }); it('checkbox with and tabIndex and label should not have children', async function({page}) { await page.setContent(`
this is the inner content yo
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'checkbox', name: 'my favorite checkbox', checked: true }); }); it('checkbox without label should not have children', async function({page}) { await page.setContent(`
this is the inner content yo
`); const snapshot = await page.accessibility.snapshot(); expect(snapshot.children[0]).toEqual({ role: 'checkbox', name: 'this is the inner content yo', checked: true }); }); }); function findFocusedNode(node) { if (node.focused) return node; for (const child of node.children || []) { const focusedChild = findFocusedNode(child); if (focusedChild) return focusedChild; } return null; } }); };