Skip to content

Commit 19afa9c

Browse files
committed
Translate resumeAndPrerender
1 parent 356741e commit 19afa9c

1 file changed

Lines changed: 28 additions & 28 deletions

File tree

‎src/content/reference/react-dom/static/resumeAndPrerender.md‎

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

55
<Intro>
66

7-
`resumeAndPrerender` continues a prerendered React tree to a static HTML string using a [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API).
7+
`resumeAndPrerender` は [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) を用いて、プリレンダーされた React ツリーの静的な HTML 文字列へのレンダーを継続します。
88

99
```js
1010
const {prelude, postponed} = await resumeAndPrerender(reactNode, postponedState, options?)
@@ -16,17 +16,17 @@ const {prelude, postponed} = await resumeAndPrerender(reactNode, postponedState,
1616
1717
<Note>
1818
19-
This API depends on [Web Streams.](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) For Node.js, use [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream) instead.
19+
この API は [Web Streams](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) に依存しています。Node.js では、代わりに [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream) を使用してください。
2020
2121
</Note>
2222
2323
---
2424
25-
## Reference {/*reference*/}
25+
## リファレンス {/*reference*/}
2626
2727
### `resumeAndPrerender(reactNode, postponedState, options?)` {/*resumeandprerender*/}
2828
29-
Call `resumeAndPrerender` to continue a prerendered React tree to a static HTML string.
29+
`resumeAndPrerender` を呼び出して、プリレンダーされた React ツリーの静的な HTML 文字列へのレンダーを継続します。
3030
3131
```js
3232
import { resumeAndPrerender } from 'react-dom/static';
@@ -43,46 +43,46 @@ async function handler(request, response) {
4343
}
4444
```
4545
46-
On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to make the server-generated HTML interactive.
46+
クライアント側では、[`hydrateRoot`](/reference/react-dom/client/hydrateRoot) を呼び出して、サーバで生成された HTML をインタラクティブにします。
4747
48-
[See more examples below.](#usage)
48+
[さらに例を見る](#usage)
4949
50-
#### Parameters {/*parameters*/}
50+
#### 引数 {/*parameters*/}
5151
52-
* `reactNode`: The React node you called `prerender` (or a previous `resumeAndPrerender`) 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.
53-
* `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).
54-
* **optional** `options`: An object with streaming options.
55-
* **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.
56-
* **optional** `onBrowserBailout`: A callback React calls when it recovers from [`browser()`](/reference/react-dom/browser) by leaving a Suspense fallback for the browser to replace. It receives an `Error` describing the browser-only render and an `errorInfo` object containing the `componentStack`. If a reason was passed to `browser`, it is available as `error.cause`. By default, React does nothing. [See how to report browser-only rendering.](/reference/react-dom/browser#reporting-browser-only-rendering-on-the-server)
57-
* **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`.
52+
* `reactNode`: `prerender`(または以前の `resumeAndPrerender`)を呼び出したときに渡した React ノード。例えば `<App />` のような JSX 要素です。これはドキュメント全体を表すことが期待されているため、`App` コンポーネントは `<html>` タグをレンダーする必要があります。
53+
* `postponedState`: [プリレンダー API](/reference/react-dom/static/index) が返した内部構造非公開の `postpone` オブジェクト。保存しておいた場所(redis、ファイル、S3 など)から読み込んだものを渡します。
54+
* **省略可能** `options`: ストリーミングに関するオプションを含むオブジェクト。
55+
* **省略可能** `signal`: [サーバレンダリングを中止](#aborting-server-rendering)してクライアントで残りをレンダーするために使用できる [abort signal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)。
56+
* **省略可能** `onBrowserBailout`: [`browser()`](/reference/react-dom/browser) によるサーバレンダリングの中断が起き、ブラウザ側で置き換えるためのサスペンスフォールバックが残った時点で React が呼び出すコールバック。ブラウザのみでレンダーされるという内容の `Error` と、`componentStack` を含む `errorInfo` オブジェクトを受け取ります。`browser` に理由が渡されていた場合、その理由は `error.cause` から取得できます。デフォルトでは React は何も行いません。[ブラウザオンリーのレンダー発生をサーバ上で報告する方法を参照](/reference/react-dom/browser#reporting-browser-only-rendering-on-the-server)。
57+
* **省略可能** `onError`: サーバエラーが発生するたびに発火するコールバック。[復帰可能なエラー](#recovering-from-errors-outside-the-shell)の場合も[そうでないエラー](#recovering-from-errors-inside-the-shell)の場合もあります。デフォルトでは `console.error` のみを呼び出します。これを上書きして[クラッシュレポートをログに記録する](#logging-crashes-on-the-server)場合でも `console.error` を呼び出すようにしてください。
5858
59-
#### Returns {/*returns*/}
59+
#### 返り値 {/*returns*/}
6060
61-
`prerender` returns a Promise:
62-
- If rendering the is successful, the Promise will resolve to an object containing:
63-
- `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.
64-
- `postponed`: an JSON-serializeable, opaque object that can be passed to [`resume`](/reference/react-dom/server/resume) or [`resumeAndPrerender`](/reference/react-dom/static/resumeAndPrerender) if `prerender` is aborted.
65-
- 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)
61+
`prerender` は Promise を返します。
62+
- レンダーが成功した場合、Promise は以下を含んだオブジェクトに解決 (resolve) されます。
63+
- `prelude`: HTML の [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)。このストリームを使ってレスポンスを送信したり、ストリームを文字列に一括して読み出したりできます。
64+
- `postponed`: `prerender` が中断された場合に、[`resume`](/reference/react-dom/server/resume) または [`resumeAndPrerender`](/reference/react-dom/static/resumeAndPrerender) に渡すことができる、JSON シリアライズ可能な内部構造非公開のオブジェクト。
65+
- レンダーが失敗した場合は、Promise は拒否 (reject) されます。[これを使用してフォールバックシェルを出力します](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell)。
6666
67-
#### Caveats {/*caveats*/}
67+
#### 注意点 {/*caveats*/}
6868
69-
`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.
69+
プリレンダー中に `nonce` オプションは利用できません。nonce はリクエストごとに一意である必要があり、[CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP) でアプリケーションを保護するために nonce を使用する場合、プリレンダー自体に nonce 値を含めることは不適切かつ危険です。
7070
7171
<Note>
7272
73-
### When should I use `resumeAndPrerender`? {/*when-to-use-prerender*/}
73+
### `resumeAndPrerender` をいつ使うのか {/*when-to-use-prerender*/}
7474
75-
The static `resumeAndPrerender` API is used for static server-side generation (SSG). Unlike `renderToString`, `resumeAndPrerender` 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).
75+
静的 API である `resumeAndPrerender` は、静的なサーバサイド生成 (server-side generation; SSG) に使用するものです。`renderToString` とは異なり、`resumeAndPrerender` はすべてのデータの読み込みが完了するまで待機してから解決されます。このため、サスペンスを使用して取得するデータを含む、ページ全体の静的な HTML を生成するのに適しています。読み込み中のコンテンツをストリーミングする場合は、[renderToReadableStream](/reference/react-dom/server/renderToReadableStream) のようなストリーミング付きサーバサイドレンダリング (SSR) API を使用してください。
7676
77-
`resumeAndPrerender` can be aborted and later either continued with another `resumeAndPrerender` or resumed with `resume` to support partial pre-rendering.
77+
部分プリレンダリング (partial pre-rendering) をサポートするため、`resumeAndPrerender` は中断可能です。あとで別の `resumeAndPrerender` でプリレンダーを継続することも、`resume` で再開することも可能です。
7878
7979
</Note>
8080
8181
---
8282
83-
## Usage {/*usage*/}
83+
## 使用法 {/*usage*/}
8484
85-
### Further reading {/*further-reading*/}
85+
### さらに学ぶ {/*further-reading*/}
8686
87-
`resumeAndPrerender` behaves similarly to [`prerender`](/reference/react-dom/static/prerender) but can be used to continue a previously started prerendering process that was aborted.
88-
For more information about resuming a prerendered tree, see the [resume documentation](/reference/react-dom/server/resume#resuming-a-prerender).
87+
`resumeAndPrerender` は [`prerender`](/reference/react-dom/static/prerender) と同様に動作しますが、以前に開始されて中断されたプリレンダー処理を継続するために使用できます。
88+
プリレンダーされたツリーの再開についての詳細は、[`resume` のドキュメント](/reference/react-dom/server/resume#resuming-a-prerender)を参照してください。

0 commit comments

Comments
 (0)