The OSINT investigator's workbench. One case, one folder, every tool. Local-first: your media and your investigations never leave your machine.
JavaScript
// @vitest-environment happy-dom
import { afterEach, describe, expect, it, vi } from 'vitest';
import { flushSync, mount, unmount } from 'svelte';
vi.mock('../lib/api.js', () => ({ api: { get: vi.fn(async () => []) } }));
vi.mock('../lib/findExample.js', () => ({ openFindExample: vi.fn() }));
const { openFindExample } = await import('../lib/findExample.js');
const { uiState } = await import('../lib/state.svelte.js');
const { default: GuideDialog } = await import('./GuideDialog.svelte');
const { EXTENSION_SITES, EXTENSION_TABS, JOURNEYS, KEYMAP, FIXES, PAGES, SETTINGS_TABS, landingFor, stepMarks } = await import('../lib/guide.js');
let live;
let onclose;
async function open(at, props = {}) {
onclose = vi.fn();
const target = document.createElement('div');
document.body.append(target);
live = mount(GuideDialog, { target, props: { at, onclose, ...props } });
flushSync();
await Promise.resolve();
}
const entry = (label) => [...document.querySelectorAll('.menu .entry')].find((b) => b.textContent.trim() === label);
const current = (selector) => document.querySelector(`${selector}[aria-current]`)?.textContent.trim();
const lines = () => [...document.querySelectorAll('.legend .mark')];
const frames = () => [...document.querySelectorAll('.frame')];
const pins = () => [...document.querySelectorAll('.pin')];
const press = (node) => {
node.click();
flushSync();
};
function hover(node, on = true) {
node.dispatchEvent(new MouseEvent(on ? 'mouseenter' : 'mouseleave'));
flushSync();
}
afterEach(() => {
if (live) unmount(live);
live = null;
document.body.innerHTML = '';
vi.restoreAllMocks();
});
describe('the guide over a tool', () => {
it('opens on the tab of the tool it was asked from, its picture numbered', async () => {
await open('media');
expect(current('.menu .entry')).toBe('Sources');
expect(current('.tabs .tab')).toBe('Media');
expect(document.querySelector('.shot img')).not.toBeNull();
expect(lines()).toHaveLength(PAGES.media.marks.length);
expect(pins().map((pin) => pin.textContent.trim())).toEqual(PAGES.media.marks.map((_, i) => String(i + 1)));
});
it('shows only its numbers at rest, so no frame crosses another', async () => {
await open('media');
expect(document.querySelector('.frame.on')).toBeNull();
expect(document.querySelector('.veil').classList.contains('on')).toBe(false);
});
it('rings the control of the line being read, names it by its number and dims the rest', async () => {
await open('media');
hover(lines()[3]);
const lit = document.querySelectorAll('.frame.on');
expect(lit).toHaveLength(1);
expect(document.querySelector('.veil').classList.contains('on')).toBe(true);
expect(document.querySelector('.shot .name').textContent).toBe(PAGES.media.marks[3].title);
expect(pins().map((pin) => pin.classList.contains('dim'))).toEqual(PAGES.media.marks.map((_, i) => i !== 3));
hover(lines()[3], false);
expect(frames().some((frame) => frame.classList.contains('on'))).toBe(false);
expect(document.querySelector('.shot .name')).toBeNull();
});
it('lights the line from its number on the picture too', async () => {
await open('media');
hover(pins()[1]);
expect(document.querySelectorAll('.legend li')[1].classList.contains('on')).toBe(true);
});
it('lists the subtleties under the picture, under a heading that says they are tips', async () => {
await open('media');
const tips = document.querySelector('section.tips');
expect(tips.getAttribute('aria-label')).toBe('Tips');
expect(tips.querySelector('.tips-head').textContent.trim()).toBe('Tips');
expect([...tips.querySelectorAll('li strong')].map((t) => t.textContent)).toEqual(
PAGES.media.tips.map((tip) => tip.title)
);
});
it('opens the tool it explains, and closes', async () => {
await open('media');
uiState.tool = 'settings';
press(document.querySelector('.go'));
expect(uiState.tool).toBe('media');
expect(onclose).toHaveBeenCalled();
});
});
describe('a number that leads somewhere', () => {
it('shows the screen its control opens, with the way back', async () => {
await open('media');
const leads = pins().filter((pin) => pin.classList.contains('leads'));
expect(leads).toHaveLength(PAGES.media.marks.filter((mark) => mark.opens).length);
const at = PAGES.media.marks.findIndex((mark) => mark.title === 'Open in…');
press(pins()[at]);
expect(document.querySelector('.trail').textContent).toContain('Open in…');
expect(document.querySelector('.lead').textContent).toBe(PAGES.media.marks[at].opens.lead);
expect(lines()).toHaveLength(1);
press(document.querySelector('.trail button'));
expect(document.querySelector('.trail')).toBeNull();
expect(lines()).toHaveLength(PAGES.media.marks.length);
});
it('is offered from the line as well as from the number', async () => {
await open('satellite');
const offers = [...document.querySelectorAll('.legend .leads')];
expect(offers.length).toBe(PAGES.satellite.marks.filter((mark) => mark.opens).length);
press(offers[0]);
expect(document.querySelector('.trail')).not.toBeNull();
});
it('forgets the trail when another tab is picked', async () => {
await open('media');
press(pins().find((pin) => pin.classList.contains('leads')));
press([...document.querySelectorAll('.tabs .tab')].find((tab) => tab.textContent.trim() === 'Files'));
expect(document.querySelector('.trail')).toBeNull();
expect(current('.tabs .tab')).toBe('Files');
});
});
describe('a journey', () => {
it('walks its steps on the picture of each tool, with only that step’s frames', async () => {
const journey = JOURNEYS[0];
await open(`journey:${journey.id}`);
expect([...document.querySelectorAll('.steps .step:not(.result)')]).toHaveLength(journey.steps.length);
expect(document.querySelector('.lead').textContent).toBe(journey.steps[0].text);
expect(lines()).toHaveLength(journey.steps[0].marks.length);
press([...document.querySelectorAll('.walk button')].find((b) => b.textContent.includes('Next')));
expect(document.querySelector('.lead').textContent).toBe(journey.steps[1].text);
expect(document.querySelector('.go').textContent).toContain('Inspect');
// a step reads one control at a time, so nothing in it leads elsewhere
expect(document.querySelector('.legend .leads')).toBeNull();
});
it('takes a step on a picture of its own when the tool’s page has none of that moment', async () => {
const journey = JOURNEYS[0];
const at = journey.steps.findIndex((step) => step.shot);
await open(`journey:${journey.id}`);
press(document.querySelectorAll('.steps .step')[at]);
expect(document.querySelector('.lead').textContent).toBe(journey.steps[at].text);
expect(lines().map((line) => line.querySelector('strong').textContent)).toEqual(
stepMarks(journey.steps[at]).map((mark) => mark.title)
);
});
it('ends on what it made, past its last step', async () => {
const journey = JOURNEYS[0];
await open(`journey:${journey.id}`);
const next = () => [...document.querySelectorAll('.walk button')].find((b) => b.textContent.includes('Next'));
for (let step = 0; step < journey.steps.length; step += 1) press(next());
expect(current('.steps .step')).toBe('Result');
expect(document.querySelector('.lead').textContent).toBe(journey.result.text);
expect(document.querySelector('.shot img')).not.toBeNull();
expect(lines()).toHaveLength(0);
expect(next().disabled).toBe(true);
});
describe('Search with Find, past its last step', () => {
const search = JOURNEYS.find((journey) => journey.id === 'search-with-find');
const tryIt = () => [...document.querySelectorAll('.example button')].find((b) => b.textContent.includes('Try this search'));
async function onResult(props) {
await open(`journey:${search.id}`, props);
press(document.querySelector('.steps .step.result'));
}
it('plays the place found, and offers the search itself', async () => {
await onResult();
expect(document.querySelector('.shot video')).not.toBeNull();
openFindExample.mockClear();
press(tryIt());
expect(onclose).toHaveBeenCalled();
expect(openFindExample).toHaveBeenCalledTimes(1);
});
it('asks the app when the guide stands in a tab of its own', async () => {
const app = { closed: false, location: { origin: location.origin }, postMessage: vi.fn(), focus: vi.fn() };
vi.spyOn(window, 'opener', 'get').mockReturnValue(app);
openFindExample.mockClear();
await onResult({ detached: true });
press(tryIt());
expect(app.postMessage).toHaveBeenCalledWith({ 'azimut:guide': { example: true } }, location.origin);
expect(openFindExample).not.toHaveBeenCalled();
});
it('leaves it off a step and off another journey', async () => {
await open(`journey:${search.id}`);
expect(tryIt()).toBeUndefined();
live && unmount(live);
document.body.innerHTML = '';
const other = JOURNEYS.find((journey) => journey.result && !journey.result.example);
await open(`journey:${other.id}`);
press(document.querySelector('.steps .step.result'));
expect(tryIt()).toBeUndefined();
});
});
it('names a step for what it does when every step happens in one tool', async () => {
const build = JOURNEYS.find((journey) => journey.id === 'create-an-analyzer');
await open(`journey:${build.id}`);
expect([...document.querySelectorAll('.steps .step:not(.result)')].map((b) => b.textContent.replace(/^\d+/, '').trim())).toEqual(
build.steps.map((step) => step.label)
);
expect(document.querySelector('.go').textContent).toContain('Detect');
});
it('is reached from a tool at the step it is used at', async () => {
await open('satellite');
const link = [...document.querySelectorAll('.journey')].find((b) => b.textContent.includes('Geolocate a photo'));
press(link);
expect(current('.menu .entry')).toBe('Geolocate a photo');
expect(current('.steps .step')).toContain('Satellite');
});
});
describe('the extension, in tabs', () => {
it('opens on setting it up, with the tabs that follow it', async () => {
await open('extension');
expect(current('.menu .entry')).toBe('Capture extension');
expect([...document.querySelectorAll('.tabs .tab')].map((tab) => tab.textContent.trim())).toEqual(
EXTENSION_TABS.map((tab) => tab.label)
);
expect(current('.tabs .tab')).toBe('Install');
expect(lines()).toHaveLength(PAGES.extension.marks.length);
// a tab of the page explains it rather than opening a tool
expect(document.querySelector('.go')).toBeNull();
});
it('shows the popup and the tools on their own pictures', async () => {
await open('extension');
const tab = (label) => [...document.querySelectorAll('.tabs .tab')].find((b) => b.textContent.trim() === label);
press(tab('Capture'));
expect(document.querySelector('.lead').textContent).toBe(PAGES['extension-capture'].lead);
expect(lines()).toHaveLength(PAGES['extension-capture'].marks.length);
press(tab('Tools on the map'));
expect(lines()).toHaveLength(PAGES['extension-tools'].marks.length);
});
it('says where it works, Street View included, in a table', async () => {
await open('extension');
press([...document.querySelectorAll('.tabs .tab')].find((b) => b.textContent.trim() === 'Where it works'));
const rows = [...document.querySelectorAll('.sites tbody tr')];
expect(rows).toHaveLength(EXTENSION_SITES.rows.length);
expect(rows.map((row) => row.querySelector('th').firstChild.textContent.trim())).toContain('Street View');
expect(document.querySelectorAll('.sites .names span')).toHaveLength(EXTENSION_SITES.sites.length);
const street = rows.find((row) => row.textContent.includes('Street View'));
expect(street.querySelectorAll('.yes')).toHaveLength(1);
expect(street.textContent).toContain('not in Street View');
expect(document.querySelectorAll('.sites .elsewhere .card-block')).toHaveLength(EXTENSION_SITES.elsewhere.length);
});
});
describe('the reference', () => {
it('lists every key by where it is pressed', async () => {
await open('start');
press(entry('Shortcuts'));
expect([...document.querySelectorAll('.keys h3')].map((h) => h.textContent)).toEqual(KEYMAP.map((g) => g.where));
expect(document.querySelectorAll('.keys kbd').length).toBe(KEYMAP.flatMap((g) => g.keys).length);
});
it('answers every symptom', async () => {
await open('start');
press(entry('When something does not work'));
expect(document.querySelectorAll('.fixes .card-block')).toHaveLength(FIXES.length);
});
it('opens Settings on its own page from the gear, a tab per section', async () => {
await open('settings');
expect(current('.menu .entry')).toBe('Settings');
expect(current('.tabs .tab')).toBe('General');
expect([...document.querySelectorAll('.tabs .tab')].map((tab) => tab.textContent.trim())).toEqual(
SETTINGS_TABS.map((tab) => tab.label)
);
press([...document.querySelectorAll('.tabs .tab')].find((tab) => tab.textContent.trim() === 'System'));
expect(lines()).toHaveLength(PAGES['settings-system'].marks.length);
// a section of Settings explains it rather than opening a tool
expect(document.querySelector('.go')).toBeNull();
});
it('ends what to do when something does not work on reporting it, in Settings, System', async () => {
await open('start');
press(entry('When something does not work'));
uiState.tool = 'media';
press(document.querySelector('.report button'));
expect(uiState.tool).toBe('settings');
expect(uiState.settingsTab).toBe('system');
expect(onclose).toHaveBeenCalled();
});
});
describe('the tour', () => {
it('is taken again from the start page, over the app', async () => {
uiState.onboarding = null;
await open('start');
press([...document.querySelectorAll('.side button')].find((b) => b.textContent.includes('Take the tour')));
expect(onclose).toHaveBeenCalled();
expect(uiState.onboarding).toEqual({ kind: 'tour', step: 0 });
uiState.onboarding = null;
});
it('is offered on the start page only', async () => {
await open('media');
expect([...document.querySelectorAll('.side button')].some((b) => b.textContent.includes('Take the tour'))).toBe(false);
});
});
describe('the way out', () => {
it('closes from its own header', async () => {
await open('media');
press(document.querySelector('.head button[aria-label="Close"]'));
expect(onclose).toHaveBeenCalled();
});
it('moves to a tab of its own on the step being read, and closes here', async () => {
const journey = JOURNEYS[0];
const tab = vi.spyOn(window, 'open').mockReturnValue({});
await open(`journey:${journey.id}`);
press([...document.querySelectorAll('.walk button')].find((b) => b.textContent.includes('Next')));
press(document.querySelector('.head button[aria-label="Open in a new tab"]'));
const [url, name] = tab.mock.calls[0];
expect(url).toContain(`#guide?page=journey%3A${journey.id}&step=1`);
expect(name).toBe('azimut-guide');
expect(onclose).toHaveBeenCalled();
});
it('stays open when the browser refuses the tab', async () => {
vi.spyOn(window, 'open').mockReturnValue(null);
await open('media');
press(document.querySelector('.head button[aria-label="Open in a new tab"]'));
expect(onclose).not.toHaveBeenCalled();
expect(document.querySelector('[role="dialog"]')).not.toBeNull();
});
});
describe('in a tab of its own', () => {
const journey = JOURNEYS[0];
const detached = (place) => open(undefined, { detached: true, place });
let opener;
function withOpener() {
opener = { closed: false, location: { origin: location.origin }, postMessage: vi.fn(), focus: vi.fn() };
vi.spyOn(window, 'opener', 'get').mockReturnValue(opener);
}
it('fills the tab on its place, with no way out but closing the tab', async () => {
await detached({ item: `journey:${journey.id}`, tool: null, step: 1 });
expect(document.querySelector('[role="dialog"]')).toBeNull();
expect(document.querySelector('main.detached .guide')).not.toBeNull();
expect(document.querySelector('.lead').textContent).toBe(journey.steps[1].text);
expect(document.querySelector('.head button[aria-label="Close"]')).toBeNull();
expect(document.querySelector('.head button[aria-label="Open in a new tab"]')).toBeNull();
});
it('keeps where the reader stands in its address, for a reload', async () => {
await detached({ item: `journey:${journey.id}`, tool: null, step: 0 });
press([...document.querySelectorAll('.walk button')].find((b) => b.textContent.includes('Next')));
expect(location.hash).toBe(`#guide?page=journey%3A${journey.id}&step=1`);
press(entry('Sources'));
expect(location.hash).toMatch(/^#guide\?page=[^&]+&tab=/);
});
it('opens a tool in the tab it was detached from, and stays', async () => {
withOpener();
await detached({ ...landingFor('media'), step: 0 });
uiState.tool = 'settings';
press(document.querySelector('.go'));
expect(opener.postMessage).toHaveBeenCalledWith({ 'azimut:guide': { open: 'media' } }, location.origin);
expect(uiState.tool).toBe('settings');
expect(document.querySelector('main.detached')).not.toBeNull();
});
it('sends a report to that tab too', async () => {
withOpener();
await detached({ item: 'start', tool: null, step: 0 });
press(entry('When something does not work'));
press(document.querySelector('.report button'));
expect(opener.postMessage).toHaveBeenCalledWith({ 'azimut:guide': { report: true } }, location.origin);
});
});