~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.
Python academiaanthropicarxivbravedeep-researchencryptionhome-automationhomeserverlocallocal-deep-researchlocal-llmmistralollamaopenaipubmedresearchresearch-toolretrieval-augmented-generationsearxngself-hosted
/**
* Tests for services/help.js
*
* Tests the HelpService for collapsible help panels:
* togglePanel, dismissPanel, isPanelDismissed, expandAll, collapseAll, reset.
*/
let HelpService;
beforeAll(async () => {
// Stub fetch — initPanelStates calls /settings/api/bulk on init
globalThis.fetch = vi.fn(() =>
Promise.resolve({
ok: true,
json: () => Promise.resolve({ success: true, settings: {} }),
})
);
window.api = { getCsrfToken: () => 'test-token' };
window.ui = { showMessage: vi.fn() };
await import('@js/services/help.js');
HelpService = window.HelpService;
});
afterEach(() => {
// Clean up any panels created in tests
document.querySelectorAll('.ldr-help-panel').forEach(p => p.remove());
localStorage.clear();
});
describe('HelpService', () => {
function createPanel(id, collapsed = false) {
const panel = document.createElement('div');
panel.className = 'ldr-help-panel' + (collapsed ? ' collapsed' : '');
panel.id = 'help-panel-' + id;
panel.setAttribute('data-panel-id', id);
const header = document.createElement('div');
header.className = 'ldr-help-panel-header';
header.setAttribute('aria-expanded', collapsed ? 'false' : 'true');
panel.appendChild(header);
document.body.appendChild(panel);
return panel;
}
describe('togglePanel', () => {
it('toggles the collapsed class', () => {
const panel = createPanel('test1');
expect(panel.classList.contains('collapsed')).toBe(false);
HelpService.togglePanel('test1');
expect(panel.classList.contains('collapsed')).toBe(true);
HelpService.togglePanel('test1');
expect(panel.classList.contains('collapsed')).toBe(false);
});
it('updates aria-expanded on header', () => {
const panel = createPanel('test2');
const header = panel.querySelector('.ldr-help-panel-header');
HelpService.togglePanel('test2');
expect(header.getAttribute('aria-expanded')).toBe('false');
HelpService.togglePanel('test2');
expect(header.getAttribute('aria-expanded')).toBe('true');
});
it('persists collapsed state to localStorage', () => {
createPanel('test3');
HelpService.togglePanel('test3');
expect(localStorage.getItem('ldr_panel_collapsed_test3')).toBe('true');
HelpService.togglePanel('test3');
expect(localStorage.getItem('ldr_panel_collapsed_test3')).toBe('false');
});
it('does nothing for non-existent panel', () => {
const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
expect(() => HelpService.togglePanel('nonexistent')).not.toThrow();
warnSpy.mockRestore();
});
});
describe('expandAll', () => {
it('removes collapsed class from all panels', () => {
const p1 = createPanel('e1', true);
const p2 = createPanel('e2', true);
const p3 = createPanel('e3', false);
HelpService.expandAll();
expect(p1.classList.contains('collapsed')).toBe(false);
expect(p2.classList.contains('collapsed')).toBe(false);
expect(p3.classList.contains('collapsed')).toBe(false);
});
it('updates aria-expanded to true on all expanded panels', () => {
const p = createPanel('e4', true);
HelpService.expandAll();
const header = p.querySelector('.ldr-help-panel-header');
expect(header.getAttribute('aria-expanded')).toBe('true');
});
});
describe('collapseAll', () => {
it('adds collapsed class to all panels', () => {
const p1 = createPanel('c1', false);
const p2 = createPanel('c2', false);
HelpService.collapseAll();
expect(p1.classList.contains('collapsed')).toBe(true);
expect(p2.classList.contains('collapsed')).toBe(true);
});
it('updates aria-expanded to false', () => {
const p = createPanel('c3', false);
HelpService.collapseAll();
const header = p.querySelector('.ldr-help-panel-header');
expect(header.getAttribute('aria-expanded')).toBe('false');
});
it('does not affect already-collapsed panels', () => {
const p = createPanel('c4', true);
HelpService.collapseAll();
expect(p.classList.contains('collapsed')).toBe(true);
});
});
describe('isPanelDismissed', () => {
it('returns false for unknown panels', () => {
expect(HelpService.isPanelDismissed('unknown')).toBe(false);
});
});
describe('dismissPanel', () => {
it('hides the panel and marks it dismissed', async () => {
const panel = createPanel('dismiss1');
globalThis.fetch = vi.fn(() =>
Promise.resolve({ ok: true, status: 200 })
);
await HelpService.dismissPanel('dismiss1');
expect(globalThis.fetch).toHaveBeenCalledWith(
'/settings/api/app.ui.help_dismissed_dismiss1',
{
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'X-CSRFToken': 'test-token',
},
body: JSON.stringify({ value: true }),
},
);
expect(panel.style.display).toBe('none');
expect(HelpService.isPanelDismissed('dismiss1')).toBe(true);
});
});
describe('resetDismissedPanels', () => {
it('DELETEs every panel setting with CSRF and makes panels visible', async () => {
const first = createPanel('reset-one');
const second = createPanel('reset/two');
first.style.display = 'none';
second.style.display = 'none';
globalThis.fetch = vi.fn(() =>
Promise.resolve({ ok: true, status: 200 })
);
await HelpService.resetDismissedPanels();
expect(globalThis.fetch.mock.calls).toEqual([
[
'/settings/api/app.ui.help_dismissed_reset-one',
{
method: 'DELETE',
headers: { 'X-CSRFToken': 'test-token' },
},
],
[
'/settings/api/app.ui.help_dismissed_reset%2Ftwo',
{
method: 'DELETE',
headers: { 'X-CSRFToken': 'test-token' },
},
],
]);
expect(first.style.display).toBe('');
expect(second.style.display).toBe('');
expect(window.ui.showMessage).toHaveBeenCalledWith(
'Help panels reset',
'success',
);
});
it('keeps a panel dismissed when its DELETE is rejected', async () => {
const reset = createPanel('reset-success');
const retained = createPanel('reset-failed');
globalThis.fetch = vi.fn(() => Promise.resolve({ ok: true, status: 200 }));
await HelpService.dismissPanel('reset-success');
await HelpService.dismissPanel('reset-failed');
expect(reset.style.display).toBe('none');
expect(retained.style.display).toBe('none');
window.ui.showMessage.mockClear();
globalThis.fetch = vi.fn(url => Promise.resolve({
ok: !url.endsWith('reset-failed'),
status: url.endsWith('reset-failed') ? 503 : 200,
}));
await HelpService.resetDismissedPanels();
expect(reset.style.display).toBe('');
expect(HelpService.isPanelDismissed('reset-success')).toBe(false);
expect(retained.style.display).toBe('none');
expect(HelpService.isPanelDismissed('reset-failed')).toBe(true);
expect(window.ui.showMessage).toHaveBeenCalledOnce();
expect(window.ui.showMessage).toHaveBeenCalledWith(
'Could not reset 1 help panel',
'error',
);
});
});
});