From ea12a52f8eb0ed8321378ab5ab6fc19b34fbf386 Mon Sep 17 00:00:00 2001 From: GoncharovaAnna <38956075+GoncharovaAnna@users.noreply.github.com> Date: Wed, 3 May 2023 18:51:56 +0300 Subject: [PATCH 1/3] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B2=D1=8B=D0=B5=20?= =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../react-dom/server/renderToNodeStream.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/src/content/reference/react-dom/server/renderToNodeStream.md b/src/content/reference/react-dom/server/renderToNodeStream.md index a4ab2e570..4bfc8616e 100644 --- a/src/content/reference/react-dom/server/renderToNodeStream.md +++ b/src/content/reference/react-dom/server/renderToNodeStream.md @@ -4,13 +4,13 @@ title: renderToNodeStream -This API will be removed in a future major version of React. Use [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) instead. +Этот API будет удален в будущей основной версии React. Лучше использовать вместо него [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream). -`renderToNodeStream` renders a React tree to a [Node.js Readable Stream.](https://nodejs.org/api/stream.html#readable-streams) +`renderToNodeStream` отображает дерево React в [Node.js Readable Stream.](https://nodejs.org/api/stream.html#readable-streams) ```js const stream = renderToNodeStream(reactNode) @@ -22,11 +22,11 @@ const stream = renderToNodeStream(reactNode) --- -## Reference {/*reference*/} +## Справка {/*reference*/} ### `renderToNodeStream(reactNode)` {/*rendertonodestream*/} -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. +На сервере вызовите `renderToNodeStream`, чтобы получить [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams), который вы можете передать в ответ. ```js import { renderToNodeStream } from 'react-dom/server'; @@ -35,42 +35,42 @@ const stream = renderToNodeStream(); stream.pipe(response); ``` -On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to make the server-generated HTML interactive. +На клиенте вызовите [`hydrateRoot`](/reference/react-dom/client/hydrateRoot), чтобы сделать интерактивный HTML-код, созданный сервером. -[See more examples below.](#usage) +[Больше примеров ниже.](#usage) -#### Parameters {/*parameters*/} +#### Параметры {/*parameters*/} -* `reactNode`: A React node you want to render to HTML. For example, a JSX element like ``. +* `reactNode`: Узел React, который вы хотите отобразить в HTML. Например, такой JSX элемент как ``. -#### Returns {/*returns*/} +#### Возвращает {/*returns*/} -A [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) that outputs an HTML string. +[Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams), который выводит строку HTML. -#### Caveats {/*caveats*/} +#### Предупреждения {/*caveats*/} -* This method will wait for all [Suspense boundaries](/reference/react/Suspense) to complete before returning any output. +* Этот метод будет ждать всех [Suspense boundaries](/reference/react/Suspense), прежде чем возвращать какие-либо данные. -* 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. +* Начиная с React 18, этот метод буферизует все выходные данные, поэтому на самом деле он не дает никаких преимуществ потоковой передачи. Поэтому вместо этого рекомендуется перейти на [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) -* 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. +* Возвращаемый поток представляет собой поток байтов, закодированный в utf-8. Если вам нужен поток в другой кодировке, взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite), который предоставляет потоки преобразования для перекодирования текста. --- -## Usage {/*usage*/} +## Применение {/*usage*/} -### Rendering a React tree as HTML to a Node.js Readable Stream {/*rendering-a-react-tree-as-html-to-a-nodejs-readable-stream*/} +### Рендеринг дерева React как HTML в Node.js Readable Stream {/*rendering-a-react-tree-as-html-to-a-nodejs-readable-stream*/} -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: +Вызовите `renderToNodeStream`, чтобы получить [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams), который вы можете передать вашему серверу: ```js {5-6} import { renderToNodeStream } from 'react-dom/server'; -// The route handler syntax depends on your backend framework +// Синтаксис обработчика маршрута зависит от вашей внутренней структуры app.use('/', (request, response) => { const stream = renderToNodeStream(); stream.pipe(response); }); ``` -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. +Поток произведёт начальный неинтерактивный HTML—вывод ваших компонентов React. На клиенте вам нужно будет вызвать [`hydrateRoot`](/reference/react-dom/client/hydrateRoot), чтобы *hydrate* гидратировать этот сгенерированный сервером HTML и сделать его интерактивным. From 12d19a3503754f046809da0bf62ad591c9edfc61 Mon Sep 17 00:00:00 2001 From: GoncharovaAnna <38956075+GoncharovaAnna@users.noreply.github.com> Date: Wed, 3 May 2023 19:25:51 +0300 Subject: [PATCH 2/3] =?UTF-8?q?=D0=97=D0=B0=D0=BC=D0=B5=D0=BD=D0=B0=20?= =?UTF-8?q?=D1=81=D1=81=D1=8B=D0=BB=D0=BE=D0=BA=20=D0=BD=D0=B0=20=D1=80?= =?UTF-8?q?=D1=83=D1=81=D1=81=D0=BA=D0=B8=D0=B9=20=D0=B0=D0=BD=D0=B0=D0=BB?= =?UTF-8?q?=D0=BE=D0=B3=20=D1=81=D0=B0=D0=B9=D1=82=D0=B0=20Node.js?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../react-dom/server/renderToNodeStream.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/src/content/reference/react-dom/server/renderToNodeStream.md b/src/content/reference/react-dom/server/renderToNodeStream.md index 4bfc8616e..fff43a609 100644 --- a/src/content/reference/react-dom/server/renderToNodeStream.md +++ b/src/content/reference/react-dom/server/renderToNodeStream.md @@ -1,16 +1,16 @@ --- -title: renderToNodeStream +Заголовок: renderToNodeStream --- -Этот API будет удален в будущей основной версии React. Лучше использовать вместо него [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream). +Этот API будет удалён в будущей основной версии React. Лучше использовать вместо него [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream). -`renderToNodeStream` отображает дерево React в [Node.js Readable Stream.](https://nodejs.org/api/stream.html#readable-streams) +`renderToNodeStream` отображает дерево React в [Node.js Readable Stream.](https://nodejsdev.ru/api/stream/#streamreadable) ```js const stream = renderToNodeStream(reactNode) @@ -26,7 +26,7 @@ const stream = renderToNodeStream(reactNode) ### `renderToNodeStream(reactNode)` {/*rendertonodestream*/} -На сервере вызовите `renderToNodeStream`, чтобы получить [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams), который вы можете передать в ответ. +На сервере вызовите `renderToNodeStream`, чтобы получить [Node.js Readable Stream](https://nodejsdev.ru/api/stream/#streamreadable), который вы можете передать в ответ. ```js import { renderToNodeStream } from 'react-dom/server'; @@ -35,9 +35,9 @@ const stream = renderToNodeStream(); stream.pipe(response); ``` -На клиенте вызовите [`hydrateRoot`](/reference/react-dom/client/hydrateRoot), чтобы сделать интерактивный HTML-код, созданный сервером. +На клиенте вызовите [`hydrateRoot`](/reference/react-dom/client/hydrateRoot), чтобы сделать интерактивный HTML—код, созданный сервером. -[Больше примеров ниже.](#usage) +[Смотрите ещё примеры ниже.](#usage) #### Параметры {/*parameters*/} @@ -45,13 +45,13 @@ stream.pipe(response); #### Возвращает {/*returns*/} -[Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams), который выводит строку HTML. +[Node.js Readable Stream](https://nodejsdev.ru/api/stream/#streamreadable), который выводит строку HTML. #### Предупреждения {/*caveats*/} -* Этот метод будет ждать всех [Suspense boundaries](/reference/react/Suspense), прежде чем возвращать какие-либо данные. +* Этот метод будет ждать все [Границы задержки](/reference/react/Suspense), прежде чем возвращать какие-либо данные. -* Начиная с React 18, этот метод буферизует все выходные данные, поэтому на самом деле он не дает никаких преимуществ потоковой передачи. Поэтому вместо этого рекомендуется перейти на [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) +* Начиная с React 18, этот метод буферизует все данные на выходе, из-за чего на самом деле он не даёт никаких преимуществ потоковой передачи. Поэтому вместо этого рекомендуется перейти на [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) * Возвращаемый поток представляет собой поток байтов, закодированный в utf-8. Если вам нужен поток в другой кодировке, взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite), который предоставляет потоки преобразования для перекодирования текста. @@ -61,7 +61,7 @@ stream.pipe(response); ### Рендеринг дерева React как HTML в Node.js Readable Stream {/*rendering-a-react-tree-as-html-to-a-nodejs-readable-stream*/} -Вызовите `renderToNodeStream`, чтобы получить [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams), который вы можете передать вашему серверу: +Вызовите `renderToNodeStream`, чтобы получить [Node.js Readable Stream](https://nodejsdev.ru/api/stream/#streamreadable), который вы можете передать вашему серверу: ```js {5-6} import { renderToNodeStream } from 'react-dom/server'; @@ -73,4 +73,4 @@ app.use('/', (request, response) => { }); ``` -Поток произведёт начальный неинтерактивный HTML—вывод ваших компонентов React. На клиенте вам нужно будет вызвать [`hydrateRoot`](/reference/react-dom/client/hydrateRoot), чтобы *hydrate* гидратировать этот сгенерированный сервером HTML и сделать его интерактивным. +Поток произведёт начальный неинтерактивный HTML—вывод ваших компонентов React. На клиенте вам нужно будет вызвать [`hydrateRoot`](/reference/react-dom/client/hydrateRoot), чтобы *гидратировать* этот сгенерированный сервером HTML и сделать его интерактивным. From 7d2f04373b8105ec01a8438feefd4a6a58ebdb8f Mon Sep 17 00:00:00 2001 From: GoncharovaAnna <38956075+GoncharovaAnna@users.noreply.github.com> Date: Wed, 3 May 2023 19:43:11 +0300 Subject: [PATCH 3/3] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/reference/react-dom/server/renderToNodeStream.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/reference/react-dom/server/renderToNodeStream.md b/src/content/reference/react-dom/server/renderToNodeStream.md index fff43a609..11d20440f 100644 --- a/src/content/reference/react-dom/server/renderToNodeStream.md +++ b/src/content/reference/react-dom/server/renderToNodeStream.md @@ -49,11 +49,11 @@ stream.pipe(response); #### Предупреждения {/*caveats*/} -* Этот метод будет ждать все [Границы задержки](/reference/react/Suspense), прежде чем возвращать какие-либо данные. +* Этот метод будет ждать [Suspense boundaries](/reference/react/Suspense), прежде чем возвращать какие-либо данные. * Начиная с React 18, этот метод буферизует все данные на выходе, из-за чего на самом деле он не даёт никаких преимуществ потоковой передачи. Поэтому вместо этого рекомендуется перейти на [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) -* Возвращаемый поток представляет собой поток байтов, закодированный в utf-8. Если вам нужен поток в другой кодировке, взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite), который предоставляет потоки преобразования для перекодирования текста. +* Возвращаемый поток представляет собой поток байтов, закодированный в utf-8. Если вам нужен поток в другой кодировке, посмотрите проект [iconv-lite](https://www.npmjs.com/package/iconv-lite), который предоставляет потоки преобразования для перекодирования текста. ---