Debian Codegraph @

closure-library/closure/goog/a11y/aria/aria_test.js

raw
1 // Copyright 2008 The Closure Library Authors. All Rights Reserved.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS-IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.goog.provide('goog.a11y.ariaTest');
14
15 goog.provide('goog.a11y.ariaTest');
16 goog.setTestOnly('goog.a11y.ariaTest');
17
18 goog.require('goog.a11y.aria');
19 goog.require('goog.a11y.aria.Role');
20 goog.require('goog.a11y.aria.State');
21 goog.require('goog.dom');
22 goog.require('goog.dom.TagName');
23 goog.require('goog.testing.jsunit');
24
25 var aria = goog.a11y.aria;
26 var Role = goog.a11y.aria.Role;
27 var State = goog.a11y.aria.State;
28 var sandbox;
29 var someDiv;
30 var someSpan;
31 var htmlButton;
32
33 function setUp() {
34 sandbox = goog.dom.getElement('sandbox');
35 someDiv = goog.dom.createDom(goog.dom.TagName.DIV, {id: 'someDiv'}, 'DIV');
36 someSpan =
37 goog.dom.createDom(goog.dom.TagName.SPAN, {id: 'someSpan'}, 'SPAN');
38 htmlButton =
39 goog.dom.createDom(goog.dom.TagName.BUTTON, {id: 'someButton'}, 'BUTTON');
40 goog.dom.appendChild(sandbox, someDiv);
41 goog.dom.appendChild(someDiv, someSpan);
42 }
43
44 function tearDown() {
45 goog.dom.removeChildren(sandbox);
46 someDiv = null;
47 someSpan = null;
48 htmlButton = null;
49 }
50
51 function testGetSetRole() {
52 assertNull('someDiv\'s role should be null', aria.getRole(someDiv));
53 assertNull('someSpan\'s role should be null', aria.getRole(someSpan));
54
55 aria.setRole(someDiv, Role.MENU);
56 aria.setRole(someSpan, Role.MENU_ITEM);
57
58 assertEquals(
59 'someDiv\'s role should be MENU', Role.MENU, aria.getRole(someDiv));
60 assertEquals(
61 'someSpan\'s role should be MENU_ITEM', Role.MENU_ITEM,
62 aria.getRole(someSpan));
63
64 var div = goog.dom.createElement(goog.dom.TagName.DIV);
65 goog.dom.appendChild(sandbox, div);
66 goog.dom.appendChild(
67 div,
68 goog.dom.createDom(
69 goog.dom.TagName.SPAN, {id: 'anotherSpan', role: Role.CHECKBOX}));
70 assertEquals(
71 'anotherSpan\'s role should be CHECKBOX', Role.CHECKBOX,
72 aria.getRole(goog.dom.getElement('anotherSpan')));
73 }
74
75 function testGetSetToggleState() {
76 assertThrows('Should throw because no state is specified.', function() {
77 aria.getState(someDiv);
78 });
79 assertThrows('Should throw because no state is specified.', function() {
80 aria.getState(someDiv);
81 });
82 aria.setState(someDiv, State.LABELLEDBY, 'someSpan');
83
84 assertEquals(
85 'someDiv\'s labelledby state should be "someSpan"', 'someSpan',
86 aria.getState(someDiv, State.LABELLEDBY));
87
88 // Test setting for aria-activedescendant with empty value.
89 assertFalse(
90 someDiv.hasAttribute ? someDiv.hasAttribute('aria-activedescendant') :
91 !!someDiv.getAttribute('aria-activedescendant'));
92 aria.setState(someDiv, State.ACTIVEDESCENDANT, 'someSpan');
93 assertEquals('someSpan', aria.getState(someDiv, State.ACTIVEDESCENDANT));
94 aria.setState(someDiv, State.ACTIVEDESCENDANT, '');
95 assertFalse(
96 someDiv.hasAttribute ? someDiv.hasAttribute('aria-activedescendant') :
97 !!someDiv.getAttribute('aria-activedescendant'));
98
99 // Test setting state that has a default value to empty value.
100 assertFalse(
101 someDiv.hasAttribute ? someDiv.hasAttribute('aria-relevant') :
102 !!someDiv.getAttribute('aria-relevant'));
103 aria.setState(someDiv, State.RELEVANT, aria.RelevantValues.TEXT);
104 assertEquals(
105 aria.RelevantValues.TEXT, aria.getState(someDiv, State.RELEVANT));
106 aria.setState(someDiv, State.RELEVANT, '');
107 assertEquals(
108 aria.RelevantValues.ADDITIONS + ' ' + aria.RelevantValues.TEXT,
109 aria.getState(someDiv, State.RELEVANT));
110
111 // Test toggling an attribute that has a true/false value.
112 aria.setState(someDiv, State.EXPANDED, false);
113 assertEquals('false', aria.getState(someDiv, State.EXPANDED));
114 aria.toggleState(someDiv, State.EXPANDED);
115 assertEquals('true', aria.getState(someDiv, State.EXPANDED));
116 aria.setState(someDiv, State.EXPANDED, true);
117 assertEquals('true', aria.getState(someDiv, State.EXPANDED));
118 aria.toggleState(someDiv, State.EXPANDED);
119 assertEquals('false', aria.getState(someDiv, State.EXPANDED));
120
121 // Test toggling an attribute that does not have a true/false value.
122 aria.setState(someDiv, State.RELEVANT, aria.RelevantValues.TEXT);
123 assertEquals(
124 aria.RelevantValues.TEXT, aria.getState(someDiv, State.RELEVANT));
125 aria.toggleState(someDiv, State.RELEVANT);
126 assertEquals('', aria.getState(someDiv, State.RELEVANT));
127 aria.removeState(someDiv, State.RELEVANT);
128 assertEquals('', aria.getState(someDiv, State.RELEVANT));
129 // This is not a valid value, but this is what happens if toggle is misused.
130 aria.toggleState(someDiv, State.RELEVANT);
131 assertEquals('true', aria.getState(someDiv, State.RELEVANT));
132 }
133
134 function testGetStateString() {
135 aria.setState(someDiv, State.LABEL, 'test_label');
136 aria.setState(
137 someSpan, State.LABEL, aria.getStateString(someDiv, State.LABEL));
138 assertEquals(
139 aria.getState(someDiv, State.LABEL),
140 aria.getState(someSpan, State.LABEL));
141 assertEquals(
142 'The someDiv\'s enum value should be "test_label".', 'test_label',
143 aria.getState(someDiv, State.LABEL));
144 assertEquals(
145 'The someSpan\'s enum value should be "copy move".', 'test_label',
146 aria.getStateString(someSpan, State.LABEL));
147 someDiv.setAttribute('aria-label', '');
148 assertEquals(null, aria.getStateString(someDiv, State.LABEL));
149 aria.setState(someDiv, State.MULTILINE, true);
150 var thrown = false;
151 try {
152 aria.getStateString(someDiv, State.MULTILINE);
153 } catch (e) {
154 thrown = true;
155 }
156 assertTrue('invalid use of getStateString on boolean.', thrown);
157 aria.setState(someDiv, State.LIVE, aria.LivePriority.ASSERTIVE);
158 thrown = false;
159 aria.setState(someDiv, State.LEVEL, 1);
160 try {
161 aria.getStateString(someDiv, State.LEVEL);
162 } catch (e) {
163 thrown = true;
164 }
165 assertTrue('invalid use of getStateString on numbers.', thrown);
166 }
167
168
169 function testGetStateStringArray() {
170 aria.setState(someDiv, State.LABELLEDBY, ['1', '2']);
171 aria.setState(
172 someSpan, State.LABELLEDBY,
173 aria.getStringArrayStateInternalUtil(someDiv, State.LABELLEDBY));
174 assertEquals(
175 aria.getState(someDiv, State.LABELLEDBY),
176 aria.getState(someSpan, State.LABELLEDBY));
177
178 assertEquals(
179 'The someDiv\'s enum value should be "1 2".', '1 2',
180 aria.getState(someDiv, State.LABELLEDBY));
181 assertEquals(
182 'The someSpan\'s enum value should be "1 2".', '1 2',
183 aria.getState(someSpan, State.LABELLEDBY));
184
185 assertSameElements(
186 'The someDiv\'s enum value should be "1 2".', ['1', '2'],
187 aria.getStringArrayStateInternalUtil(someDiv, State.LABELLEDBY));
188 assertSameElements(
189 'The someSpan\'s enum value should be "1 2".', ['1', '2'],
190 aria.getStringArrayStateInternalUtil(someSpan, State.LABELLEDBY));
191 }
192
193
194 function testGetStateNumber() {
195 aria.setState(someDiv, State.LEVEL, 1);
196 aria.setState(
197 someSpan, State.LEVEL, aria.getStateNumber(someDiv, State.LEVEL));
198 assertEquals(
199 aria.getState(someDiv, State.LEVEL),
200 aria.getState(someSpan, State.LEVEL));
201 assertEquals(
202 'The someDiv\'s enum value should be "1".', '1',
203 aria.getState(someDiv, State.LEVEL));
204 assertEquals(
205 'The someSpan\'s enum value should be "1".', '1',
206 aria.getState(someSpan, State.LEVEL));
207 assertEquals(
208 'The someDiv\'s enum value should be "1".', 1,
209 aria.getStateNumber(someDiv, State.LEVEL));
210 assertEquals(
211 'The someSpan\'s enum value should be "1".', 1,
212 aria.getStateNumber(someSpan, State.LEVEL));
213 aria.setState(someDiv, State.MULTILINE, true);
214 var thrown = false;
215 try {
216 aria.getStateNumber(someDiv, State.MULTILINE);
217 } catch (e) {
218 thrown = true;
219 }
220 assertTrue('invalid use of getStateNumber on boolean.', thrown);
221 aria.setState(someDiv, State.LIVE, aria.LivePriority.ASSERTIVE);
222 thrown = false;
223 try {
224 aria.getStateBoolean(someDiv, State.LIVE);
225 } catch (e) {
226 thrown = true;
227 }
228 assertTrue('invalid use of getStateNumber on strings.', thrown);
229 }
230
231 function testGetStateBoolean() {
232 assertNull(aria.getStateBoolean(someDiv, State.MULTILINE));
233
234 aria.setState(someDiv, State.MULTILINE, false);
235 assertFalse(aria.getStateBoolean(someDiv, State.MULTILINE));
236
237 aria.setState(someDiv, State.MULTILINE, true);
238 aria.setState(
239 someSpan, State.MULTILINE,
240 aria.getStateBoolean(someDiv, State.MULTILINE));
241 assertEquals(
242 aria.getState(someDiv, State.MULTILINE),
243 aria.getState(someSpan, State.MULTILINE));
244 assertEquals(
245 'The someDiv\'s enum value should be "true".', 'true',
246 aria.getState(someDiv, State.MULTILINE));
247 assertEquals(
248 'The someSpan\'s enum value should be "true".', 'true',
249 aria.getState(someSpan, State.MULTILINE));
250 assertEquals(
251 'The someDiv\'s enum value should be "true".', true,
252 aria.getStateBoolean(someDiv, State.MULTILINE));
253 assertEquals(
254 'The someSpan\'s enum value should be "true".', true,
255 aria.getStateBoolean(someSpan, State.MULTILINE));
256 aria.setState(someDiv, State.LEVEL, 1);
257 var thrown = false;
258 try {
259 aria.getStateBoolean(someDiv, State.LEVEL);
260 } catch (e) {
261 thrown = true;
262 }
263 assertTrue('invalid use of getStateBoolean on numbers.', thrown);
264 aria.setState(someDiv, State.LIVE, aria.LivePriority.ASSERTIVE);
265 thrown = false;
266 try {
267 aria.getStateBoolean(someDiv, State.LIVE);
268 } catch (e) {
269 thrown = true;
270 }
271 assertTrue('invalid use of getStateBoolean on strings.', thrown);
272 }
273
274 function testGetSetActiveDescendant() {
275 aria.setActiveDescendant(someDiv, null);
276 assertNull(
277 'someDiv\'s activedescendant should be null',
278 aria.getActiveDescendant(someDiv));
279
280 aria.setActiveDescendant(someDiv, someSpan);
281
282 assertEquals(
283 'someDiv\'s active descendant should be "someSpan"', someSpan,
284 aria.getActiveDescendant(someDiv));
285 }
286
287 function testGetSetLabel() {
288 assertEquals('someDiv\'s label should be ""', '', aria.getLabel(someDiv));
289
290 aria.setLabel(someDiv, 'somelabel');
291 assertEquals(
292 'someDiv\'s label should be "somelabel"', 'somelabel',
293 aria.getLabel(someDiv));
294 }
295
296 function testHasState() {
297 aria.setState(someDiv, State.EXPANDED, false);
298 assertTrue(aria.hasState(someDiv, State.EXPANDED));
299 aria.removeState(someDiv, State.EXPANDED);
300 assertFalse(aria.hasState(someDiv, State.EXPANDED));
301 }