Skip to content

Commit d792e3b

Browse files
committed
docs: translate resumeAndPrerenderToNodeStream reference to Korean (#1475)
1 parent 89f79e9 commit d792e3b

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`은 [Node.js Stream](https://nodejs.org/api/stream.html)을 사용하여 프리렌더링된 React 트리를 정적 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+
이 API는 Node.js 전용입니다. Deno나 최신 엣지 런타임처럼 [Web Streams](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)를 지원하는 환경에서는 [`prerender`](/reference/react-dom/static/prerender)를 사용해야 합니다.
2020
2121
</Note>
2222
2323
---
2424
25-
## Reference {/*reference*/}
25+
## 레퍼런스 {/*reference*/}
2626
2727
### `resumeAndPrerenderToNodeStream(reactNode, postponedState, options?)` {/*resumeandprerendertolnodestream*/}
2828
29-
Call `resumeAndPrerenderToNodeStream` to continue a prerendered React tree to a static HTML string.
29+
`resumeAndPrerenderToNodeStream`을 호출해 프리렌더링된 React 트리를 정적 HTML 문자열로 계속 렌더링합니다.
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+
클라이언트에서 [`hydrateRoot`](/reference/react-dom/client/hydrateRoot)를 호출해 서버에서 생성된 HTML을 인터랙티브하게 만듭니다.
4343
44-
[See more examples below.](#usage)
44+
[아래에서 더 많은 예시를 확인하세요.](#usage)
4545
46-
#### Parameters {/*parameters*/}
46+
#### 매개변수 {/*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-
* `options`**(선택사항)**: An object with streaming options.
51-
* `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-
* `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`: `prerender`(또는 이전의 `resumeAndPrerenderToNodeStream`)를 호출할 때 사용했던 React 노드입니다. 예를 들어 `<App />`과 같은 JSX 노드가 해당됩니다. 전체 문서를 나타내야 하므로, `App` 컴포넌트는 `<html>` 태그를 렌더링해야 합니다.
49+
* `postponedState`: [prerender API](/reference/react-dom/static/index)에서 반환되어 저장소(예: Redis, 파일 또는 S3)에 저장해 둔 불투명(opaque) `postpone` 객체입니다.
50+
* `options`**(선택사항)**: 스트리밍 옵션을 가진 객체입니다.
51+
* `signal`**(선택사항)**: [서버 렌더링을 중단하고](#aborting-server-rendering) 나머지를 클라이언트에서 렌더링할 수 있게 하는 [중단 신호(abort signal)](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)입니다.
52+
* `onError`**(선택사항)**: [복구 가능한 오류](#recovering-from-errors-outside-the-shell)이든 [복구 불가능한 오류](#recovering-from-errors-inside-the-shell)이든 서버 오류가 발생할 때마다 호출되는 콜백입니다. 기본적으로 `console.error`만 호출합니다. [충돌 보고서를 기록](#logging-crashes-on-the-server)하도록 재정의하는 경우에도 반드시 `console.error`를 호출해야 합니다.
5353
54-
#### Returns {/*returns*/}
54+
#### 반환값 {/*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`은 Promise를 반환합니다.
57+
- 렌더링에 성공하면 Promise는 다음을 포함한 객체로 resolve됩니다.
58+
- `prelude`: HTML을 담은 [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)입니다. 이 스트림을 사용해 응답을 청크 단위로 전송하거나, 전체 스트림을 문자열로 읽을 수 있습니다.
59+
- `postponed`: `resumeAndPrerenderToNodeStream`이 중단된 경우 [`resumeToNodeStream`](/reference/react-dom/server/resume) 또는 [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream)에 전달할 수 있는 JSON으로 직렬화 가능한 불투명 객체입니다.
60+
- 렌더링에 실패하면 Promise는 reject됩니다. [이 값을 사용해 fallback 셸을 출력하세요.](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell)
6161
62-
#### Caveats {/*caveats*/}
62+
#### 주의 사항 {/*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` 옵션은 사용할 수 없습니다. Nonce는 요청마다 고유해야 하며, [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP)로 애플리케이션을 보호할 때 Nonce 값을 프리렌더링 결과 자체에 포함하는 것은 부적절하고 안전하지 않습니다.
6565
6666
<Note>
6767
68-
### When should I use `resumeAndPrerenderToNodeStream`? {/*when-to-use-prerender*/}
68+
### `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+
정적 `resumeAndPrerenderToNodeStream` API는 정적 서버 사이드 생성(SSG)에 사용합니다. `renderToString`과 달리, `resumeAndPrerenderToNodeStream`은 모든 데이터가 로드될 때까지 기다린 후에 성공합니다. 이는 Suspense를 사용해 가져와야 하는 데이터를 포함해, 전체 페이지의 정적 HTML을 생성하는 데 적합합니다. 콘텐츠가 로드되는 동안 스트리밍하려면, [renderToReadableStream](/reference/react-dom/server/renderToReadableStream)과 같은 스트리밍 서버 사이드 렌더링(SSR) API를 사용하세요.
7171
72-
`resumeAndPrerenderToNodeStream` can be aborted and later either continued with another `resumeAndPrerenderToNodeStream` or resumed with `resume` to support partial pre-rendering.
72+
`resumeAndPrerenderToNodeStream`은 중단될 수 있으며, 이후 부분 사전 렌더링(partial pre-rendering)을 지원하기 위해 다른 `resumeAndPrerenderToNodeStream`으로 계속 이어가거나 `resume`으로 재개할 수 있습니다.
7373
7474
</Note>
7575
7676
---
7777
78-
## Usage {/*usage*/}
78+
## 사용법 {/*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+
### 더 읽어보기 {/*further-reading*/}
8481
82+
`resumeAndPrerenderToNodeStream`은 [`prerender`](/reference/react-dom/static/prerender)와 유사하게 동작하지만, 이전에 시작되었다가 중단된 프리렌더링 프로세스를 계속 진행하는 데 사용할 수 있습니다.
83+
프리렌더링된 트리를 재개하는 방법에 대한 자세한 내용은 [resume 문서](/reference/react-dom/server/resume#resuming-a-prerender)를 참고하세요.

0 commit comments

Comments
 (0)