You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This API depends on [Web Streams.](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) For Node.js, use [`resumeToNodeStream`](/reference/react-dom/server/renderToPipeableStream) instead.
19
+
이 API는 [Web Streams](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)에 의존합니다. Node.js에서는 [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream)을 대신 사용하세요.
Call `resume` to resume rendering a pre-rendered React tree as HTML into a [Readable Web Stream.](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream)
29
+
`resume`을 호출해 사전 렌더링된 React 트리의 렌더링을 재개하고, 이를 HTML로 [Readable Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream)에 렌더링합니다.
30
+
30
31
31
32
```js
32
33
import { resume } from'react-dom/server';
@@ -39,39 +40,40 @@ async function handler(request, writable) {
39
40
}
40
41
```
41
42
42
-
[See more examples below.](#usage)
43
+
[아래에서 더 많은 예시를 확인하세요.](#usage)
44
+
45
+
#### 매개변수 {/*parameters*/}
43
46
44
-
#### Parameters {/*parameters*/}
47
+
* `reactNode`: `prerender`를 호출할 때 전달한 React 노드입니다. 예를 들어, `<App />`과 같은 JSX 엘리먼트입니다. 전체 문서를 나타낼 것으로 예상되므로 `App` 컴포넌트는 `<html>` 태그를 렌더링해야 합니다.
* **optional** `options`: 스트리밍 옵션을 지정할 수 있는 객체입니다.
50
+
* **optional** `nonce`: [`script-src` Content-Security-Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src)에서 스크립트를 허용하기 위한 [`nonce`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#nonce) 문자열입니다.
51
+
* **optional** `signal`: [서버 렌더링을 중단](/reference/react-dom/server/renderToReadableStream#aborting-server-rendering)하고 나머지를 클라이언트에서 렌더링할 수 있게 하는 [중단 신호](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)입니다.
52
+
* **optional** `onError`: 서버 오류가 발생할 때마다, [복구 가능](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-outside-the-shell) 또는 [불가능](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell)에 관계없이 호출되는 콜백입니다. 기본적으로 `console.error`만 호출합니다. [충돌 보고를 기록](/reference/react-dom/server/renderToReadableStream#logging-crashes-on-the-server)하도록 재정의하는 경우에도 반드시 `console.error`를 호출해야 합니다.
45
53
46
-
* `reactNode`: The React node you called `prerender` 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.
47
-
* `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).
48
-
* **optional** `options`: An object with streaming options.
49
-
* **optional** `nonce`: A [`nonce`](http://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#nonce) string to allow scripts for [`script-src` Content-Security-Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src).
50
-
* **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.
51
-
* **optional** `onError`: A callback that fires whenever there is a server error, whether [recoverable](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-outside-the-shell) or [not.](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell) By default, this only calls `console.error`. If you override it to [log crash reports,](/reference/react-dom/server/renderToReadableStream#logging-crashes-on-the-server) make sure that you still call `console.error`.
52
54
55
+
#### 반환값 {/*returns*/}
53
56
54
-
#### Returns {/*returns*/}
57
+
`resume`은 Promise를 반환합니다.
55
58
56
-
`resume` returns a Promise:
59
+
- `resume`이 [shell](/reference/react-dom/server/renderToReadableStream#specifying-what-goes-into-the-shell)을 성공적으로 생성하면, 해당 Promise는 [Writable Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/WritableStream)으로 파이프할 수 있는 [Readable Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream)으로 이행됩니다.
60
+
- shell에서 오류가 발생하면, 해당 Promise는 그 오류와 함께 거부됩니다.
57
61
58
-
- If `resume` successfully produced a [shell](/reference/react-dom/server/renderToReadableStream#specifying-what-goes-into-the-shell), that Promise will resolve to a [Readable Web Stream.](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream) that can be piped to a [Writable Web Stream.](https://developer.mozilla.org/en-US/docs/Web/API/WritableStream).
59
-
- If an error happens in the shell, the Promise will reject with that error.
62
+
반환된 스트림은 다음과 같은 추가적인 프로퍼티를 가지고 있습니다.
60
63
61
-
The returned stream has an additional property:
64
+
* `allReady`: 모든 렌더링이 완료되면 이행되는 Promise입니다. [크롤러와 정적 생성을 위해](/reference/react-dom/server/renderToReadableStream#waiting-for-all-content-to-load-for-crawlers-and-static-generation) 응답을 반환하기 전에 `awaitstream.allReady`를 사용할 수 있습니다. 이렇게 하면 점진적 로딩은 사용할 수 없습니다. 스트림에는 최종 HTML이 포함됩니다.
62
65
63
-
* `allReady`: A Promise that resolves when all rendering is complete. You can `awaitstream.allReady` before returning a response [for crawlers and static generation.](/reference/react-dom/server/renderToReadableStream#waiting-for-all-content-to-load-for-crawlers-and-static-generation) If you do that, you won't get any progressive loading. The stream will contain the final HTML.
66
+
#### 주의 사항 {/*caveats*/}
64
67
65
-
#### Caveats {/*caveats*/}
68
+
- `resume`은 `bootstrapScripts`, `bootstrapScriptContent`, `bootstrapModules` 옵션을 받지 않습니다. 대신 `postponedState`를 생성하는 `prerender` 호출에 이 옵션들을 전달해야 합니다. 또한 쓰기 가능한 스트림에 부트스트랩 콘텐츠를 수동으로 주입할 수도 있습니다.
69
+
- `prerender`와 `resume`에서 접두사가 동일해야 하므로, `resume`은 `identifierPrefix`를 받지 않습니다.
70
+
- `nonce`는 prerender에 전달할 수 없으므로, prerender에 스크립트를 제공하지 않는 경우에만 `resume`에 `nonce`를 전달해야 합니다.
71
+
- `resume`은 사전 렌더링이 완전히 완료되지 않은 컴포넌트를 찾을 때까지 루트부터 다시 렌더링합니다. 사전 렌더링이 완전히 완료된 컴포넌트(해당 컴포넌트와 자식들의 사전 렌더링이 모두 완료된 경우)만 완전히 건너뜁니다.
66
72
67
-
- `resume` does not accept options for `bootstrapScripts`, `bootstrapScriptContent`, or `bootstrapModules`. Instead, you need to pass these options to the `prerender` call that generates the `postponedState`. You can also inject bootstrap content into the writable stream manually.
68
-
- `resume` does not accept `identifierPrefix` since the prefix needs to be the same in both `prerender` and `resume`.
69
-
- Since `nonce` cannot be provided to prerender, you should only provide `nonce` to `resume` if you're not providing scripts to prerender.
70
-
- `resume` re-renders from the root until it finds a component that was not fully pre-rendered. Only fully prerendered Components (the Component and its children finished prerendering) are skipped entirely.
71
73
72
-
## Usage {/*usage*/}
74
+
## 사용법 {/*usage*/}
73
75
74
-
### Resuming a prerender {/*resuming-a-prerender*/}
76
+
### 사전 렌더링 재개하기 {/*resuming-a-prerender*/}
75
77
76
78
<Sandpack>
77
79
@@ -230,7 +232,7 @@ export function sleep(timeoutMS) {
230
232
231
233
</Sandpack>
232
234
233
-
### Further reading {/*further-reading*/}
235
+
### 추가로 읽어보기 {/*further-reading*/}
234
236
235
-
Resuming behaves like `renderToReadableStream`. For more examples, check out the [usage section of `renderToReadableStream`](/reference/react-dom/server/renderToReadableStream#usage).
236
-
The [usage section of `prerender`](/reference/react-dom/static/prerender#usage) includes examples of how to use `prerender` specifically.
237
+
재개 동작은 `renderToReadableStream`과 유사합니다. 더 많은 예시는 [`renderToReadableStream`의 사용법 섹션](/reference/react-dom/server/renderToReadableStream#usage)을 확인하세요.
238
+
[`prerender`의 사용법 섹션](/reference/react-dom/static/prerender#usage)에는 `prerender` 사용 방법에 대한 예시가 포함되어 있습니다.
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 [`resume`](/reference/react-dom/server/renderToReadableStream) instead.
19
+
이 API는 Node.js 전용입니다. Deno 및 최신 엣지 런타임처럼 [Web Streams](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)을 지원하는 환경에서는 [`resume`](/reference/react-dom/server/resume)을 대신 사용하세요.
@@ -42,37 +43,37 @@ async function handler(request, response) {
42
43
}
43
44
```
44
45
45
-
[See more examples below.](#usage)
46
+
[아래에서 더 많은 예시를 확인하세요.](#usage)
46
47
47
-
#### Parameters {/*parameters*/}
48
+
#### 매개변수 {/*parameters*/}
48
49
49
-
* `reactNode`: The React node you called `prerender` 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.
50
-
* `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).
51
-
* **optional** `options`: An object with streaming options.
52
-
* **optional** `nonce`: A [`nonce`](http://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#nonce) string to allow scripts for [`script-src` Content-Security-Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src).
53
-
* **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.
54
-
* **optional** `onError`: A callback that fires whenever there is a server error, whether [recoverable](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-outside-the-shell) or [not.](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell) By default, this only calls `console.error`. If you override it to [log crash reports,](/reference/react-dom/server/renderToReadableStream#logging-crashes-on-the-server) make sure that you still call `console.error`.
55
-
* **optional** `onShellReady`: A callback that fires right after the [shell](#specifying-what-goes-into-the-shell) has finished. You can call`pipe` here to start streaming. React will [stream the additional content](#streaming-more-content-as-it-loads) after the shell along with the inline `<script>`tags that replace the HTML loading fallbacks with the content.
56
-
* **optional** `onShellError`: A callback that fires if there was an error rendering the shell. It receives the error as an argument. No bytes were emitted from the stream yet, and neither `onShellReady` nor `onAllReady` will get called, so you can [output a fallback HTML shell](#recovering-from-errors-inside-the-shell) or use the prelude.
50
+
* `reactNode`: `prerender`를 호출할 때 전달한 React 노드입니다. 예를 들어,`<App />`과 같은 JSX 엘리먼트입니다. 전체 문서를 나타낼 것으로 예상되므로 `App`컴포넌트는 `<html>`태그를 렌더링해야 합니다.
* **optional** `options`: 스트리밍 옵션을 지정할 수 있는 객체입니다.
53
+
* **optional** `nonce`: [`script-src` Content-Security-Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src)에서 스크립트를 허용하기 위한 [`nonce`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#nonce) 문자열입니다.
54
+
* **optional** `signal`: [서버 렌더링을 중단](/reference/react-dom/server/renderToPipeableStream#aborting-server-rendering)하고 나머지를 클라이언트에서 렌더링할 수 있게 하는 [중단 신호](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)입니다.
55
+
* **optional** `onError`: 서버 오류가 발생할 때마다, [복구 가능](/reference/react-dom/server/renderToPipeableStream#recovering-from-errors-outside-the-shell) 또는 [불가능](/reference/react-dom/server/renderToPipeableStream#recovering-from-errors-inside-the-shell)에 관계없이 호출되는 콜백입니다. 기본적으로 `console.error`만 호출합니다. [충돌 보고를 기록](/reference/react-dom/server/renderToPipeableStream#logging-crashes-on-the-server)하도록 재정의하는 경우에도 반드시 `console.error`를 호출해야 합니다.
56
+
* **optional** `onShellReady`: [셸](/reference/react-dom/server/renderToPipeableStream#specifying-what-goes-into-the-shell)이 렌더링된 직후에 실행되는 콜백입니다. 여기서`pipe`를 호출해 스트리밍을 시작할 수 있습니다. React는 HTML 로딩 폴백을 콘텐츠로 대체하는 인라인 `<script>`태그와 함께 셸 뒤에 [추가 콘텐츠를 스트리밍](/reference/react-dom/server/renderToPipeableStream#streaming-more-content-as-it-loads)합니다.
57
+
* **optional** `onShellError`: 초기 셸을 렌더링하는 데 오류가 발생하면 호출되는 콜백입니다. 오류를 인자로 받습니다. 스트림에서 아직 바이트가 전송되지 않았고, `onShellReady`나 `onAllReady`도 호출되지 않으므로 [폴백 HTML 셸을 출력](/reference/react-dom/server/renderToPipeableStream#recovering-from-errors-inside-the-shell)하거나 prelude를 사용할 수 있습니다.
57
58
58
59
59
-
#### Returns {/*returns*/}
60
+
#### 반환값 {/*returns*/}
60
61
61
-
`resume` returns an object with two methods:
62
+
`resumeToPipeableStream`은 두 개의 메서드를 가진 객체를 반환합니다.
62
63
63
-
* `pipe` outputs the HTML into the provided [Writable Node.js Stream.](https://nodejs.org/api/stream.html#writable-streams) Call `pipe` in`onShellReady` if you want to enable streaming, or in `onAllReady` for crawlers and static generation.
64
-
* `abort` lets you [abort server rendering](#aborting-server-rendering) and render the rest on the client.
* `abort`를 사용하면 [서버 렌더링을 중단](/reference/react-dom/server/renderToPipeableStream#aborting-server-rendering)하고 나머지는 클라이언트에서 렌더링할 수 있습니다.
65
66
66
-
#### Caveats {/*caveats*/}
67
+
#### 주의 사항 {/*caveats*/}
67
68
68
-
- `resumeToPipeableStream` does not accept options for `bootstrapScripts`, `bootstrapScriptContent`, or `bootstrapModules`. Instead, you need to pass these options to the `prerender`call that generates the `postponedState`. You can also inject bootstrap content into the writable stream manually.
69
-
- `resumeToPipeableStream` does not accept `identifierPrefix` since the prefix needs to be the same in both `prerender` and `resumeToPipeableStream`.
70
-
- Since `nonce` cannot be provided to prerender, you should only provide `nonce` to `resumeToPipeableStream` if you're not providing scripts to prerender.
71
-
- `resumeToPipeableStream` re-renders from the root until it finds a component that was not fully pre-rendered. Only fully prerendered Components (the Component and its children finished prerendering) are skipped entirely.
69
+
- `resumeToPipeableStream`은 `bootstrapScripts`, `bootstrapScriptContent`, `bootstrapModules` 옵션을 받지 않습니다. 대신 `postponedState`를 생성하는 `prerender`호출에 이 옵션들을 전달해야 합니다. 또한 쓰기 가능한 스트림에 부트스트랩 콘텐츠를 수동으로 주입할 수도 있습니다.
70
+
- `prerender`와 `resumeToPipeableStream`에서 접두사가 동일해야 하므로, `resumeToPipeableStream`은 `identifierPrefix`를 받지 않습니다.
71
+
- `nonce`는 prerender에 전달할 수 없으므로, prerender에 스크립트를 제공하지 않는 경우에만 `resumeToPipeableStream`에 `nonce`를 전달해야 합니다.
72
+
- `resumeToPipeableStream`은 사전 렌더링이 완전히 완료되지 않은 컴포넌트를 찾을 때까지 루트부터 다시 렌더링합니다. 사전 렌더링이 완전히 완료된 컴포넌트(해당 컴포넌트와 자식들의 사전 렌더링이 모두 완료된 경우)만 완전히 건너뜁니다.
72
73
73
-
## Usage {/*usage*/}
74
+
## 사용법 {/*usage*/}
74
75
75
-
### Further reading {/*further-reading*/}
76
+
### 추가로 읽어보기 {/*further-reading*/}
76
77
77
-
Resuming behaves like `renderToReadableStream`. For more examples, check out the [usage section of `renderToReadableStream`](/reference/react-dom/server/renderToReadableStream#usage).
78
-
The [usage section of `prerender`](/reference/react-dom/static/prerender#usage) includes examples of how to use `prerenderToNodeStream` specifically.
78
+
재개 동작은 `renderToPipeableStream`과 유사합니다. 더 많은 예시는 [`renderToPipeableStream`의 사용법 섹션](/reference/react-dom/server/renderToPipeableStream#usage)을 확인하세요.
79
+
[`prerenderToNodeStream`의 사용법 섹션](/reference/react-dom/static/prerenderToNodeStream#usage)에는 `prerenderToNodeStream` 사용 방법에 대한 예시가 포함되어 있습니다.
0 commit comments