Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(pt-br): translate renderToNodeStream page #779

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs(pt-br): translate renderToNodeStream page #779

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4bbcca0
docs(pt-br): translate renderToNodeStream page
MarceloSpessoto Sep 2, 2024
51e37f0
Merge remote-tracking branch 'upstream/main' into render-to-node-stream
MarceloSpessoto Sep 2, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 20 additions & 21 deletions src/content/reference/react-dom/server/renderToNodeStream.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@ title: renderToNodeStream

<Deprecated>

This API will be removed in a future major version of React. Use [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) instead.
Essa API será removida em uma futura versão major do React. Prefira usar [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Na tradução, a palavra "major" não foi adaptada. Uma opção seria substituí-la por "principal", dependendo do contexto. A frase ficaria assim: "Essa API será removida em uma futura versão principal do React."


</Deprecated>

<Intro>

`renderToNodeStream` renders a React tree to a [Node.js Readable Stream.](https://nodejs.org/api/stream.html#readable-streams)
`renderToNodeStream` renderiza uma árvore React para um [Node.js Readable Stream.](https://nodejs.org/api/stream.html#readable-streams)

```js
const stream = renderToNodeStream(reactNode, options?)
Expand All @@ -22,11 +22,11 @@ const stream = renderToNodeStream(reactNode, options?)

---

## Reference {/*reference*/}
## Referência {/*reference*/}

### `renderToNodeStream(reactNode, options?)` {/*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.
Pelo servidor, chame `renderToNodeStream` para obter um [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) que você pode encadear para a resposta.

```js
import { renderToNodeStream } from 'react-dom/server';
Expand All @@ -35,36 +35,35 @@ const stream = renderToNodeStream(<App />);
stream.pipe(response);
```

On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to make the server-generated HTML interactive.
Pelo cliente, chame [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) para tornar o HTML gerado pelo servidor interativo.

[See more examples below.](#usage)
[Veja mais exemplos abaixo.](#usage)

#### Parameters {/*parameters*/}
#### Parâmetros {/*parameters*/}

* `reactNode`: A React node you want to render to HTML. For example, a JSX element like `<App />`.
* `reactNode`: Um nó React que você quer renderizar para HTML. Por exemplo, um elemento JSX como `<App />`.
* **optional** `options`: Um objeto para renderizador de servidor.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Uma opção para deixar a frase mais fluida em português seria: "Um objeto para a renderização no servidor."

* **optional** `identifierPrefix`: Um prefixo de string que o React usa para IDs gerados por [`useId`.](/reference/react/useId) Útil para evitar conflitos quando usando múltiplas raizes na mesma página. Deve ser o mesmo prefixo passado para [`hydrateRoot`.](/reference/react-dom/client/hydrateRoot#parameters)

* **optional** `options`: An object for server render.
* **optional** `identifierPrefix`: A string prefix React uses for IDs generated by [`useId`.](/reference/react/useId) Useful to avoid conflicts when using multiple roots on the same page. Must be the same prefix as passed to [`hydrateRoot`.](/reference/react-dom/client/hydrateRoot#parameters)
#### Retorna {/*returns*/}

#### Returns {/*returns*/}
Um [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) que possui uma string HTML como saída.

A [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) that outputs an HTML string.
#### Ressalvas {/*caveats*/}

#### Caveats {/*caveats*/}
* Esse método esperará todas [Suspense boundaries](/reference/react/Suspense) completarem antes de retornar qualquer saída.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Outra opção para deixar a frase mais fluida em português seria: "Este método aguardará a conclusão de todas as Suspense boundaries antes de retornar qualquer saída."


* This method will wait for all [Suspense boundaries](/reference/react/Suspense) to complete before returning any output.
* No React 18, esse método coloca em buffer toda sua saída, então não proporciona nenhum benefício de fluxo de dados. É por isso que é recomendado que você migre para [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream).

* 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.

* 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.
* O fluxo retornado é um fluxo de byte codificado em utf-8. Se você precisa de um fluxo em outra codificação, veja um projeto como [iconv-lite](https://www.npmjs.com/package/iconv-lite), que providencia transformação de fluxos para transcodificação.

---

## Usage {/*usage*/}
## Uso {/*usage*/}

### Rendering a React tree as HTML to a Node.js Readable Stream {/*rendering-a-react-tree-as-html-to-a-nodejs-readable-stream*/}
### Renderizar uma árvore React para HTML para um 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:
Chame `renderToNodeStream` para obter um [Node.js Readable Stream](https://nodejs.org/api/stream.html#readable-streams) que você pode encadear para a resposta de seu servidor:

```js {5-6}
import { renderToNodeStream } from 'react-dom/server';
Expand All @@ -76,4 +75,4 @@ app.use('/', (request, 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.
Esse fluxo produzirá a saída de HTML não-interativa inicial de seus componentes React. Pelo cliente, você precisará chamar [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) para *hidratar* esse HTML gerado pelo servidor e torná-lo interativo.