Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

3.1 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';

import { installExternalLinkGuard, isExternalNavigation } from './externalLinkGuard';
import { openUrl } from './openUrl';

vi.mock('./openUrl', () => ({ openUrl: vi.fn(() => Promise.resolve()) }));

const APP_ORIGIN = 'http://localhost:1420';

describe('isExternalNavigation', () => {
  it('flags a remote page, which is the one-way navigation we must stop', () => {
    expect(isExternalNavigation('https://example.com/built-site', APP_ORIGIN)).toBe(true);
  });

  it('leaves the app’s own hash routes alone', () => {
    expect(isExternalNavigation('#/settings/notifications', APP_ORIGIN)).toBe(false);
    expect(isExternalNavigation(`${APP_ORIGIN}/#/chat`, APP_ORIGIN)).toBe(false);
  });

  it('ignores non-http schemes — those are handled by their own components', () => {
    expect(isExternalNavigation('mailto:[email protected]', APP_ORIGIN)).toBe(false);
    expect(isExternalNavigation('data:text/html,<p>hi</p>', APP_ORIGIN)).toBe(false);
    expect(isExternalNavigation('openhuman://thread/1', APP_ORIGIN)).toBe(false);
  });
});

describe('installExternalLinkGuard', () => {
  let teardown: () => void = () => {};

  beforeEach(() => {
    vi.mocked(openUrl).mockClear();
    document.body.innerHTML = '';
  });

  afterEach(() => teardown());

  const clickAnchor = (html: string): MouseEvent => {
    document.body.innerHTML = html;
    const anchor = document.querySelector('a') as HTMLAnchorElement;
    const event = new MouseEvent('click', { bubbles: true, cancelable: true, button: 0 });
    anchor.dispatchEvent(event);
    return event;
  };

  it('stops an external link from navigating the webview and opens it outside', () => {
    teardown = installExternalLinkGuard();

    const event = clickAnchor('<a href="https://example.com/site">my site</a>');

    expect(event.defaultPrevented).toBe(true);
    expect(openUrl).toHaveBeenCalledWith('https://example.com/site');
  });

  it('lets in-app routes through untouched', () => {
    teardown = installExternalLinkGuard();

    const event = clickAnchor('<a href="#/chat">back to chat</a>');

    expect(event.defaultPrevented).toBe(false);
    expect(openUrl).not.toHaveBeenCalled();
    teardown();
  });

  // The chat bubble's own anchor already calls preventDefault + openUrl; if the
  // guard did not defer, one click would open two tabs.
  it('defers to a component that already handled the click itself', () => {
    teardown = installExternalLinkGuard();
    document.body.innerHTML = '<a href="https://example.com/site">handled</a>';
    const anchor = document.querySelector('a') as HTMLAnchorElement;
    anchor.addEventListener('click', e => e.preventDefault());

    anchor.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, button: 0 }));

    expect(openUrl).not.toHaveBeenCalled();
  });

  it('stops listening after teardown', () => {
    installExternalLinkGuard()();

    const event = clickAnchor('<a href="https://example.com/site">my site</a>');

    expect(event.defaultPrevented).toBe(false);
    expect(openUrl).not.toHaveBeenCalled();
  });
});