@afixt/test-utils 1.1.8 → 1.2.1

package/test/tableUtils.test.js

@@ -0,0 +1,340 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import tableUtils from '../src/tableUtils.js';
+
+describe('tableUtils', () => {
+    beforeEach(() => {
+        document.body.innerHTML = '';
+    });
+
+    describe('hasMultipleHeaderRows', () => {
+        it('should return true for table with 3+ header rows', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><th>H3</th><th>H4</th></tr>
+                    <tr><th>H5</th><th>H6</th></tr>
+                    <tr><td>D1</td><td>D2</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultipleHeaderRows(document.getElementById('t'))).toBe(true);
+        });
+
+        it('should return false for table with fewer than 3 header rows', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td></tr>
+                    <tr><td>D3</td><td>D4</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultipleHeaderRows(document.getElementById('t'))).toBe(false);
+        });
+
+        it('should return false for table with no header rows', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><td>D1</td><td>D2</td></tr>
+                    <tr><td>D3</td><td>D4</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultipleHeaderRows(document.getElementById('t'))).toBe(false);
+        });
+
+        it('should not count rows where th count is less than td count', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th><th>H3</th></tr>
+                    <tr><th>H4</th><td>D1</td><td>D2</td></tr>
+                    <tr><td>D3</td><td>D4</td><td>D5</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultipleHeaderRows(document.getElementById('t'))).toBe(false);
+        });
+    });
+
+    describe('hasComplexHeaderSpans', () => {
+        it('should return true when colspan exceeds max', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th colspan="5">Wide header</th></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td><td>D4</td><td>D5</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasComplexHeaderSpans(document.getElementById('t'))).toBe(true);
+        });
+
+        it('should return true when rowspan exceeds max', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th rowspan="4">Tall header</th><td>D1</td></tr>
+                    <tr><td>D2</td></tr>
+                    <tr><td>D3</td></tr>
+                    <tr><td>D4</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasComplexHeaderSpans(document.getElementById('t'))).toBe(true);
+        });
+
+        it('should return false when spans are within defaults', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th colspan="2">Header</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasComplexHeaderSpans(document.getElementById('t'))).toBe(false);
+        });
+
+        it('should support custom max values', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th colspan="3">Header</th></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasComplexHeaderSpans(document.getElementById('t'), 2, 2)).toBe(true);
+        });
+
+        it('should return false for table with no spanning headers', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasComplexHeaderSpans(document.getElementById('t'))).toBe(false);
+        });
+    });
+
+    describe('getMaxColumnCount', () => {
+        it('should count columns correctly', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th><th>H3</th></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td></tr>
+                </table>
+            `;
+            expect(tableUtils.getMaxColumnCount(document.getElementById('t'))).toBe(3);
+        });
+
+        it('should account for colspan', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th colspan="3">Wide header</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td><td>D4</td></tr>
+                </table>
+            `;
+            expect(tableUtils.getMaxColumnCount(document.getElementById('t'))).toBe(4);
+        });
+
+        it('should return the maximum across all rows', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><td>D1</td><td>D2</td></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td><td>D4</td><td>D5</td></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td></tr>
+                </table>
+            `;
+            expect(tableUtils.getMaxColumnCount(document.getElementById('t'))).toBe(5);
+        });
+
+        it('should return 0 for empty table', () => {
+            document.body.innerHTML = '<table id="t"></table>';
+            expect(tableUtils.getMaxColumnCount(document.getElementById('t'))).toBe(0);
+        });
+    });
+
+    describe('hasMultiLevelHeaderGroupings', () => {
+        it('should return true when 2+ rows have spanned headers', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th colspan="2">Group A</th><th colspan="2">Group B</th></tr>
+                    <tr><th rowspan="2">Sub</th><th>S1</th><th>S2</th><th>S3</th></tr>
+                    <tr><td>D1</td><td>D2</td><td>D3</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultiLevelHeaderGroupings(document.getElementById('t'))).toBe(
+                true
+            );
+        });
+
+        it('should return false when only 1 row has spanned headers', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th colspan="2">Header</th></tr>
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultiLevelHeaderGroupings(document.getElementById('t'))).toBe(
+                false
+            );
+        });
+
+        it('should return false when no rows have spanned headers', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td></tr>
+                </table>
+            `;
+            expect(tableUtils.hasMultiLevelHeaderGroupings(document.getElementById('t'))).toBe(
+                false
+            );
+        });
+    });
+
+    describe('isHeaderOnlyTable', () => {
+        it('should return true for table with only th cells', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><th>H3</th><th>H4</th></tr>
+                </table>
+            `;
+            expect(tableUtils.isHeaderOnlyTable(document.getElementById('t'))).toBe(true);
+        });
+
+        it('should return false for table with both th and td', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><th>H1</th><th>H2</th></tr>
+                    <tr><td>D1</td><td>D2</td></tr>
+                </table>
+            `;
+            expect(tableUtils.isHeaderOnlyTable(document.getElementById('t'))).toBe(false);
+        });
+
+        it('should return false for table with only td cells', () => {
+            document.body.innerHTML = `
+                <table id="t">
+                    <tr><td>D1</td><td>D2</td></tr>
+                </table>
+            `;
+            expect(tableUtils.isHeaderOnlyTable(document.getElementById('t'))).toBe(false);
+        });
+    });
+
+    describe('isHeaderOnlyAriaTable', () => {
+        it('should return true for ARIA table with only header roles', () => {
+            document.body.innerHTML = `
+                <div role="table" id="t">
+                    <div role="row">
+                        <div role="columnheader">H1</div>
+                        <div role="columnheader">H2</div>
+                    </div>
+                </div>
+            `;
+            expect(tableUtils.isHeaderOnlyAriaTable(document.getElementById('t'))).toBe(true);
+        });
+
+        it('should return true for ARIA table with rowheader only', () => {
+            document.body.innerHTML = `
+                <div role="table" id="t">
+                    <div role="row">
+                        <div role="rowheader">RH</div>
+                    </div>
+                </div>
+            `;
+            expect(tableUtils.isHeaderOnlyAriaTable(document.getElementById('t'))).toBe(true);
+        });
+
+        it('should return false for ARIA table with cell roles', () => {
+            document.body.innerHTML = `
+                <div role="table" id="t">
+                    <div role="row">
+                        <div role="columnheader">H1</div>
+                        <div role="cell">D1</div>
+                    </div>
+                </div>
+            `;
+            expect(tableUtils.isHeaderOnlyAriaTable(document.getElementById('t'))).toBe(false);
+        });
+
+        it('should return false for ARIA table with gridcell roles', () => {
+            document.body.innerHTML = `
+                <div role="table" id="t">
+                    <div role="row">
+                        <div role="columnheader">H1</div>
+                        <div role="gridcell">D1</div>
+                    </div>
+                </div>
+            `;
+            expect(tableUtils.isHeaderOnlyAriaTable(document.getElementById('t'))).toBe(false);
+        });
+
+        it('should return false when no headers exist', () => {
+            document.body.innerHTML = `
+                <div role="table" id="t">
+                    <div role="row">
+                        <div role="cell">D1</div>
+                    </div>
+                </div>
+            `;
+            expect(tableUtils.isHeaderOnlyAriaTable(document.getElementById('t'))).toBe(false);
+        });
+    });
+
+    describe('isPunctuationOnly', () => {
+        it('should return true for strings with only punctuation', () => {
+            expect(tableUtils.isPunctuationOnly('...')).toBe(true);
+            expect(tableUtils.isPunctuationOnly('---')).toBe(true);
+            expect(tableUtils.isPunctuationOnly('!!!')).toBe(true);
+            expect(tableUtils.isPunctuationOnly('***')).toBe(true);
+            expect(tableUtils.isPunctuationOnly('.,;:!?')).toBe(true);
+        });
+
+        it('should return false for strings with letters', () => {
+            expect(tableUtils.isPunctuationOnly('hello')).toBe(false);
+            expect(tableUtils.isPunctuationOnly('...hello')).toBe(false);
+            expect(tableUtils.isPunctuationOnly('a')).toBe(false);
+        });
+
+        it('should return false for strings with digits', () => {
+            expect(tableUtils.isPunctuationOnly('123')).toBe(false);
+            expect(tableUtils.isPunctuationOnly('...1')).toBe(false);
+        });
+
+        it('should return false for empty string', () => {
+            expect(tableUtils.isPunctuationOnly('')).toBe(false);
+        });
+
+        it('should return true for symbol characters', () => {
+            expect(tableUtils.isPunctuationOnly('$€£')).toBe(true);
+            expect(tableUtils.isPunctuationOnly('+')).toBe(true);
+        });
+    });
+
+    describe('isGenericSummary', () => {
+        it('should return true for common generic summaries', () => {
+            expect(tableUtils.isGenericSummary('table')).toBe(true);
+            expect(tableUtils.isGenericSummary('data table')).toBe(true);
+            expect(tableUtils.isGenericSummary('layout')).toBe(true);
+            expect(tableUtils.isGenericSummary('n/a')).toBe(true);
+            expect(tableUtils.isGenericSummary('none')).toBe(true);
+        });
+
+        it('should be case-insensitive', () => {
+            expect(tableUtils.isGenericSummary('TABLE')).toBe(true);
+            expect(tableUtils.isGenericSummary('Data Table')).toBe(true);
+            expect(tableUtils.isGenericSummary('LAYOUT')).toBe(true);
+        });
+
+        it('should trim whitespace', () => {
+            expect(tableUtils.isGenericSummary('  table  ')).toBe(true);
+            expect(tableUtils.isGenericSummary('  layout  ')).toBe(true);
+        });
+
+        it('should return false for descriptive summaries', () => {
+            expect(tableUtils.isGenericSummary('Quarterly sales data for 2024')).toBe(false);
+            expect(tableUtils.isGenericSummary('List of employees by department')).toBe(false);
+        });
+
+        it('should support custom generic list', () => {
+            const customList = ['custom', 'test'];
+            expect(tableUtils.isGenericSummary('custom', customList)).toBe(true);
+            expect(tableUtils.isGenericSummary('test', customList)).toBe(true);
+            expect(tableUtils.isGenericSummary('table', customList)).toBe(false);
+        });
+    });
+});