@gluonjs/ssr / packages/ssr/src / SsrRenderError

Class: SsrRenderError

Extends

Error

Constructors

Constructor

new SsrRenderError(code, message): SsrRenderError

Parameters

code

"GLUON_SSR_INVALID_VALUE" | "GLUON_SSR_UNSUPPORTED_DIRECTIVE"

message

string

Returns

SsrRenderError

Overrides

Error.constructor

Properties

code

readonly code: "GLUON_SSR_INVALID_VALUE" | "GLUON_SSR_UNSUPPORTED_DIRECTIVE"

Example

Catch a server-rendering value or directive failure by stable diagnostic code while retaining its human explanation:

import { html } from '@gluonjs/core';
import {
  SsrRenderError,
  prepareForHydration,
  renderProgressively,
  renderToChunks,
  renderToString,
  type PreparedHydration,
  type ProgressiveRenderChunk,
  type ProgressiveRenderOptions,
} from '@gluonjs/ssr';

const product = html`<article><h1>Orbit lamp</h1><p>€129</p></article>`;
const prepared: PreparedHydration = await prepareForHydration(product);
const complete = await renderToString(prepared.value);
let chunked = '';
for await (const chunk of renderToChunks(prepared.value)) chunked += chunk;
const controller = new AbortController();
const options = { signal: controller.signal } satisfies ProgressiveRenderOptions;
for await (const chunk of renderProgressively(prepared.value, options)) {
  const progressive: ProgressiveRenderChunk = chunk;
  console.log(progressive.kind, progressive.html);
}
if (complete !== chunked) throw new SsrRenderError('GLUON_SSR_INVALID_VALUE', 'Chunk output changed.');