Resumen
') }, { name: 'activity', module: renderHtml(() => 'Actividad
') }, ]); console.log(result.errors); ``` Referencia: `src/server/wu-server-render.js`. ## renderStateScript Serializa estado en un script que el cliente puede recuperar durante hidratación. `renderStateScript(state, options?): string` - **Parámetros:** state serializable; varName identificador JavaScript, merge boolean, nonce opcional. - **Retorno:** Etiqueta script completa. - **Errores:** Rechaza varName inválido, nonce inválido o valores que JSON.stringify no pueda serializar. - **Permisos:** No utiliza grants del navegador; la aplicación servidor controla módulos, datos y cabeceras. - **Limpieza:** No crea listeners ni un runtime cliente persistente. ```js import { renderStateScript } from 'wu-framework/server'; const script = renderStateScript({ card: { title: 'Resumen' } }, { merge: true }); ``` No introduzcas secretos: este estado es visible en el HTML de la respuesta. Referencia: `src/server/wu-server-render.js`. ## declarativeShadowDomPolyfill Genera un script de compatibilidad para templates con shadowrootmode cuando no hay soporte nativo. `declarativeShadowDomPolyfill(options?): string` - **Parámetros:** options.nonce opcional. - **Retorno:** HTML de un script; no lo ejecuta al llamar al helper. - **Errores:** Un nonce inválido falla en la construcción del atributo. - **Permisos:** No utiliza grants del navegador; la aplicación servidor controla módulos, datos y cabeceras. - **Limpieza:** No crea listeners ni un runtime cliente persistente. ```js import { declarativeShadowDomPolyfill } from 'wu-framework/server'; const script = declarativeShadowDomPolyfill({ nonce }); ``` Emite el script después del contenido que deba convertir; no es un observador de templates futuros. Referencia: `src/server/wu-server-render.js`. ## escapeHtml Escapa ampersand, signos de etiqueta y comillas para texto o atributos HTML. `escapeHtml(value): string` - **Parámetros:** Cualquier valor; null y undefined se convierten en cadena vacía. - **Retorno:** Cadena escapada. - **Errores:** La coerción a string puede propagar un error del propio valor. - **Permisos:** No utiliza grants del navegador; la aplicación servidor controla módulos, datos y cabeceras. - **Limpieza:** No crea listeners ni un runtime cliente persistente. ```js import { escapeHtml } from 'wu-framework/server'; escapeHtml('Listo
`, { headers: { 'Content-Type': 'text/html' } }); }); ``` Referencia: `src/server/wu-security-headers.js`. ## renderReact Adapta el renderer de React al contrato de renderApp. `renderReact(ComponentOrFn, options?): { render(props): Promise${Number(count)}
`); const result = await renderApp('card', { module, props: { count: 2 } }); ``` El HTML retornado no se sanea. Escapa contenido externo antes de interpolarlo. Referencia: `src/server/adapters.js`. ## createServerRequest `createServerRequest(options?): WuServerRequest` Crea un contexto privado por petición con `signal`, `locals`, `renderApp`, `renderApps`, `stream` y `dispose`. Acepta las opciones de lote, incluido `request`; combina su señal con `options.signal`. No crees este objeto en el scope global del módulo. `dispose(reason)` aborta, libera listeners y vacía `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)` recibe `{ appName, signal, request, locals }` y devuelve `{ props?, publicState? }`. Si hay loader, solo `publicState` sale como estado de hidratación; ni las props privadas ni el `state` devuelto por el renderer se publican automáticamente. Sin loader se conserva el `state` del renderer. Esto no impide que el propio renderer escriba un secreto en el HTML. ## Cancelación, plazos y concurrencia SSR `renderApp`, `renderApps` y `renderAppsStream` aceptan `signal` y `timeout` por app, incluido el loader; `timeout: 0` desactiva el plazo. Los lotes y streams aceptan `concurrency`, ilimitada por defecto. El aborto conserva `signal.reason`; sin razón propia usa `WU_SSR_ABORTED`. Vencer el plazo produce `WU_SSR_TIMEOUT`. Los renderers y loaders deben cooperar con `context.signal` para detener su trabajo. Sin `failFast`, un fallo por app permite degradación parcial; con `failFast: true` se aborta el lote. Cancelar el stream propaga el aborto al trabajo pendiente. Al devolver un stream HTTP, conserva el contexto hasta que termine o se cancele su consumo; no llames `dispose()` inmediatamente después de construir la respuesta. ```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 }); ```