Resumen
') }, { name: 'activity', module: renderHtml(() => 'Actividad
') }, ]); console.log(result.errors); ``` Referência: `src/server/wu-server-render.js`. ## renderStateScript Serializa o estado em um script que o cliente pode recuperar durante a hidratação. `renderStateScript(state, options?): string` - **Parâmetros:** state serializável; varName identificador JavaScript, merge boolean, nonce opcional. - **Retorno:** Tag script completa. - **Erros:** Rejeita varName inválido, nonce inválido ou valores que JSON.stringify não possa serializar. - **Permissões:** Não usa concessões do navegador; a aplicação servidor controla módulos, dados e cabeçalhos. - **Limpeza:** Não cria listeners nem um runtime cliente persistente. ```js import { renderStateScript } from 'wu-framework/server'; const script = renderStateScript({ card: { title: 'Resumen' } }, { merge: true }); ``` Não inclua segredos: esse estado é visível no HTML da resposta. Referência: `src/server/wu-server-render.js`. ## declarativeShadowDomPolyfill Gera um script de compatibilidade para templates com shadowrootmode quando não há suporte nativo. `declarativeShadowDomPolyfill(options?): string` - **Parâmetros:** options.nonce opcional. - **Retorno:** HTML de um script; não o executa ao chamar o helper. - **Erros:** Um nonce inválido falha na construção do atributo. - **Permissões:** Não usa concessões do navegador; a aplicação servidor controla módulos, dados e cabeçalhos. - **Limpeza:** Não cria listeners nem um runtime cliente persistente. ```js import { declarativeShadowDomPolyfill } from 'wu-framework/server'; const script = declarativeShadowDomPolyfill({ nonce }); ``` Emita o script depois do conteúdo que deve converter; ele não observa templates futuros. Referência: `src/server/wu-server-render.js`. ## escapeHtml Escapa ampersand, sinais de tag e aspas para texto ou atributos HTML. `escapeHtml(value): string` - **Parâmetros:** Qualquer valor; null e undefined são convertidos em string vazia. - **Retorno:** String escapada. - **Erros:** A coerção para string pode propagar um erro do próprio valor. - **Permissões:** Não usa concessões do navegador; a aplicação servidor controla módulos, dados e cabeçalhos. - **Limpeza:** Não cria listeners nem um runtime cliente persistente. ```js import { escapeHtml } from 'wu-framework/server'; escapeHtml('Listo
`, { headers: { 'Content-Type': 'text/html' } }); }); ``` Referência: `src/server/wu-security-headers.js`. ## renderReact Adapta o renderizador do React ao contrato de renderApp. `renderReact(ComponentOrFn, options?): { render(props): Promise${Number(count)}
`); const result = await renderApp('card', { module, props: { count: 2 } }); ``` O HTML retornado não é sanitizado. Escape o conteúdo externo antes de interpolá-lo. Referência: `src/server/adapters.js`. ## createServerRequest `createServerRequest(options?): WuServerRequest` Cria um contexto privado por requisição com `signal`, `locals`, `renderApp`, `renderApps`, `stream` e `dispose`. Aceita opções de lote, incluindo `request`, e combina seu sinal com `options.signal`. Não crie esse objeto no escopo global do módulo. `dispose(reason)` aborta, libera listeners e limpa `locals`. ```js import { createServerRequest, renderStateScript, escapeHtml, withSecurityHeaders } from 'wu-framework/server'; export const GET = withSecurityHeaders(async (request, { nonce }) => { const scope = createServerRequest({ request, nonce, timeout: 2000, concurrency: 2 }); try { scope.locals.set('requestId', crypto.randomUUID()); const rendered = await scope.renderApps([{ name: 'greeting', load: async ({ signal }) => { signal.throwIfAborted(); return { props: { label: 'Hello' }, publicState: { label: 'Hello' } }; }, module: { render: props => '' + escapeHtml(props.label) + '
' }, }]); return new Response(rendered.html + renderStateScript(rendered.state, { nonce }), { headers: { 'Content-Type': 'text/html; charset=utf-8' }, }); } finally { scope.dispose(); } }); ``` `load(context)` recebe `{ appName, signal, request, locals }` e retorna `{ props?, publicState? }`. Com loader, apenas `publicState` vira estado de hidratação; nem props privadas nem o `state` retornado pelo renderer são publicados automaticamente. Sem loader, o `state` do renderer é preservado. Isso não impede o próprio renderer de escrever um segredo no HTML. ## Cancelamento, prazos e concorrência SSR `renderApp`, `renderApps` e `renderAppsStream` aceitam `signal` e `timeout` por app, incluindo o loader; `timeout: 0` desativa o prazo. Lotes e streams aceitam `concurrency`, ilimitada por padrão. O aborto preserva `signal.reason`; sem motivo fornecido usa `WU_SSR_ABORTED`. Vencer o prazo produz `WU_SSR_TIMEOUT`. Renderers e loaders devem cooperar com `context.signal` para parar seu trabalho. Sem `failFast`, uma falha de app permite degradação parcial; com `failFast: true`, o lote é abortado. Cancelar o stream propaga o aborto ao trabalho pendente. Ao retornar um stream HTTP, mantenha o contexto até o consumo terminar ou ser cancelado; não chame `dispose()` logo após construir a resposta. ```js // Reusable wrappers: a function generates a new nonce for each request. wuSecurityMiddleware({ nonce: () => createNonce() }); withSecurityHeaders(handler, { nonce: () => createNonce() }); // Low-level helpers still accept the nonce of this response. const nonce = createNonce(); const headers = securityHeaders({ nonce }); ```