src/render/document.browser.ts

Functions

Imports

It imports no other module of this repo. No module of this repo imports it.

Source

1/**
2 * The browser's own document for Observable Plot to draw into, where a real one exists. Chosen
3 * by the `browser` condition of the `#document` import in package.json, which drops linkedom
4 * from client bundles. Runtimes that set that condition without having a document (some Worker
5 * bundlers do) are listed before it in package.json and get the server version; if one slips
6 * through, this says so rather than failing inside Plot.
7 */
8export function createDocument(): Document {
9  const real = (globalThis as { document?: Document }).document;
10  if (!real?.implementation) {
11    throw new Error(
12      "Enarratio's browser build needs a document, and this runtime has none. Bundle for the server " +
13        "(without the 'browser' condition) so Enarratio can use linkedom.",
14    );
15  }
16  return real.implementation.createHTMLDocument("");
17}