π¬ A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots π
TypeScript browser-extensionchrome-extensiondocumentationfirefox-extensionguide-generatorlocal-firstmanifest-v3privacy-firstproductivityreactscreenshotstep-by-step-guidetutorialtypescriptworkflowwxt
import { beforeEach, describe, expect, it, vi } from 'vitest';
const queryTabs = vi.fn();
const sendMessageToTab = vi.fn();
vi.mock('@/lib/browser-api/execute-script', () => ({ executeScript: vi.fn() }));
vi.mock('@/lib/browser-api/query-tabs', () => ({ queryTabs: (...args: unknown[]) => queryTabs(...args) }));
vi.mock('@/lib/browser-api/send-message-to-tab', () => ({
sendMessageToTab: (tabId: number, msg: unknown) => sendMessageToTab(tabId, msg),
}));
vi.mock('@mimik/core/logger', () => ({ logger: { info: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() } }));
import {
broadcastClearBlur,
broadcastDetachCaptureAndFlush,
broadcastDismissBlur,
isInjectableTab,
} from '../tab-manager';
function typesSent(): string[] {
return sendMessageToTab.mock.calls.map(([, msg]) => (msg as { type: string }).type);
}
beforeEach(() => {
vi.clearAllMocks();
queryTabs.mockResolvedValue([
{ id: 1, url: 'https://a.test' },
{ id: 2, url: 'https://b.test' },
]);
sendMessageToTab.mockResolvedValue(undefined);
});
describe('blur broadcasts', () => {
it('dismiss asks every tab to close the overlay and keep the masks', async () => {
await broadcastDismissBlur();
expect(typesSent()).toEqual(['DISMISS_BLUR', 'DISMISS_BLUR']);
});
it('clear asks every tab to remove the masks', async () => {
await broadcastClearBlur();
expect(typesSent()).toEqual(['CLEAR_BLUR', 'CLEAR_BLUR']);
});
});
describe('broadcastDetachCaptureAndFlush', () => {
it('waits for every tab to answer before resolving', async () => {
let answered = 0;
sendMessageToTab.mockImplementation(
() =>
new Promise((resolve) => {
setTimeout(() => {
answered++;
resolve(undefined);
}, 5);
}),
);
await broadcastDetachCaptureAndFlush();
expect(answered).toBe(2);
expect(typesSent()).toEqual(['DETACH_CAPTURE', 'DETACH_CAPTURE']);
});
it('resolves even when a tab never answers', async () => {
sendMessageToTab.mockImplementation(() => new Promise(() => {}));
await expect(broadcastDetachCaptureAndFlush()).resolves.toBeUndefined();
});
it('resolves when a tab rejects', async () => {
sendMessageToTab.mockRejectedValue(new Error('no receiving end'));
await expect(broadcastDetachCaptureAndFlush()).resolves.toBeUndefined();
});
});
describe('isInjectableTab', () => {
it.each([
['https://example.com', true],
['http://localhost:3000', true],
['chrome://extensions', false],
['chrome-extension://abc/fullview.html', false],
['about:blank', false],
['https://chrome.google.com/webstore/detail/abc', false],
['https://chromewebstore.google.com/detail/abc', false],
['', false],
])('%s β %s', (url, expected) => {
expect(isInjectableTab({ url })).toBe(expected);
});
});