@linely-io/cranky-browser

Core plus DOM actions, browser expression helpers, and a borrowed current-browser session. Does not install SSH, JSDOM, or screenshot renderers.

Requires Node.js 24+ for backend use and ES modules.

npm install @linely-io/cranky-browser

import { createEngine } from '@linely-io/cranky-browser';
const engine = createEngine();
try {
  const run = await engine.run({
    actions: [{ id: 'return', run: 'doc.select', params: 'h1', transform: 't.textContent' }],
  });
  if (run.error) throw run.error;
  console.log(run.toResultValue());
} finally {
  await engine.close();
}

The default connection is browser. Closing its borrowed session does not close the application window. Screenshots require @linely-io/cranky-screenshot. The ./env and ./document subpaths expose environment and document helpers for extensions.

See package composition and connections.