browser.ts#

Chromium browser session with automatic cleanup via Explicit Resource Management.

Usage: await using session = await openBrowser(); const png = await session.renderPage(html, 1200, 630); // browser.close() is called automatically when session goes out of scope

A set of independent sessions, closed together.

A browser session that can render HTML pages to PNG. Implements AsyncDisposable for automatic cleanup via await using.

Opens a Chromium browser and returns a session for rendering OG images. Returns null if Playwright/Chromium is not available.

The session implements AsyncDisposable — use await using for automatic cleanup:

await using session = await openBrowser();
if (!session) return;
const png = await session.renderPage(html, 1200, 630);

Opens up to size independent browsers.

Rendering does not parallelize inside one browser: every page shares a single connection to it, so eight pages in one browser finish no sooner than one does. Measured on 120 cards, milliseconds per image:

browsers 1 2 4 8 pages 1 84.6 — 25.6 14.7 pages 8 80.5 42.0 23.1 —

Pages buy nothing; browsers scale nearly linearly. Each one costs its own process, so this is bounded by the caller's concurrency, and concurrency: 1 keeps the old single-process footprint.

Returns null when Chromium cannot be launched at all. A launch that fails after the first still yields a working pool, one browser smaller.

A pooled page and the public directory its route handler was set up for.