Skip to content

Commit d067c79

Browse files
YucohnyXleine
and
Xleine
authored
docs(cn): translate reference/react-dom/server/renderToNodeStream into Chinese (#1205)
Co-authored-by: Xleine <919143384@qq.com>
1 parent 96a79ed commit d067c79

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

src/content/reference/react-dom/server/renderToNodeStream.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@ title: renderToNodeStream
44

55
<Deprecated>
66

7-
This API will be removed in a future major version of React. Use [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) instead.
7+
API 将在未来的 React 主要版本中被移除,请使用 [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream)
88

99
</Deprecated>
1010

1111
<Intro>
1212

13-
`renderToNodeStream` renders a React tree to a [Node.js Readable Stream.](https://nodejs.org/api/stream.html#readable-streams)
13+
`renderToNodeStream` 可以为 [Node.js 只读流](https://nodejs.org/api/stream.html#readable-streams) 渲染 React 树。
1414

1515
```js
1616
const stream = renderToNodeStream(reactNode)
@@ -22,11 +22,11 @@ const stream = renderToNodeStream(reactNode)
2222

2323
---
2424

25-
## Reference {/*reference*/}
25+
## 参考 {/*reference*/}
2626

2727
### `renderToNodeStream(reactNode)` {/*rendertonodestream*/}
2828

29-
On the server, call `renderToNodeStream` to get a [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) which you can pipe into the response.
29+
在服务端调用 `renderToNodeStream` 获取 [Node.js 只读流](https://nodejs.org/api/stream.html#readable-streams),你也可以将其管道(pipe)传输到响应中。
3030

3131
```js
3232
import { renderToNodeStream } from 'react-dom/server';
@@ -35,42 +35,42 @@ const stream = renderToNodeStream(<App />);
3535
stream.pipe(response);
3636
```
3737

38-
On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to make the server-generated HTML interactive.
38+
在客户端调用 [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) 使由服务器生成的 HTML 具有交互功能。
3939

40-
[See more examples below.](#usage)
40+
[参见下面更多示例](#usage)
4141

42-
#### Parameters {/*parameters*/}
42+
#### 参数 {/*parameters*/}
4343

44-
* `reactNode`: A React node you want to render to HTML. For example, a JSX element like `<App />`.
44+
* `reactNode`:想要渲染为 HTML 的 React 节点。比如像 `<App />` 一样的 JSX 元素。
4545

46-
#### Returns {/*returns*/}
46+
#### 返回值 {/*returns*/}
4747

48-
A [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) that outputs an HTML string.
48+
输出 HTML 字符串的 [Node.js 只读流](https://nodejs.org/api/stream.html#readable-streams)
4949

50-
#### Caveats {/*caveats*/}
50+
#### 注意 {/*caveats*/}
5151

52-
* This method will wait for all [Suspense boundaries](/reference/react/Suspense) to complete before returning any output.
52+
* 此方法会等待所有 [Suspense 边界](/reference/react/Suspense) 完成后才返回输出。
5353

54-
* As of React 18, this method buffers all of its output, so it doesn't actually provide any streaming benefits. This is why it's recommended that you migrate to [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) instead.
54+
* React 18 开始,此方法会缓冲所有输出,因此实际上它并没有提供任何流式传输的好处。这就是为什么建议改用 [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream)
5555

56-
* The returned stream is a byte stream encoded in utf-8. If you need a stream in another encoding, take a look at a project like [iconv-lite](https://www.npmjs.com/package/iconv-lite), which provides transform streams for transcoding text.
56+
* 返回的是一个 utf-8 编码的字节流。如果你需要其他编码格式的流,请参考 [iconv-lite](https://www.npmjs.com/package/iconv-lite) 这样的项目,它提供了用于转码文本的转换流。
5757

5858
---
5959

60-
## Usage {/*usage*/}
60+
## 用法 {/*usage*/}
6161

62-
### Rendering a React tree as HTML to a Node.js Readable Stream {/*rendering-a-react-tree-as-html-to-a-nodejs-readable-stream*/}
62+
### Node.js 只读流将 React 树渲染为 HTML {/*rendering-a-react-tree-as-html-to-a-nodejs-readable-stream*/}
6363

64-
Call `renderToNodeStream` to get a [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) which you can pipe to your server response:
64+
调用 `renderToNodeStream` 获取 [Node.js 只读流](https://nodejs.org/api/stream.html#readable-streams),你也可以将其管道(pipe)传输到服务器响应中。
6565

6666
```js {5-6}
6767
import { renderToNodeStream } from 'react-dom/server';
6868

69-
// The route handler syntax depends on your backend framework
69+
// 路由处理程序的语法取决于使用的后端框架。
7070
app.use('/', (request, response) => {
7171
const stream = renderToNodeStream(<App />);
7272
stream.pipe(response);
7373
});
7474
```
7575

76-
The stream will produce the initial non-interactive HTML output of your React components. On the client, you will need to call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to *hydrate* that server-generated HTML and make it interactive.
76+
这里的流会将 React 组件初始输出为非交互式 HTML。在客户端上,你需要调用 [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) 方法来 hydrate 服务器生成的 HTML 并使其具有交互功能。

0 commit comments

Comments
 (0)