@linely-io/cranky-jsdom

Server HTML parsing and an adapter that owns and closes its JSDOM windows.

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

npm install @linely-io/cranky-jsdom

import { createEngine } from '@linely-io/cranky-core';
import { jsdomConnectionAdapter, parseDom } from '@linely-io/cranky-jsdom';
const document = await parseDom('<h1>Hello</h1>');
console.log(document.querySelector('h1').textContent);
const engine = createEngine(undefined, {
  connections: { page: { type: 'jsdom', config: { html: '<h1>Hello</h1>' } } },
  adapters: { jsdom: jsdomConnectionAdapter() },
});
// Select connection: 'page' for DOM actions, then await engine.close().

parseDom() returns a detached document; its temporary window is released. Use a session for a live window and document URL. Connection config accepts html and JSDOM options. Each session has its own document and DOM expression helpers. Browser-only interaction/rendering behavior is not emulated.

See package composition and connections.