logo
  • 指南
  • 配置
  • 插件
  • API
  • 示例
  • 社区
  • Modern.js 2.x 文档
  • 简体中文
    • 简体中文
    • English
    • 命令
      文件约定
      src/
      App.[tj]sx
      entry.[tj]s
      entry.server.[tj]sx
      modern.runtime.[tj]s
      routes/
      *.[server|node].[tj]sx
      api/
      lambda/*.[tj]s
      server/
      modern.server.[tj]s
      shared/
      config/
      html/
      favicon.*
      icon.*
      mock/
      public/
      upload/
      modern.config.[tj]s
      运行时
      Core
      createRoot
      render
      Router
      router
      SSR
      NoSSR
      renderStreaming
      renderString
      createRequestHandler
      BFF
      useHonoContext
      Utility
      CSS-In-JS API
      Head
      loadable
      📝 编辑此页面
      上一页NoSSR下一页renderString

      #renderStreaming

      用于 React v18+ Streaming SSR 渲染出可读流, 配合 createRequestHandler 使用

      #使用

      src/entry.server.tsx
      import {
        renderStreaming,
        createRequestHandler,
      } from '@modern-js/runtime/ssr/server';
      
      const handleRequest = async (request, ServerRoot, options) => {
        const stream = await renderStreaming(request, <ServerRoot />, options);
      
        return new Response(stream, {
          headers: {
            'content-type': 'text/html; charset=utf-8',
          },
        });
      };
      
      export default createRequestHandler(handleRequest);

      #函数签名

      export type RenderStreaming = (
        request: Request,
        serverRoot: React.ReactElement,
        optinos: RenderOptions,
      ) => Promise<ReadableStream>;

      #示例

      src/entry.server.tsx
      import {
        renderStreaming,
        createRequestHandler,
      } from '@modern-js/runtime/ssr/server';
      
      const handleRequest = async (request, ServerRoot, options) => {
        // do something before render
        const stream = await renderStreaming(request, <ServerRoot />, options);
      
        // docs: https://developer.mozilla.org/en-US/docs/Web/API/TransformStream
        const transformStream = new TransformStream({
          transform(chunk, controller) {
            // do some transform
          },
        });
      
        stream.pipeThrough(transformStream);
      
        return new Response(transformStream.readable, {
          headers: {
            'content-type': 'text/html; charset=utf-8',
          },
        });
      };
      
      export default createRequestHandler(handleRequest);