Skip to content

~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.

6.9 KB
Raw Blame
/**
 * Tests for services/keyboard.js
 *
 * Tests the keyboard shortcut matching logic and service API.
 * We can't test the full initialization (which binds to document),
 * but we can test the shortcut matching and public API.
 */

// Stub URLS needed by keyboard.js handlers
window.URLS = {
    PAGES: {
        HOME: '/',
        HISTORY: '/history/',
        METRICS: '/metrics/',
        SETTINGS: '/settings/',
    }
};

import '@js/services/keyboard.js';

const KS = window.KeyboardService;

describe('KeyboardService', () => {
    describe('shortcuts registry invariants', () => {
        it('every registered shortcut has a callable handler', () => {
            // Catches accidental refactors that drop the handler field.
            const shortcuts = KS.shortcuts();
            for (const [name, shortcut] of Object.entries(shortcuts)) {
                expect(shortcut.handler, `${name} missing handler`).toBeTypeOf('function');
                expect(shortcut.keys, `${name} missing keys`).toBeInstanceOf(Array);
                expect(shortcut.keys.length, `${name} has empty keys`).toBeGreaterThan(0);
            }
        });
    });

    describe('addShortcut / removeShortcut', () => {
        afterEach(() => {
            KS.removeShortcut('testShortcut');
        });

        it('adds a custom shortcut', () => {
            KS.addShortcut('testShortcut', {
                keys: ['ctrl+t'],
                description: 'Test shortcut',
                handler: () => {}
            });
            const shortcuts = KS.shortcuts();
            expect(shortcuts.testShortcut).toBeDefined();
            expect(shortcuts.testShortcut.keys).toEqual(['ctrl+t']);
        });

        it('removes a custom shortcut', () => {
            KS.addShortcut('testShortcut', {
                keys: ['ctrl+t'],
                description: 'Test',
                handler: () => {}
            });
            KS.removeShortcut('testShortcut');
            const shortcuts = KS.shortcuts();
            expect(shortcuts.testShortcut).toBeUndefined();
        });
    });

    describe('keyboard event handling', () => {
        it('Escape key triggers newSearch shortcut', () => {
            // Create a keydown event for Escape
            const event = new KeyboardEvent('keydown', {
                key: 'Escape',
                code: 'Escape',
                bubbles: true,
            });

            // We can verify the event doesn't throw
            expect(() => document.dispatchEvent(event)).not.toThrow();
        });

        it('ignores shortcuts when typing in input fields', () => {
            const input = document.createElement('input');
            input.type = 'text';
            document.body.appendChild(input);
            input.focus();

            const event = new KeyboardEvent('keydown', {
                key: 'Escape',
                code: 'Escape',
                bubbles: true,
            });

            // Should not throw or cause navigation when typing
            expect(() => input.dispatchEvent(event)).not.toThrow();
            input.remove();
        });

        it('allows Ctrl+Shift navigation shortcuts even in input', () => {
            const input = document.createElement('input');
            input.type = 'text';
            document.body.appendChild(input);
            input.focus();

            const event = new KeyboardEvent('keydown', {
                key: '1',
                code: 'Digit1',
                ctrlKey: true,
                shiftKey: true,
                bubbles: true,
            });

            // Should not throw
            expect(() => input.dispatchEvent(event)).not.toThrow();
            input.remove();
        });

        it('does not navigate when Escape closes a settings select', () => {
            window.history.replaceState({}, '', '/settings/');
            const select = document.createElement('select');
            const option = document.createElement('option');
            option.value = 'openai';
            option.textContent = 'OpenAI';
            select.appendChild(option);
            document.body.appendChild(select);
            select.focus();
            const event = new KeyboardEvent('keydown', {
                key: 'Escape',
                code: 'Escape',
                bubbles: true,
                cancelable: true,
            });

            select.dispatchEvent(event);

            expect(event.defaultPrevented).toBe(false);
            expect(window.location.pathname).toBe('/settings/');
            select.remove();
        });

        it('opens a visible same-origin result with Enter on progress pages', () => {
            window.history.replaceState({}, '', '/progress/research-3299');
            const viewButton = document.createElement('a');
            viewButton.id = 'view-results-btn';
            viewButton.href = '/results/research-3299';
            viewButton.style.display = 'block';
            document.body.appendChild(viewButton);
            const event = new KeyboardEvent('keydown', {
                key: 'Enter',
                code: 'Enter',
                bubbles: true,
                cancelable: true,
            });

            document.dispatchEvent(event);

            expect(event.defaultPrevented).toBe(true);
            expect(window.location.pathname).toBe('/results/research-3299');
            viewButton.remove();
        });

        it('does not consume Enter for hidden or external result links', () => {
            window.history.replaceState({}, '', '/progress/research-3299');
            const viewButton = document.createElement('a');
            viewButton.id = 'view-results-btn';
            viewButton.href = '/results/research-3299';
            viewButton.style.display = 'none';
            document.body.appendChild(viewButton);

            const hiddenEvent = new KeyboardEvent('keydown', {
                key: 'Enter',
                code: 'Enter',
                bubbles: true,
                cancelable: true,
            });
            document.dispatchEvent(hiddenEvent);
            expect(hiddenEvent.defaultPrevented).toBe(false);
            expect(window.location.pathname).toBe('/progress/research-3299');

            viewButton.style.display = 'block';
            viewButton.href = 'https://example.test/results/research-3299';
            const logger = vi.spyOn(SafeLogger, 'error');
            const externalEvent = new KeyboardEvent('keydown', {
                key: 'Enter',
                code: 'Enter',
                bubbles: true,
                cancelable: true,
            });
            document.dispatchEvent(externalEvent);

            expect(externalEvent.defaultPrevented).toBe(false);
            expect(window.location.pathname).toBe('/progress/research-3299');
            expect(logger).toHaveBeenCalledWith(
                'Blocked non-same-origin redirect in keyboard shortcut',
            );
            viewButton.remove();
        });
    });

});