Skip to content

Commit 004f7df

Browse files
docs: translate resumeAndPrerenderToNodeStream.md to Português (Brasil) (#1233)
Co-authored-by: translate-react-bot[bot] <251169733+translate-react-bot[bot]@users.noreply.github.com>
1 parent 3ee7a96 commit 004f7df

1 file changed

Lines changed: 27 additions & 28 deletions

File tree

src/content/reference/react-dom/static/resumeAndPrerenderToNodeStream.md

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: resumeAndPrerenderToNodeStream
44

55
<Intro>
66

7-
`resumeAndPrerenderToNodeStream` continues a prerendered React tree to a static HTML string using a a [Node.js Stream.](https://nodejs.org/api/stream.html).
7+
`resumeAndPrerenderToNodeStream` continua uma árvore pré-renderizada do React para uma string HTML estática usando um [Node.js Stream.](https://nodejs.org/api/stream.html).
88

99
```js
1010
const {prelude, postponed} = await resumeAndPrerenderToNodeStream(reactNode, postponedState, options?)
@@ -16,17 +16,17 @@ const {prelude, postponed} = await resumeAndPrerenderToNodeStream(reactNode, pos
1616
1717
<Note>
1818
19-
This API is specific to Node.js. Environments with [Web Streams,](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) like Deno and modern edge runtimes, should use [`prerender`](/reference/react-dom/static/prerender) instead.
19+
Esta API é específica para Node.js. Ambientes com [Web Streams,](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) como Deno e runtimes de edge modernos, devem usar [`prerender`](/reference/react-dom/static/prerender) em vez disso.
2020
2121
</Note>
2222
2323
---
2424
25-
## Reference {/*reference*/}
25+
## Referência {/*reference*/}
2626
2727
### `resumeAndPrerenderToNodeStream(reactNode, postponedState, options?)` {/*resumeandprerendertolnodestream*/}
2828
29-
Call `resumeAndPrerenderToNodeStream` to continue a prerendered React tree to a static HTML string.
29+
Chame `resumeAndPrerenderToNodeStream` para continuar uma árvore pré-renderizada do React para uma string HTML estática.
3030
3131
```js
3232
import { resumeAndPrerenderToNodeStream } from 'react-dom/static';
@@ -39,46 +39,45 @@ async function handler(request, writable) {
3939
}
4040
```
4141
42-
On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to make the server-generated HTML interactive.
42+
No cliente, chame [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) para tornar o HTML gerado pelo servidor interativo.
4343
44-
[See more examples below.](#usage)
44+
[Veja mais exemplos abaixo.](#usage)
4545
46-
#### Parameters {/*parameters*/}
46+
#### Parâmetros {/*parameters*/}
4747
48-
* `reactNode`: The React node you called `prerender` (or a previous `resumeAndPrerenderToNodeStream`) with. For example, a JSX element like `<App />`. It is expected to represent the entire document, so the `App` component should render the `<html>` tag.
49-
* `postponedState`: The opaque `postpone` object returned from a [prerender API](/reference/react-dom/static/index), loaded from wherever you stored it (e.g. redis, a file, or S3).
50-
* **optional** `options`: An object with streaming options.
51-
* **optional** `signal`: An [abort signal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) that lets you [abort server rendering](#aborting-server-rendering) and render the rest on the client.
52-
* **optional** `onError`: A callback that fires whenever there is a server error, whether [recoverable](#recovering-from-errors-outside-the-shell) or [not.](#recovering-from-errors-inside-the-shell) By default, this only calls `console.error`. If you override it to [log crash reports,](#logging-crashes-on-the-server) make sure that you still call `console.error`.
48+
* `reactNode`: O nó React com o qual você chamou `prerender` (ou um `resumeAndPrerenderToNodeStream` anterior). Por exemplo, um elemento JSX como `<App />`. Espera-se que ele represente o documento inteiro, então o componente `App` deve renderizar a tag `<html>`.
49+
* `postponedState`: O objeto `postpone` opaco retornado por uma [API de prerender](/reference/react-dom/static/index), carregado de onde quer que você o tenha armazenado (por exemplo, redis, um arquivo ou S3).
50+
* **opcional** `options`: Um objeto com opções de streaming.
51+
* **opcional** `signal`: Um [sinal de abortar](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) que permite [abortar a renderização do servidor](#aborting-server-rendering) e renderizar o restante no cliente.
52+
* **opcional** `onError`: Um callback que é acionado sempre que ocorre um erro no servidor, seja [recuperável](#recovering-from-errors-outside-the-shell) ou [não.](#recovering-from-errors-inside-the-shell) Por padrão, isso apenas chama `console.error`. Se você o substituir para [registrar relatórios de falha,](#logging-crashes-on-the-server) certifique-se de ainda chamar `console.error`.
5353
54-
#### Returns {/*returns*/}
54+
#### Retorna {/*returns*/}
5555
56-
`resumeAndPrerenderToNodeStream` returns a Promise:
57-
- If rendering the is successful, the Promise will resolve to an object containing:
58-
- `prelude`: a [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) of HTML. You can use this stream to send a response in chunks, or you can read the entire stream into a string.
59-
- `postponed`: an JSON-serializeable, opaque object that can be passed to [`resumeToNodeStream`](/reference/react-dom/server/resume) or [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream) if `resumeAndPrerenderToNodeStream` is aborted.
60-
- If rendering fails, the Promise will be rejected. [Use this to output a fallback shell.](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell)
56+
`resumeAndPrerenderToNodeStream` retorna uma Promise:
57+
- Se a renderização for bem-sucedida, a Promise será resolvida para um objeto contendo:
58+
- `prelude`: um [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) de HTML. Você pode usar este stream para enviar uma resposta em pedaços, ou pode ler o stream inteiro em uma string.
59+
- `postponed`: um objeto opaco e serializável em JSON que pode ser passado para [`resumeToNodeStream`](/reference/react-dom/server/resume) ou [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream) se `resumeAndPrerenderToNodeStream` for abortado.
60+
- Se a renderização falhar, a Promise será rejeitada. [Use isso para gerar um shell de fallback.](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell)
6161
62-
#### Caveats {/*caveats*/}
62+
#### Ressalvas {/*caveats*/}
6363
64-
`nonce` is not an available option when prerendering. Nonces must be unique per request and if you use nonces to secure your application with [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP) it would be inappropriate and insecure to include the nonce value in the prerender itself.
64+
`nonce` não é uma opção disponível ao pré-renderizar. Nonces devem ser únicos por solicitação e se você usar nonces para proteger seu aplicativo com [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP) seria inadequado e inseguro incluir o valor do nonce na pré-renderização em si.
6565
6666
<Note>
6767
68-
### When should I use `resumeAndPrerenderToNodeStream`? {/*when-to-use-prerender*/}
68+
### Quando devo usar `resumeAndPrerenderToNodeStream`? {/*when-to-use-prerender*/}
6969
70-
The static `resumeAndPrerenderToNodeStream` API is used for static server-side generation (SSG). Unlike `renderToString`, `resumeAndPrerenderToNodeStream` waits for all data to load before resolving. This makes it suitable for generating static HTML for a full page, including data that needs to be fetched using Suspense. To stream content as it loads, use a streaming server-side render (SSR) API like [renderToReadableStream](/reference/react-dom/server/renderToReadableStream).
70+
A API estática `resumeAndPrerenderToNodeStream` é usada para geração estática do lado do servidor (SSG). Ao contrário de `renderToString`, `resumeAndPrerenderToNodeStream` espera que todos os dados sejam carregados antes de resolver. Isso o torna adequado para gerar HTML estático para uma página inteira, incluindo dados que precisam ser buscados usando Suspense. Para transmitir conteúdo à medida que ele é carregado, use uma API de renderização do lado do servidor (SSR) em streaming como [renderToReadableStream](/reference/react-dom/server/renderToReadableStream).
7171
72-
`resumeAndPrerenderToNodeStream` can be aborted and later either continued with another `resumeAndPrerenderToNodeStream` or resumed with `resume` to support partial pre-rendering.
72+
`resumeAndPrerenderToNodeStream` pode ser abortado e posteriormente continuado com outro `resumeAndPrerenderToNodeStream` ou retomado com `resume` para suportar pré-renderização parcial.
7373
7474
</Note>
7575
7676
---
7777
78-
## Usage {/*usage*/}
78+
## Uso {/*usage*/}
7979
80-
### Further reading {/*further-reading*/}
81-
82-
`resumeAndPrerenderToNodeStream` behaves similarly to [`prerender`](/reference/react-dom/static/prerender) but can be used to continue a previously started prerendering process that was aborted.
83-
For more information about resuming a prerendered tree, see the [resume documentation](/reference/react-dom/server/resume#resuming-a-prerender).
80+
### Leitura adicional {/*further-reading*/}
8481
82+
`resumeAndPrerenderToNodeStream` se comporta de forma semelhante a [`prerender`](/reference/react-dom/static/prerender), mas pode ser usado para continuar um processo de pré-renderização iniciado anteriormente que foi abortado.
83+
Para mais informações sobre como retomar uma árvore pré-renderizada, veja a [documentação de resume](/reference/react-dom/server/resume#resuming-a-prerender).

0 commit comments

Comments
 (0)