renderToString() Renderizar para string HTML
Última atualização: 2026-10-22
renderToString() Renderizar para string HTML
renderToString() renderiza um app como uma string HTML no servidor — a etapa de saída do SSR, hidratada pelo createSSRApp no cliente.
| Grupo | Funções de Renderização e SSR |
|---|---|
| Tipo | API |
| Escopo | Global |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
import { renderToString } from "vue/server-renderer"
const html = await renderToString(app)⚙️ Argumentos
| app, context? | Uma instância de app (opcionalmente com um contexto SSR) |
|---|
Retorno：Promise
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows the SSR notice (real rendering happens in Node).💡 Pontos-chave
ℹ️ Nota Importado de vue/server-renderer — apenas Node.
💡 Dica Combina com onServerPrefetch e useSSRContext.
⚠️ Aviso Sem acesso a window ou document em SSR.
🏷️ Funções de Renderização e SSR relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Dá para usar no navegador?
R Não — é apenas para Node.
P Relação com o Nuxt?
R O Nuxt encapsula exatamente esse pipeline.
P O que a saída inclui?
R HTML mais o estado serializado para hidratação.
