useSSRContext() Acessar o contexto SSR

Última atualização: 2026-10-22

useSSRContext() Acessar o contexto SSR

useSSRContext() recupera o contexto SSR durante a renderização no servidor, permitindo levar dados para a hidratação no cliente.

GrupoFunções de Renderização e SSR
TipoAPI
EscopoNo Componente
Versão do Vue3.0+
Suporte a SSRSim

📝 Sintaxe

import { useSSRContext } from "vue"
const ctx = useSSRContext()
ctx.state = { user: "Ana" }

Retorno:O objeto de contexto SSR (somente no servidor)

▶ Exemplo

Edite o código abaixo e veja o resultado ao vivo:

Saída:

Shows the SSR notice.

💡 Pontos-chave

ℹ️ Nota Somente no servidor — sempre proteja o acesso.
💡 Dica Tipicamente usado para embutir estado pré-buscado para a hidratação.
⚠️ Aviso Proteja o acesso — pode ser undefined.
Mais casos em breve.

📚 Tutoriais Relacionados

❓ FAQ

P Lança erro no cliente?
R Não — retorna undefined.
P Relação com o estado da store?
R Snapshots do servidor vão para o ctx e são relidos no cliente.
P Dá para armazenar funções?
R Mantenha tudo serializável.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%