@afixt/test-utils 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/.claude/settings.local.json +4 -1
  2. package/CLAUDE.md +12 -0
  3. package/package.json +1 -1
  4. package/src/domUtils.js +1 -1
  5. package/src/getAccessibleName.js +8 -4
  6. package/src/getFocusableElements.js +13 -4
  7. package/test/domUtils.test.js +117 -0
  8. package/test/getAccessibleName.test.js +182 -0
  9. package/test/getAccessibleText.test.js +350 -79
  10. package/test/getCSSGeneratedContent.test.js +175 -1
  11. package/test/getFocusableElements.test.js +106 -35
  12. package/test/getImageText.test.js +61 -12
  13. package/test/hasParent.test.js +116 -0
  14. package/test/index.test.js +165 -0
  15. package/test/interactiveRoles.test.js +60 -0
  16. package/test/isAriaAttributesValid.test.js +36 -0
  17. package/test/isDataTable.test.js +492 -0
  18. package/test/isValidUrl.test.js +31 -19
  19. package/test/stringUtils.test.js +235 -1
  20. package/test/testContrast.test.js +176 -8
  21. package/test/testOrder.integration.test.js +369 -0
  22. package/test/testOrder.test.js +756 -21
  23. package/todo.md +150 -1
  24. package/coverage/base.css +0 -224
  25. package/coverage/block-navigation.js +0 -87
  26. package/coverage/coverage-final.json +0 -51
  27. package/coverage/favicon.png +0 -0
  28. package/coverage/index.html +0 -161
  29. package/coverage/prettify.css +0 -1
  30. package/coverage/prettify.js +0 -2
  31. package/coverage/sort-arrow-sprite.png +0 -0
  32. package/coverage/sorter.js +0 -196
  33. package/coverage/test-utils/docs/scripts/core.js.html +0 -2263
  34. package/coverage/test-utils/docs/scripts/core.min.js.html +0 -151
  35. package/coverage/test-utils/docs/scripts/index.html +0 -176
  36. package/coverage/test-utils/docs/scripts/resize.js.html +0 -355
  37. package/coverage/test-utils/docs/scripts/search.js.html +0 -880
  38. package/coverage/test-utils/docs/scripts/search.min.js.html +0 -100
  39. package/coverage/test-utils/docs/scripts/third-party/fuse.js.html +0 -109
  40. package/coverage/test-utils/docs/scripts/third-party/hljs-line-num-original.js.html +0 -1192
  41. package/coverage/test-utils/docs/scripts/third-party/hljs-line-num.js.html +0 -85
  42. package/coverage/test-utils/docs/scripts/third-party/hljs-original.js.html +0 -15598
  43. package/coverage/test-utils/docs/scripts/third-party/hljs.js.html +0 -85
  44. package/coverage/test-utils/docs/scripts/third-party/index.html +0 -236
  45. package/coverage/test-utils/docs/scripts/third-party/popper.js.html +0 -100
  46. package/coverage/test-utils/docs/scripts/third-party/tippy.js.html +0 -88
  47. package/coverage/test-utils/docs/scripts/third-party/tocbot.js.html +0 -2098
  48. package/coverage/test-utils/docs/scripts/third-party/tocbot.min.js.html +0 -85
  49. package/coverage/test-utils/index.html +0 -131
  50. package/coverage/test-utils/src/arrayUtils.js.html +0 -283
  51. package/coverage/test-utils/src/domUtils.js.html +0 -622
  52. package/coverage/test-utils/src/getAccessibleName.js.html +0 -1444
  53. package/coverage/test-utils/src/getAccessibleText.js.html +0 -271
  54. package/coverage/test-utils/src/getAriaAttributesByElement.js.html +0 -142
  55. package/coverage/test-utils/src/getCSSGeneratedContent.js.html +0 -265
  56. package/coverage/test-utils/src/getComputedRole.js.html +0 -592
  57. package/coverage/test-utils/src/getFocusableElements.js.html +0 -163
  58. package/coverage/test-utils/src/getGeneratedContent.js.html +0 -130
  59. package/coverage/test-utils/src/getImageText.js.html +0 -160
  60. package/coverage/test-utils/src/getStyleObject.js.html +0 -220
  61. package/coverage/test-utils/src/hasAccessibleName.js.html +0 -166
  62. package/coverage/test-utils/src/hasAttribute.js.html +0 -130
  63. package/coverage/test-utils/src/hasCSSGeneratedContent.js.html +0 -145
  64. package/coverage/test-utils/src/hasHiddenParent.js.html +0 -172
  65. package/coverage/test-utils/src/hasParent.js.html +0 -247
  66. package/coverage/test-utils/src/hasValidAriaAttributes.js.html +0 -175
  67. package/coverage/test-utils/src/hasValidAriaRole.js.html +0 -172
  68. package/coverage/test-utils/src/index.html +0 -611
  69. package/coverage/test-utils/src/index.js.html +0 -274
  70. package/coverage/test-utils/src/interactiveRoles.js.html +0 -145
  71. package/coverage/test-utils/src/isAriaAttributesValid.js.html +0 -304
  72. package/coverage/test-utils/src/isComplexTable.js.html +0 -412
  73. package/coverage/test-utils/src/isDataTable.js.html +0 -799
  74. package/coverage/test-utils/src/isFocusable.js.html +0 -187
  75. package/coverage/test-utils/src/isHidden.js.html +0 -136
  76. package/coverage/test-utils/src/isOffScreen.js.html +0 -133
  77. package/coverage/test-utils/src/isValidUrl.js.html +0 -124
  78. package/coverage/test-utils/src/isVisible.js.html +0 -271
  79. package/coverage/test-utils/src/listEventListeners.js.html +0 -370
  80. package/coverage/test-utils/src/queryCache.js.html +0 -1156
  81. package/coverage/test-utils/src/stringUtils.js.html +0 -535
  82. package/coverage/test-utils/src/testContrast.js.html +0 -784
  83. package/coverage/test-utils/src/testLang.js.html +0 -1810
  84. package/coverage/test-utils/src/testOrder.js.html +0 -355
  85. package/coverage/test-utils/vitest.config.browser.js.html +0 -133
  86. package/coverage/test-utils/vitest.config.js.html +0 -157
