import { afterEach, describe, expect, it, vi } from 'vitest'; import { downloadUrl, pickGcgDelivery, pickTextShare, shareOrDownloadGcg, shareText } from './share'; import type { GcgExport } from './model'; const file = {} as File; const gcg: GcgExport = { gameId: 'g1', filename: 'game.gcg', content: '#title game' }; describe('pickGcgDelivery', () => { const canShareNav = { canShare: () => true, share: async () => {} }; const noShareNav = { canShare: () => false, share: async () => {} }; it('shares when the platform can share files, even in an in-app webview (iOS)', () => { expect(pickGcgDelivery(canShareNav, file, false)).toBe('share'); expect(pickGcgDelivery(canShareNav, file, true)).toBe('share'); }); it('copies in an in-app webview that cannot share files (Android Telegram/VK: no share, dead download)', () => { expect(pickGcgDelivery(noShareNav, file, true)).toBe('copy'); expect(pickGcgDelivery(undefined, file, true)).toBe('copy'); expect(pickGcgDelivery({ canShare: () => true } as never, file, true)).toBe('copy'); }); it('downloads on a plain browser without Web Share (desktop)', () => { expect(pickGcgDelivery(noShareNav, file, false)).toBe('download'); expect(pickGcgDelivery(undefined, file, false)).toBe('download'); }); }); describe('shareOrDownloadGcg', () => { afterEach(() => vi.unstubAllGlobals()); const noCopy = async () => false; function stubDownloadEnv(canShare: boolean, share: () => Promise) { const anchor = { href: '', download: '', click: vi.fn(), remove: vi.fn() }; const createElement = vi.fn(() => anchor); vi.stubGlobal('File', class {}); vi.stubGlobal('Blob', class {}); vi.stubGlobal('navigator', { canShare: () => canShare, share }); vi.stubGlobal('document', { createElement, body: { appendChild: vi.fn() } }); vi.stubGlobal('URL', { createObjectURL: vi.fn(() => 'blob:x'), revokeObjectURL: vi.fn() }); return { anchor, createElement }; } it('never falls back to the navigating Blob download when a share is cancelled', async () => { // Reproduces the iOS Telegram Mini App break: Web Share is available and the user cancels it // (AbortError). The fallback navigates the WKWebView to the blob: URL and strands // the app, so a cancelled (or failed) share must do nothing here. const share = vi.fn().mockRejectedValue(new DOMException('cancelled', 'AbortError')); const { createElement } = stubDownloadEnv(true, share); expect(await shareOrDownloadGcg(gcg, false, noCopy)).toBe('shared'); expect(share).toHaveBeenCalledOnce(); expect(createElement).not.toHaveBeenCalled(); // no download anchor → no webview navigation }); it('downloads via an anchor on a desktop browser that cannot share files', async () => { const { anchor, createElement } = stubDownloadEnv(false, vi.fn()); expect(await shareOrDownloadGcg(gcg, false, noCopy)).toBe('downloaded'); expect(createElement).toHaveBeenCalledWith('a'); expect(anchor.click).toHaveBeenCalledOnce(); }); it('copies to the clipboard in an in-app webview that cannot share files (no dead Blob download)', async () => { // Android Telegram/VK expose no Web Share AND ignore , so the export must copy the // GCG text instead of silently issuing an anchor click that does nothing. const copy = vi.fn().mockResolvedValue(true); const { createElement } = stubDownloadEnv(false, vi.fn()); expect(await shareOrDownloadGcg(gcg, true, copy)).toBe('copied'); expect(copy).toHaveBeenCalledWith(gcg.content); expect(createElement).not.toHaveBeenCalled(); }); it('reports failure when the in-app clipboard copy fails', async () => { stubDownloadEnv(false, vi.fn()); expect(await shareOrDownloadGcg(gcg, true, async () => false)).toBe('failed'); }); }); describe('downloadUrl', () => { afterEach(() => vi.unstubAllGlobals()); it('clicks a temporary anchor carrying the URL and the filename', () => { const anchor = { href: '', download: '', click: vi.fn(), remove: vi.fn() }; const createElement = vi.fn(() => anchor); vi.stubGlobal('document', { createElement, body: { appendChild: vi.fn() } }); downloadUrl('https://example.test/dl/g-1/png?e=1&s=x', 'game-1.png'); expect(createElement).toHaveBeenCalledWith('a'); expect(anchor.href).toBe('https://example.test/dl/g-1/png?e=1&s=x'); expect(anchor.download).toBe('game-1.png'); expect(anchor.click).toHaveBeenCalledOnce(); expect(anchor.remove).toHaveBeenCalledOnce(); }); }); describe('pickTextShare', () => { it('shares when Web Share is available', () => { expect(pickTextShare({ share: async () => {}, canShare: () => true })).toBe('share'); }); it('shares when share exists without canShare (text needs no file capability check)', () => { expect(pickTextShare({ share: async () => {} })).toBe('share'); }); it('copies when there is no Web Share (desktop)', () => { expect(pickTextShare(undefined)).toBe('copy'); expect(pickTextShare({} as never)).toBe('copy'); }); }); describe('shareText', () => { afterEach(() => vi.unstubAllGlobals()); it('uses the OS share sheet when available', async () => { const share = vi.fn().mockResolvedValue(undefined); vi.stubGlobal('navigator', { share, canShare: () => true }); expect(await shareText('diag', 'title')).toBe('shared'); expect(share).toHaveBeenCalledWith({ title: 'title', text: 'diag' }); }); it('copies to the clipboard when Web Share is absent (desktop)', async () => { const writeText = vi.fn().mockResolvedValue(undefined); vi.stubGlobal('navigator', { clipboard: { writeText } }); expect(await shareText('diag', 'title')).toBe('copied'); expect(writeText).toHaveBeenCalledWith('diag'); }); it('reports failure without a fallback when the share is cancelled', async () => { const share = vi.fn().mockRejectedValue(new DOMException('cancelled', 'AbortError')); vi.stubGlobal('navigator', { share, canShare: () => true }); expect(await shareText('diag', 'title')).toBe('failed'); }); });