@marimo-team/islands 0.15.1-dev32 → 0.15.1-dev34

package/src/core/dom/outline.ts

@@ -8,9 +8,23 @@ import type { OutputMessage } from "../kernel/messages";
 // Tags that we don't want to include in the outline
 const excludedTags = ["marimo-carousel", "marimo-tabs", "marimo-accordion"];
 
-function getOutline(html: string): Outline {
-  const items: Outline["items"] = [];
+/**
+ * Extracts a table of contents {@link Outline} from an HTML string.
+ *
+ * Each {@link OutlineItem} corresponds to a heading (h1–h6) found in the input.
+ *
+ * @param html - The HTML content to parse.
+ * @returns An {@link Outline}, otherwise `null` if parsing via isn't supported in JS runtime (e.g., Node).
+ */
+function getOutline(html: string): Outline | null {
+  // Some JS runtimes (e.g. Node.js for the VSCode extension) do not
+  // expose DOMParser globally. In those environments parsing isn't
+  // possible (without a polyfill), so return just return `null`.
+  if (typeof DOMParser === "undefined") {
+    return null;
+  }
 
+  const items: Outline["items"] = [];
   const parser = new DOMParser();
   const document = parser.parseFromString(html, "text/html");