@@ -94,13 +94,247 @@ describe('stringUtils', () => {
94
94
  });
95
95
  });
96
96
 
97
+ describe('isAlphaNumeric', () => {
98
+ it('should return true for strings containing only alphanumeric characters', () => {
99
+ expect(stringUtils.isAlphaNumeric('abc123')).toBe(true);
100
+ expect(stringUtils.isAlphaNumeric('ABC')).toBe(true);
101
+ expect(stringUtils.isAlphaNumeric('123')).toBe(true);
102
+ expect(stringUtils.isAlphaNumeric('Test123')).toBe(true);
103
+ expect(stringUtils.isAlphaNumeric('a')).toBe(true);
104
+ expect(stringUtils.isAlphaNumeric('1')).toBe(true);
105
+ });
106
+
107
+ it('should return false for strings containing non-alphanumeric characters', () => {
108
+ expect(stringUtils.isAlphaNumeric('abc 123')).toBe(false); // space
109
+ expect(stringUtils.isAlphaNumeric('abc-123')).toBe(false); // hyphen
110
+ expect(stringUtils.isAlphaNumeric('abc_123')).toBe(false); // underscore
111
+ expect(stringUtils.isAlphaNumeric('abc@123')).toBe(false); // special character
112
+ expect(stringUtils.isAlphaNumeric('abc.123')).toBe(false); // period
113
+ expect(stringUtils.isAlphaNumeric('abc!123')).toBe(false); // exclamation
114
+ expect(stringUtils.isAlphaNumeric('')).toBe(false); // empty string
115
+ });
116
+
117
+ it('should return false for special edge cases', () => {
118
+ expect(stringUtils.isAlphaNumeric('\n')).toBe(false); // newline
119
+ expect(stringUtils.isAlphaNumeric('\t')).toBe(false); // tab
120
+ expect(stringUtils.isAlphaNumeric(' ')).toBe(false); // whitespace
121
+ });
122
+ });
123
+
97
124
  describe('getPathFromUrl', () => {
98
125
  it('should extract the pathname correctly', () => {
99
126
  expect(stringUtils.getPathFromUrl('https://example.com/path/to/resource')).toBe('/path/to/resource');
100
127
  expect(stringUtils.getPathFromUrl('https://example.com/')).toBe('/');
101
128
  expect(stringUtils.getPathFromUrl('https://example.com/path?query=string')).toBe('/path');
102
129
  });
130
+
131
+ it('should handle complex URLs', () => {
132
+ expect(stringUtils.getPathFromUrl('https://subdomain.example.com/path/to/resource')).toBe('/path/to/resource');
133
+ expect(stringUtils.getPathFromUrl('http://example.com/path/to/resource#hash')).toBe('/path/to/resource');
134
+ expect(stringUtils.getPathFromUrl('https://example.com:8080/path')).toBe('/path');
135
+ });
136
+
137
+ it('should handle URLs with encoded characters', () => {
138
+ expect(stringUtils.getPathFromUrl('https://example.com/path%20with%20spaces')).toBe('/path%20with%20spaces');
139
+ expect(stringUtils.getPathFromUrl('https://example.com/path/with/special%20chars')).toBe('/path/with/special%20chars');
140
+ });
141
+ });
142
+
143
+ describe('getAllText', () => {
144
+ it('should extract text from simple text nodes', () => {
145
+ const div = document.createElement('div');
146
+ div.textContent = 'Hello World';
147
+
148
+ expect(stringUtils.getAllText(div)).toBe('Hello World');
149
+ });
150
+
151
+ it('should extract text from nested elements', () => {
152
+ const div = document.createElement('div');
153
+ const span = document.createElement('span');
154
+ span.textContent = 'Hello';
155
+ const text = document.createTextNode(' World');
156
+
157
+ div.appendChild(span);
158
+ div.appendChild(text);
159
+
160
+ expect(stringUtils.getAllText(div)).toBe('Hello World');
161
+ });
162
+
163
+ it('should extract aria-label attributes', () => {
164
+ const div = document.createElement('div');
165
+ const button = document.createElement('button');
166
+ button.setAttribute('aria-label', 'Close dialog');
167
+ button.textContent = 'X';
168
+
169
+ div.appendChild(button);
170
+
171
+ const result = stringUtils.getAllText(div);
172
+ expect(result).toContain('Close dialog');
173
+ expect(result).toContain('X');
174
+ });
175
+
176
+ it('should extract alt attributes from images', () => {
177
+ const div = document.createElement('div');
178
+ const img = document.createElement('img');
179
+ img.setAttribute('alt', 'Profile picture');
180
+ img.setAttribute('src', 'profile.jpg');
181
+
182
+ div.appendChild(img);
183
+
184
+ expect(stringUtils.getAllText(div)).toBe('Profile picture');
185
+ });
186
+
187
+ it('should handle mixed content with text, aria-labels, and alt text', () => {
188
+ const div = document.createElement('div');
189
+
190
+ // Add some text
191
+ const textNode = document.createTextNode('Welcome ');
192
+ div.appendChild(textNode);
193
+
194
+ // Add element with aria-label
195
+ const button = document.createElement('button');
196
+ button.setAttribute('aria-label', 'Help');
197
+ button.textContent = '?';
198
+ div.appendChild(button);
199
+
200
+ // Add some more text
201
+ const moreText = document.createTextNode(' to our site ');
202
+ div.appendChild(moreText);
203
+
204
+ // Add image with alt text
205
+ const img = document.createElement('img');
206
+ img.setAttribute('alt', 'Company logo');
207
+ div.appendChild(img);
208
+
209
+ const result = stringUtils.getAllText(div);
210
+ expect(result).toContain('Welcome');
211
+ expect(result).toContain('Help');
212
+ expect(result).toContain('?');
213
+ expect(result).toContain('to our site');
214
+ expect(result).toContain('Company logo');
215
+ });
216
+
217
+ it('should handle empty elements', () => {
218
+ const div = document.createElement('div');
219
+ expect(stringUtils.getAllText(div)).toBe('');
220
+ });
221
+
222
+ it('should trim whitespace from text nodes', () => {
223
+ const div = document.createElement('div');
224
+ const textNode = document.createTextNode(' Hello World ');
225
+ div.appendChild(textNode);
226
+
227
+ expect(stringUtils.getAllText(div)).toBe('Hello World');
228
+ });
229
+
230
+ it('should handle elements with only whitespace', () => {
231
+ const div = document.createElement('div');
232
+ const textNode = document.createTextNode(' ');
233
+ div.appendChild(textNode);
234
+
235
+ // Should use textContent.trim() as fallback for empty text
236
+ expect(stringUtils.getAllText(div)).toBe('');
237
+ });
238
+
239
+ it('should handle deeply nested structures', () => {
240
+ const div = document.createElement('div');
241
+ const section = document.createElement('section');
242
+ const article = document.createElement('article');
243
+ const p = document.createElement('p');
244
+
245
+ p.textContent = 'Deep content';
246
+ article.appendChild(p);
247
+ section.appendChild(article);
248
+ div.appendChild(section);
249
+
250
+ expect(stringUtils.getAllText(div)).toBe('Deep content');
251
+ });
252
+
253
+ it('should handle images without alt attributes', () => {
254
+ const div = document.createElement('div');
255
+ const img = document.createElement('img');
256
+ img.setAttribute('src', 'image.jpg');
257
+ // No alt attribute
258
+
259
+ const text = document.createTextNode('Some text');
260
+ div.appendChild(text);
261
+ div.appendChild(img);
262
+
263
+ expect(stringUtils.getAllText(div)).toBe('Some text');
264
+ });
265
+
266
+ it('should handle elements without aria-label', () => {
267
+ const div = document.createElement('div');
268
+ const button = document.createElement('button');
269
+ button.textContent = 'Click me';
270
+ // No aria-label attribute
271
+
272
+ div.appendChild(button);
273
+
274
+ expect(stringUtils.getAllText(div)).toBe('Click me');
275
+ });
103
276
  });
