Skip to content

Explainer videos and product demos made by your AI agent. Free and open source: a local voice (Kokoro), word timing (Whisper) and a canvas renderer turn a script into a narrated MP4.

4.3 KB
Raw Blame
import test from 'node:test';
import assert from 'node:assert/strict';
import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import http from 'node:http';
import { findChrome } from '../src/browser.js';

test('finds the headless shell that Playwright installs on Windows', () => {
  const base = fs.mkdtempSync(path.join(os.tmpdir(), 'explainroo-pw-'));
  const exe = path.join(base, 'chromium_headless_shell-1300', 'chrome-headless-shell-win64', 'chrome-headless-shell.exe');
  fs.mkdirSync(path.dirname(exe), { recursive: true });
  fs.writeFileSync(exe, '');
  const saved = { pw: process.env.PLAYWRIGHT_BROWSERS_PATH, ex: process.env.EXPLAINROO_CHROME, cp: process.env.CHROME_PATH };
  try {
    process.env.PLAYWRIGHT_BROWSERS_PATH = base;
    delete process.env.EXPLAINROO_CHROME;
    delete process.env.CHROME_PATH;
    assert.equal(findChrome(), exe);
  } finally {
    for (const [k, v] of [['PLAYWRIGHT_BROWSERS_PATH', saved.pw], ['EXPLAINROO_CHROME', saved.ex], ['CHROME_PATH', saved.cp]]) {
      if (v === undefined) delete process.env[k];
      else process.env[k] = v;
    }
    fs.rmSync(base, { recursive: true, force: true });
  }
});

let chrome;
try { chrome = findChrome(); } catch {}

test('a page load that hangs is tried once more with a fresh page', { skip: !chrome }, async () => {
  const { launch, openEngine } = await import('../src/browser.js');
  let requests = 0;
  const hung = [];
  const server = http.createServer((req, res) => {
    if (!req.url.startsWith('/frame.html')) return res.writeHead(404).end();
    // The first load never answers, like a stalled page on a busy machine.
    if (++requests === 1) return hung.push(res);
    res.writeHead(200, { 'content-type': 'text/html' }).end('<script>window.explainrooReady = Promise.resolve();</script>');
  });
  await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
  const browser = await launch();
  try {
    // Long enough for the second page to load on a busy CI machine.
    const page = await openEngine(browser, `http://127.0.0.1:${server.address().port}`, { timeout: 5000 });
    assert.equal(requests, 2);
    assert.equal(browser.contexts().flatMap((c) => c.pages()).length, 1);
    assert.equal(await page.evaluate(() => typeof window.explainrooReady), 'object');
    requests = 0;
    server.removeAllListeners('request');
    server.on('request', (req, res) => hung.push(res));
    await assert.rejects(openEngine(browser, `http://127.0.0.1:${server.address().port}`, { timeout: 500 }), { name: 'TimeoutError' });
  } finally {
    await browser.close();
    for (const res of hung) res.destroy();
    server.closeAllConnections();
    await new Promise((resolve) => server.close(resolve));
  }
});

test('a page that loads without its scripts is tried once more', { skip: !chrome }, async () => {
  const { launch, openEngine } = await import('../src/browser.js');
  let pages = 0;
  const server = http.createServer((req, res) => {
    if (req.url.startsWith('/missing.js')) return res.writeHead(404).end();
    if (!req.url.startsWith('/frame.html')) return res.writeHead(404).end();
    // The first page's module script cannot load, so the engine never starts.
    const script = ++pages === 1 ? "import '/missing.js'; window.explainrooReady = Promise.resolve();" : 'window.explainrooReady = Promise.resolve();';
    res.writeHead(200, { 'content-type': 'text/html' }).end(`<script type="module">${script}</script>`);
  });
  await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
  const browser = await launch();
  try {
    const page = await openEngine(browser, `http://127.0.0.1:${server.address().port}`, { timeout: 5000 });
    assert.equal(pages, 2);
    assert.equal(browser.contexts().flatMap((c) => c.pages()).length, 1);
    assert.equal(await page.evaluate(() => typeof window.explainrooReady), 'object');
    // When it never starts, the error says so.
    pages = 0;
    server.removeAllListeners('request');
    server.on('request', (req, res) => res.writeHead(200, { 'content-type': 'text/html' }).end('<p>no engine</p>'));
    await assert.rejects(openEngine(browser, `http://127.0.0.1:${server.address().port}`, { timeout: 5000 }), /scripts did not/);
  } finally {
    await browser.close();
    server.closeAllConnections();
    await new Promise((resolve) => server.close(resolve));
  }
});