Resumen
') }, { name: 'activity', module: renderHtml(() => 'Actividad
') }, ]); console.log(result.errors); ``` 参考：`src/server/wu-server-render.js`. ## renderStateScript 将状态序列化到 script，客户端 hydration 时可恢复。 `renderStateScript(state, options?): string` - **参数：** 可序列化 state；JavaScript 标识符 varName、布尔 merge、可选 nonce。 - **返回值：** 完整 script 标签。 - **错误：** 无效 varName、无效 nonce 或 JSON.stringify 无法序列化的值会被拒绝。 - **权限：** 不使用浏览器 grants；服务器应用控制模块、数据和响应头。 - **清理：** 不创建 listeners 或持久客户端 runtime。 ```js import { renderStateScript } from 'wu-framework/server'; const script = renderStateScript({ card: { title: 'Resumen' } }, { merge: true }); ``` 不要放入秘密，此状态在响应 HTML 中可见。 参考：`src/server/wu-server-render.js`. ## declarativeShadowDomPolyfill 缺少原生支持时，为带 shadowrootmode 的 templates 生成兼容 script。 `declarativeShadowDomPolyfill(options?): string` - **参数：** 可选 options.nonce。 - **返回值：** script HTML；调用 helper 不会执行它。 - **错误：** 无效 nonce 在构造属性时失败。 - **权限：** 不使用浏览器 grants；服务器应用控制模块、数据和响应头。 - **清理：** 不创建 listeners 或持久客户端 runtime。 ```js import { declarativeShadowDomPolyfill } from 'wu-framework/server'; const script = declarativeShadowDomPolyfill({ nonce }); ``` script 应输出在待转换内容之后；它不是观察未来 templates 的 observer。 参考：`src/server/wu-server-render.js`. ## escapeHtml 转义 &、标签符号和引号，供 HTML 文本或属性使用。 `escapeHtml(value): string` - **参数：** 任意值；null 和 undefined 转为空字符串。 - **返回值：** 转义后的字符串。 - **错误：** 字符串转换可能传播值自身的错误。 - **权限：** 不使用浏览器 grants；服务器应用控制模块、数据和响应头。 - **清理：** 不创建 listeners 或持久客户端 runtime。 ```js import { escapeHtml } from 'wu-framework/server'; escapeHtml('Listo
`, { headers: { 'Content-Type': 'text/html' } }); }); ``` 参考：`src/server/wu-security-headers.js`. ## renderReact 将 React renderer 适配为 renderApp 契约。 `renderReact(ComponentOrFn, options?): { render(props): Promise${Number(count)}
`); const result = await renderApp('card', { module, props: { count: 2 } }); ``` 返回 HTML 不经过净化，插值前请转义外部内容。 参考：`src/server/adapters.js`. ## createServerRequest `createServerRequest(options?): WuServerRequest` 创建每次请求私有的上下文，包含 `signal`、`locals`、`renderApp`、`renderApps`、`stream` 和 `dispose`。接受包括 `request` 在内的批处理选项，并将其信号与 `options.signal` 组合。不要在模块全局作用域创建该对象。`dispose(reason)` 会中止、释放 listeners 并清空 `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)` 接收 `{ appName, signal, request, locals }`，返回 `{ props?, publicState? }`。使用 loader 时，仅 `publicState` 成为水合状态；私有 props 和 renderer 返回的 `state` 都不会自动发布。不使用 loader 时保留 renderer 的 `state`。这无法阻止 renderer 自身将秘密写入 HTML。 ## SSR 取消、时限与并发 `renderApp`、`renderApps` 和 `renderAppsStream` 接受 `signal` 和包含 loader 在内的每应用 `timeout`；`timeout: 0` 关闭时限。批次和流接受 `concurrency`，默认无限制。中止会保留 `signal.reason`；未提供原因时使用 `WU_SSR_ABORTED`。超时产生 `WU_SSR_TIMEOUT`。Renderers 和 loaders 必须配合 `context.signal` 停止工作。 未启用 `failFast` 时，单个应用失败允许部分降级；使用 `failFast: true` 时中止批次。取消流会将中止传播给待处理工作。返回 HTTP 流时，应保留上下文直到消费完成或取消；不要在构造响应后立即调用 `dispose()`。 ```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 }); ```