104
277
 
105
- // Add more tests for getAllText and hasText when running in a DOM environment
278
+ describe('hasText', () => {
279
+ it('should return true for elements with text content', () => {
280
+ const div = document.createElement('div');
281
+ div.textContent = 'Hello World';
282
+
283
+ expect(stringUtils.hasText(div)).toBe(true);
284
+ });
285
+
286
+ it('should return false for empty elements', () => {
287
+ const div = document.createElement('div');
288
+
289
+ expect(stringUtils.hasText(div)).toBe(false);
290
+ });
291
+
292
+ it('should return false for elements with only whitespace', () => {
293
+ const div = document.createElement('div');
294
+ div.textContent = ' \n\t ';
295
+
296
+ expect(stringUtils.hasText(div)).toBe(false);
297
+ });
298
+
299
+ it('should return true for elements with aria-label', () => {
300
+ const div = document.createElement('div');
301
+ const button = document.createElement('button');
302
+ button.setAttribute('aria-label', 'Close');
303
+
304
+ div.appendChild(button);
305
+
306
+ expect(stringUtils.hasText(div)).toBe(true);
307
+ });
308
+
309
+ it('should return true for elements with image alt text', () => {
310
+ const div = document.createElement('div');
311
+ const img = document.createElement('img');
312
+ img.setAttribute('alt', 'Profile picture');
313
+
314
+ div.appendChild(img);
315
+
316
+ expect(stringUtils.hasText(div)).toBe(true);
317
+ });
318
+
319
+ it('should return true for nested elements with text', () => {
320
+ const div = document.createElement('div');
321
+ const span = document.createElement('span');
322
+ span.textContent = 'Nested text';
323
+
324
+ div.appendChild(span);
325
+
326
+ expect(stringUtils.hasText(div)).toBe(true);
327
+ });
328
+
329
+ it('should return false for elements with empty nested structure', () => {
330
+ const div = document.createElement('div');
331
+ const span = document.createElement('span');
332
+ const p = document.createElement('p');
333
+
334
+ div.appendChild(span);
335
+ span.appendChild(p);
336
+
337
+ expect(stringUtils.hasText(div)).toBe(false);
338
+ });
339
+ });
106
340
  });
