@kdujs/server-renderer

Basic API

$3

Signature

``ts
function renderToString(
input: App | KNode,
context?: SSRContext
): Promise
`

Usage

`js
const { createSSRApp } = require('kdu')
const { renderToString } = require('@kdujs/server-renderer')

const app = createSSRApp({
data: () => ({ msg: 'hello' }),
template:

;(async () => {
const html = await renderToString(app)
console.log(html)
})()
`

$3

If the rendered app contains teleports, the teleported content will not be part of the rendered string. Instead, they are exposed under the teleports property of the ssr context object:

`js
const ctx = {}
const html = await renderToString(app, ctx)

console.log(ctx.teleports) // { '#teleported': 'teleported content' }
`

Streaming API

$3

Renders input as a Node.js Readable stream.

Signature

`ts
function renderToNodeStream(input: App | KNode, context?: SSRContext): Readable
`

Usage

`js
// inside a Node.js http handler
renderToNodeStream(app).pipe(res)
`

Note: This method is not supported in the ESM build of @kdujs/server-renderer, which is decoupled from Node.js environments. Use pipeToNodeWritable instead.

$3

Render and pipe to an existing Node.js Writable stream instance.

Signature

`ts
function pipeToNodeWritable(
input: App | KNode,
context: SSRContext = {},
writable: Writable
): void
`

Usage

`js
// inside a Node.js http handler
pipeToNodeWritable(app, {}, res)
`

$3

Renders input as a Web ReadableStream.

Signature

`ts
function renderToWebStream(
input: App | KNode,
context?: SSRContext
): ReadableStream
`

Usage

`js
// inside an environment with ReadableStream support
return new Response(renderToWebStream(app))
`

Note: in environments that do not expose ReadableStream constructor in the global scope, pipeToWebWritable should be used instead.

$3

Render and pipe to an existing Web WritableStream instance.

Signature

`ts
function pipeToWebWritable(
input: App | KNode,
context: SSRContext = {},
writable: WritableStream
): void
`

Usage

This is typically used in combination with TransformStream:

`js
// TransformStream is available in environments such as CloudFlare workers.
// in Node.js, TransformStream needs to be explicitly imported from 'stream/web'
const { readable, writable } = new TransformStream()
pipeToWebWritable(app, {}, writable)

return new Response(readable)
`

$3

Renders input in streaming mode using a simple readable interface.

Signature

`ts
function renderToSimpleStream(
input: App | KNode,
context: SSRContext,
options: SimpleReadable
): SimpleReadable

interface SimpleReadable {
push(content: string | null): void
destroy(err: any): void
}
`

Usage

`js
let res = ''

renderToSimpleStream(
app,
{},
{
push(chunk) {
if (chunk === null) {
// done
console(render complete: ${res})
} else {
res += chunk
}
},
destroy(err) {
// error encountered
}
}
)
``