# @vue/server-renderer

> @vue/server-renderer

Latest version **3.5.43** (published 2026-09-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install @vue/server-renderer
pnpm add @vue/server-renderer
yarn add @vue/server-renderer
bun add @vue/server-renderer
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo; extremely popular.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.5.43 |
| Published | 2026-09-17 |
| First published | 2019-12-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 408.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 54412 |
| Author | Evan You |
| Maintainers | yyx990803 |
| Keywords | vue |

## Links

- npm: https://www.npmjs.com/package/@vue/server-renderer
- Repository: https://github.com/vuejs/core
- Homepage: https://github.com/vuejs/core/tree/main/packages/server-renderer#readme
- Issues: https://github.com/vuejs/core/issues
- npm.io page: https://npm.io/package/@vue/server-renderer

## Dependencies (3)

- [@vue/shared](https://npm.io/package/@vue/shared.md) 3.5.43
- [@vue/runtime-dom](https://npm.io/package/@vue/runtime-dom.md) 3.5.43
- [@vue/compiler-ssr](https://npm.io/package/@vue/compiler-ssr.md) 3.5.43

## Recent versions

- 3.5.43 (latest) — 2026-09-17
- 3.6.0-rc.9 (rc) — 2026-09-18
- 3.6.0-beta.17 (beta) — 2026-06-24
- 3.6.0-alpha.7 (alpha) — 2025-12-12
- 3.6.0-rc.8 — 2026-09-11
- 3.6.0-rc.7 — 2026-09-04
- 3.6.0-rc.6 — 2026-08-28
- 3.5.42 — 2026-08-27
- 3.6.0-rc.5 — 2026-08-21
- 3.6.0-rc.4 — 2026-08-14
- 3.6.0-rc.3 — 2026-08-11
- 3.5.41 — 2026-08-05
- 3.6.0-rc.2 — 2026-07-22
- 3.6.0-rc.1 — 2026-07-18
- 3.5.40 — 2026-07-16
- … 282 more at https://npm.io/package/@vue/server-renderer/versions

## README

# @vue/server-renderer

**Note: as of 3.2.13+, this package is included as a dependency of the main `vue` package and can be accessed as `vue/server-renderer`. This means you no longer need to explicitly install this package and ensure its version matches that of `vue`'s. Just use the `vue/server-renderer` deep import instead.**

## Basic API

### `renderToString`

**Signature**

```ts
function renderToString(
  input: App | VNode,
  context?: SSRContext,
): Promise<string>
```

**Usage**

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

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

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

### Handling Teleports

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

### `renderToNodeStream`

Renders input as a [Node.js Readable stream](https://nodejs.org/api/stream.html#stream_class_stream_readable).

**Signature**

```ts
function renderToNodeStream(input: App | VNode, 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 `@vue/server-renderer`, which is decoupled from Node.js environments. Use `pipeToNodeWritable` instead.

### `pipeToNodeWritable`

Render and pipe to an existing [Node.js Writable stream](https://nodejs.org/api/stream.html#stream_writable_streams) instance.

**Signature**

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

**Usage**

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

### `renderToWebStream`

Renders input as a [Web ReadableStream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API).

**Signature**

```ts
function renderToWebStream(
  input: App | VNode,
  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.

### `pipeToWebWritable`

Render and pipe to an existing [Web WritableStream](https://developer.mozilla.org/en-US/docs/Web/API/WritableStream) instance.

**Signature**

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

**Usage**

This is typically used in combination with [`TransformStream`](https://developer.mozilla.org/en-US/docs/Web/API/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)
```

### `renderToSimpleStream`

Renders input in streaming mode using a simple readable interface.

**Signature**

```ts
function renderToSimpleStream(
  input: App | VNode,
  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.log(`render complete: ${res}`)
      } else {
        res += chunk
      }
    },
    destroy(err) {
      // error encountered
    },
  },
)
```

---
_Source: https://npm.io/package/@vue/server-renderer · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._