@@ -1,4 +1,4 @@
1
- import { describe, it, expect, beforeEach, vi } from 'vitest';
1
+ import { describe, it, expect, beforeEach } from 'vitest';
2
2
  import { testContrast } from '../src/testContrast';
3
3
 
4
4
  describe('testContrast', () => {
@@ -18,16 +18,17 @@ describe('testContrast', () => {
18
18
  expect(testContrast(div)).toBe(true);
19
19
  });
20
20
 
21
- it('should handle color contrast ratio correctly', () => {
22
- // Mock a function to test the specific case
21
+ it('should handle identical colors (JSDOM test case)', () => {
23
22
  const div = document.createElement('div');
24
- div.textContent = 'Test text with identical colors';
25
- div.setAttribute('data-test-identical-colors', 'true');
23
+ div.textContent = 'Test text';
24
+ div.style.color = 'rgb(0, 0, 0)';
25
+ div.style.backgroundColor = 'rgb(0, 0, 0)';
26
26
  document.body.appendChild(div);
27
27
 
28
- // Since JSDOM doesn't properly handle computed styles, we can only verify
29
- // that the function works and doesn't throw exceptions
30
- expect(() => testContrast(div)).not.toThrow();
28
+ // In JSDOM, this may return true due to computed style limitations
29
+ // The function is designed to handle this specific test case
30
+ const result = testContrast(div);
31
+ expect(typeof result).toBe('boolean');
31
32
  });
32
33
 
33
34
  it('should return true for elements with sufficient contrast (AA)', () => {
@@ -74,4 +75,171 @@ describe('testContrast', () => {
74
75
  // Bold text at 14px is treated as large text (3:1 for AA)
75
76
  expect(testContrast(div, { level: 'AA' })).toBe(true);
76
77
  });
78
+
79
+ it('should handle default options when none provided', () => {
80
+ const div = document.createElement('div');
81
+ div.textContent = 'Default options text';
82
+ div.style.color = 'rgb(0, 0, 0)';
83
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
84
+ document.body.appendChild(div);
85
+
86
+ expect(testContrast(div)).toBe(true);
87
+ });
88
+
89
+ it('should handle elements with background images', () => {
90
+ const div = document.createElement('div');
91
+ div.textContent = 'Text with background image';
92
+ div.style.color = 'rgb(0, 0, 0)';
93
+ div.style.backgroundImage = 'url(image.jpg)';
94
+ document.body.appendChild(div);
95
+
96
+ // Should return true because background color can't be determined
97
+ expect(testContrast(div)).toBe(true);
98
+ });
99
+
100
+ it('should handle invisible elements', () => {
101
+ const div = document.createElement('div');
102
+ div.textContent = 'Hidden text';
103
+ div.style.display = 'none';
104
+ document.body.appendChild(div);
105
+
106
+ expect(testContrast(div)).toBe(true);
107
+ });
108
+
109
+ it('should handle offscreen elements', () => {
110
+ const div = document.createElement('div');
111
+ div.textContent = 'Offscreen text';
112
+ div.style.position = 'absolute';
113
+ div.style.left = '-9999px';
114
+ document.body.appendChild(div);
115
+
116
+ expect(testContrast(div)).toBe(true);
117
+ });
118
+
119
+ it('should handle AA level for medium text (14-17px)', () => {
120
+ const div = document.createElement('div');
121
+ div.textContent = 'Medium text';
122
+ div.style.color = 'rgb(100, 100, 100)';
123
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
124
+ div.style.fontSize = '16px';
125
+ document.body.appendChild(div);
126
+
127
+ expect(testContrast(div, { level: 'AA' })).toBe(true);
128
+ });
129
+
130
+ it('should handle AAA level for large text', () => {
131
+ const div = document.createElement('div');
132
+ div.textContent = 'Large text AAA';
133
+ div.style.color = 'rgb(80, 80, 80)';
134
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
135
+ div.style.fontSize = '20px';
136
+ document.body.appendChild(div);
137
+
138
+ expect(testContrast(div, { level: 'AAA' })).toBe(true);
139
+ });
140
+
141
+ it('should handle bold text at 14px for AAA', () => {
142
+ const div = document.createElement('div');
143
+ div.textContent = 'Bold 14px AAA';
144
+ div.style.color = 'rgb(60, 60, 60)';
145
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
146
+ div.style.fontSize = '14px';
147
+ div.style.fontWeight = 'bold';
148
+ document.body.appendChild(div);
149
+
150
+ expect(testContrast(div, { level: 'AAA' })).toBe(true);
151
+ });
152
+
153
+ it('should handle numeric font weight', () => {
154
+ const div = document.createElement('div');
155
+ div.textContent = 'Numeric weight';
156
+ div.style.color = 'rgb(80, 80, 80)';
157
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
158
+ div.style.fontSize = '14px';
159
+ div.style.fontWeight = '700';
160
+ document.body.appendChild(div);
161
+
162
+ expect(testContrast(div, { level: 'AA' })).toBe(true);
163
+ });
164
+
165
+ it('should handle transparent background with parent', () => {
166
+ const parent = document.createElement('div');
167
+ parent.style.backgroundColor = 'rgb(255, 255, 255)';
168
+
169
+ const child = document.createElement('div');
170
+ child.textContent = 'Child with transparent bg';
171
+ child.style.color = 'rgb(0, 0, 0)';
172
+ child.style.backgroundColor = 'rgba(0, 0, 0, 0)';
173
+
174
+ parent.appendChild(child);
175
+ document.body.appendChild(parent);
176
+
177
+ expect(testContrast(child)).toBe(true);
178
+ });
179
+
180
+ it('should handle elements without computed styles properly', () => {
181
+ const div = document.createElement('div');
182
+ div.textContent = 'Test without style';
183
+
184
+ // Just test that the function handles elements without explicit styles
185
+ expect(() => testContrast(div)).not.toThrow();
186
+ expect(typeof testContrast(div)).toBe('boolean');
187
+ });
188
+
189
+ it('should handle small text requiring 4.5:1 ratio', () => {
190
+ const div = document.createElement('div');
191
+ div.textContent = 'Small text';
192
+ div.style.color = 'rgb(0, 0, 0)';
193
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
194
+ div.style.fontSize = '12px';
195
+ document.body.appendChild(div);
196
+
197
+ expect(testContrast(div, { level: 'AA' })).toBe(true);
198
+ });
199
+
200
+ it('should handle element with parent having different colors', () => {
201
+ const parent = document.createElement('div');
202
+ parent.style.color = 'rgb(255, 0, 0)'; // Different color
203
+ parent.style.backgroundColor = 'rgb(0, 0, 255)'; // Different background
204
+
205
+ const child = document.createElement('div');
206
+ child.textContent = 'Child with different colors';
207
+ child.style.color = 'rgb(0, 0, 0)';
208
+ child.style.backgroundColor = 'rgb(255, 255, 255)';
209
+
210
+ parent.appendChild(child);
211
+ document.body.appendChild(parent);
212
+
213
+ expect(testContrast(child)).toBe(true);
214
+ });
215
+
216
+ it('should handle element with parent having same colors', () => {
217
+ const parent = document.createElement('div');
218
+ parent.style.color = 'rgb(0, 0, 0)'; // Same color
219
+ parent.style.backgroundColor = 'rgb(255, 255, 255)'; // Same background
220
+ parent.style.fontSize = '16px'; // Same size
221
+ parent.style.fontWeight = 'normal'; // Same weight
222
+
223
+ const child = document.createElement('div');
224
+ child.textContent = 'Child with same colors';
225
+ child.style.color = 'rgb(0, 0, 0)';
226
+ child.style.backgroundColor = 'rgb(255, 255, 255)';
227
+ child.style.fontSize = '16px';
228
+ child.style.fontWeight = 'normal';
229
+
230
+ parent.appendChild(child);
231
+ document.body.appendChild(parent);
232
+
233
+ expect(testContrast(child)).toBe(true);
234
+ });
235
+
236
+ it('should handle element without parent', () => {
237
+ const div = document.createElement('div');
238
+ div.textContent = 'No parent element';
239
+ div.style.color = 'rgb(0, 0, 0)';
240
+ div.style.backgroundColor = 'rgb(255, 255, 255)';
241
+
242
+ // Don't append to body to test no parent scenario
243
+ expect(testContrast(div)).toBe(true);
244
+ });
77
245
  });