Skip to content

Commit 5b9ae23

Browse files
committed
docs: update documentation translations
1 parent 9d0bc85 commit 5b9ae23

File tree

160 files changed

+24652
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

160 files changed

+24652
-0
lines changed

apps/docs/content/ja/blog/building-apis-with-nextjs.mdx

Lines changed: 396 additions & 0 deletions
Large diffs are not rendered by default.
Lines changed: 202 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,202 @@
1+
---
2+
source-updated-at: 2025-05-29T18:05:49.000Z
3+
translation-updated-at: 2025-06-02T19:19:48.890Z
4+
title: Next.jsにおけるコンポーザブルキャッシュ
5+
description: 'use cache' のAPI設計と利点について学びましょう
6+
author:
7+
- name: Lee Robinson
8+
image: /static/team/lee.jpg
9+
date: 2025-01-03T14:00:00.507Z
10+
image: >-
11+
https://h8DxKfmAPhn8O0p3.public.blob.vercel-storage.com/static/blog/composable-caching/twitter-card.png
12+
---
13+
14+
Next.js向けにシンプルで強力なキャッシュモデルを開発中です。前回の記事では、[キャッシュに関する私たちの取り組み](/blog/our-journey-with-caching)と、どのようにして`'use cache'`ディレクティブに至ったかを説明しました。
15+
16+
この記事では、`'use cache'`のAPI設計とその利点について議論します。
17+
18+
[`'use cache'`とは?](#what-is-use-cache)
19+
--------------------------------------------
20+
21+
`'use cache'`は、必要に応じてデータやコンポーネントをキャッシュすることでアプリケーションを高速化します。
22+
23+
これはJavaScriptの「ディレクティブ」—コードに追加する文字列リテラル—であり、Next.jsコンパイラに異なる「境界」に入るよう信号を送ります。例えば、サーバーからクライアントへの移行などです。
24+
25+
これはReactの`'use client'``'use server'`のようなディレクティブと同様の考え方です。ディレクティブはコードがどこで実行されるべきかを定義するコンパイラ指令で、フレームワークが個々の部品を最適化し調整できるようにします。
26+
27+
[どのように機能するか?](#how-does-it-work)
28+
--------------------------------------
29+
30+
簡単な例から始めましょう:
31+
32+
```
33+
async function getUser(id) {
34+
'use cache';
35+
let res = await fetch(`https://api.vercel.app/user/${id}`);
36+
return res.json();
37+
}
38+
```
39+
40+
内部では、Next.jsは`'use cache'`ディレクティブによりこのコードをサーバー関数に変換します。コンパイル時に、このキャッシュエントリの「依存関係」が見つかり、キャッシュキーの一部として使用されます。
41+
42+
例えば、`id`はキャッシュキーの一部になります。`getUser(1)`を複数回呼び出すと、キャッシュされたサーバー関数からメモ化された出力が返されます。この値を変更すると、キャッシュに新しいエントリが作成されます。
43+
44+
[クロージャ](https://v0.dev/chat/5kD47RIecQK?b=b_rCP4CvfbFFW)を使用したサーバーコンポーネントでのキャッシュ関数の使用例を見てみましょう。
45+
46+
```
47+
function Profile({ id }) {
48+
async function getNotifications(index, limit) {
49+
'use cache';
50+
return await db
51+
.select()
52+
.from(notifications)
53+
.limit(limit)
54+
.offset(index)
55+
.where(eq(notifications.userId, id));
56+
}
57+
58+
return <User notifications={getNotifications} />;
59+
}
60+
```
61+
62+
この例はより複雑です。キャッシュキーの一部となるべきすべての依存関係を見つけられますか?
63+
64+
引数`index``limit`は理解しやすい—これらの値が変わると、通知の異なるスライスを選択します。しかし、ユーザー`id`についてはどうでしょうか?その値は親コンポーネントから来ています。
65+
66+
コンパイラは`getNotifications``id`にも依存していることを理解でき、その値は自動的にキャッシュキーに含まれます。これにより、キャッシュキーにおける不正確または欠落した依存関係によるキャッシュ問題の全カテゴリが防止されます。
67+
68+
[キャッシュ関数を使用しない理由](#why-not-use-a-cache-function)
69+
--------------------------------------------------------------
70+
71+
前の例を再考しましょう。ディレクティブの代わりに`cache()`関数を使用することはできませんか?
72+
73+
```
74+
function Profile({ id }) {
75+
async function getNotifications(index, limit) {
76+
return await cache(async () => {
77+
return await db
78+
.select()
79+
.from(notifications)
80+
.limit(limit)
81+
.offset(index)
82+
// おっと!idをキャッシュキーに含める場所は?
83+
.where(eq(notifications.userId, id));
84+
});
85+
}
86+
87+
return <User notifications={getNotifications} />;
88+
}
89+
```
90+
91+
`cache()`関数はクロージャを調べて`id`値をキャッシュキーの一部に含めるべきか判断できません。手動で`id`がキーの一部であることを指定する必要があります。これを忘れたり、間違えたりすると、キャッシュ衝突や古いデータのリスクがあります。
92+
93+
クロージャはあらゆる種類のローカル変数を捕捉できます。単純なアプローチでは、意図しない変数を誤って組み込んだり(または省略したり)する可能性があります。これにより、間違ったデータがキャッシュされたり、機密情報がキャッシュキーに漏れることでキャッシュ汚染のリスクが生じたりする可能性があります。
94+
95+
`'use cache'`はコンパイラにクロージャを安全に処理し、キャッシュキーを正しく生成するための十分なコンテキストを提供します。`cache()`のようなランタイムのみのソリューションでは、すべてを手動で行う必要があり、ミスを犯しやすくなります。対照的に、ディレクティブは静的に分析でき、すべての依存関係を確実に処理できます。
96+
97+
[シリアライズ不可能な入力値はどのように処理されるか?](#how-are-non-serialized-input-values-handled)
98+
--------------------------------------------------------------------------------------------
99+
100+
キャッシュする入力値には2つの異なるタイプがあります:
101+
102+
* **シリアライズ可能**: ここで「シリアライズ可能」とは、意味を失うことなく安定した文字列ベースの形式に変換できる入力を指します。多くの人がまず`JSON.stringify`を考えますが、実際にはReactのシリアライゼーション(例えばサーバーコンポーネント経由)を使用して、Promise、循環データ構造、その他の複雑なオブジェクトなど、より広範な入力を処理します。これはプレーンなJSONができることを超えています。
103+
* **シリアライズ不可能**: これらの入力はキャッシュキーの一部ではありません。これらの値をキャッシュしようとすると、サーバー「参照」を返します。この参照はNext.jsによってランタイム時に元の値に復元されます。
104+
105+
`id`をキャッシュキーに含めることを覚えていたとしましょう:
106+
107+
```
108+
await cache(async () => {
109+
return await db
110+
.select()
111+
.from(notifications)
112+
.limit(limit)
113+
.offset(index)
114+
.where(eq(notifications.userId, id));
115+
}, [id, index, limit]);
116+
```
117+
118+
これは入力値がシリアライズ可能な場合に機能します。しかし、`id`がReact要素やより複雑な値だった場合、入力キーを手動でシリアライズする必要があります。`id`プロパティに基づいて現在のユーザーを取得するサーバーコンポーネントを考えてみましょう:
119+
120+
```
121+
async function Profile({ id, children }) {
122+
'use cache';
123+
const user = await getUser(id);
124+
125+
return (
126+
<>
127+
<h1>{user.name}</h1>
128+
{/* childrenを変更してもキャッシュが破綻しない...なぜ? */}
129+
{children}
130+
</>
131+
);
132+
}
133+
```
134+
135+
これがどのように機能するか見ていきましょう:
136+
137+
1. コンパイル時に、Next.jsは`'use cache'`ディレクティブを認識し、キャッシュをサポートする特別なサーバー関数を作成するようにコードを変換します。コンパイル時にキャッシュが行われるわけではなく、Next.jsはランタイムキャッシュに必要なメカニズムを設定しています。
138+
2. コードが「キャッシュ関数」を呼び出すと、Next.jsは関数の引数をシリアライズします。JSXのように直接シリアライズできないものは「参照」プレースホルダーに置き換えられます。
139+
3. Next.jsは、指定されたシリアライズされた引数に対してキャッシュされた結果が存在するかどうかを確認します。結果が見つからない場合、関数はキャッシュする新しい値を計算します。
140+
4. 関数が終了すると、戻り値がシリアライズされます。戻り値のシリアライズ不可能な部分は参照に戻されます。
141+
5. キャッシュ関数を呼び出したコードは出力をデシリアライズし、参照を評価します。これにより、Next.jsは参照を実際のオブジェクトや値と交換できるため、`children`のようなシリアライズ不可能な入力も元の、キャッシュされていない値を保持できます。
142+
143+
これは、`<Profile>`コンポーネントだけを安全にキャッシュし、子をキャッシュしないことを意味します。後続のレンダリングでは、`getUser()`は再度呼び出されません。`children`の値は動的であるか、異なるキャッシュ寿命を持つ別個のキャッシュ要素かもしれません。これがコンポーザブルキャッシュです。
144+
145+
[これは見覚えが...](#this-seems-familiar)
146+
--------------------------------------------
147+
148+
「サーバーとクライアントのコンポジションと同じモデルのように感じる」と考えているなら、まったく正しいです。これは時々「ドーナツ」パターンと呼ばれます:
149+
150+
* **外側**の部分はデータ取得や重いロジックを処理するサーバーコンポーネント
151+
* 中央の****はインタラクティブ性を持つかもしれない子コンポーネント
152+
153+
```tsx filename="app/page.tsx"
154+
export default function Page() {
155+
return (
156+
<ServerComponent>
157+
{/* クライアントへの穴を作成 */}
158+
<ClientComponent />
159+
<ServerComponent />
160+
);
161+
}
162+
```
163+
164+
`'use cache'`も同じです。ドーナツは外側のコンポーネントのキャッシュされた値で、穴はランタイム時に埋められる参照です。これが`children`を変更してもキャッシュされた出力全体が無効化されない理由です。子は後で埋められる参照に過ぎません。
165+
166+
[タグ付けと無効化については?](#what-about-tagging-and-invalidation)
167+
----------------------------------------------------------------------------
168+
169+
キャッシュの寿命はさまざまな[プロファイル](/docs/app/api-reference/functions/cacheLife)で定義できます。デフォルトのプロファイルセットが含まれていますが、必要に応じてカスタム値を定義できます。
170+
171+
```
172+
async function getUser(id) {
173+
'use cache';
174+
cacheLife('hours');
175+
let res = await fetch(`https://api.vercel.app/user/${id}`);
176+
return res.json();
177+
}
178+
```
179+
180+
特定のキャッシュエントリを無効化するには、[キャッシュにタグを付け](/docs/app/api-reference/functions/cacheTag)、`revalidateTag()`を呼び出します。強力なパターンの1つは、データ(例えばCMSから)を取得した後にキャッシュにタグを付けられることです:
181+
182+
```
183+
async function getPost(postId) {
184+
'use cache';
185+
let res = await fetch(`https://api.vercel.app/blog/${postId}`);
186+
let data = await res.json();
187+
cacheTag(postId, data.authorId);
188+
return data;
189+
}
190+
```
191+
192+
[シンプルで強力](#simple-and-powerful)
193+
-------------------------------------------
194+
195+
`'use cache'`の目標は、キャッシュロジックの作成をシンプルかつ強力にすることです。
196+
197+
* **シンプル**: ローカルな推論でキャッシュエントリを作成できます。キャッシュキーエントリの忘れや、コードベースの他の部分への意図しない変更といったグローバルな副作用を心配する必要はありません。
198+
* **強力**: 静的に分析可能なコードだけでなく、ランタイム時に変更される可能性のある値など、より多くのものをキャッシュできます。
199+
200+
`'use cache`はNext.js内部ではまだ**実験的**です。テストする際の早期フィードバックをお待ちしています。
201+
202+
[ドキュメントで詳細を確認](/docs/app/api-reference/directives/use-cache)。
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
source-updated-at: 2025-05-29T18:05:49.000Z
3+
translation-updated-at: 2025-06-02T19:18:20.141Z
4+
title: Create Next App の紹介
5+
description: >-
6+
本日、新しい Create Next App を紹介できることを嬉しく思います。Create Next App は、1つのコマンドで Next.js を利用したモダンな React アプリケーションをセットアップします。
7+
author:
8+
- name: Joe Haddad
9+
image: /static/team/timer.jpg
10+
- name: Tim Neutkens
11+
image: /static/team/tim.jpg
12+
date: 2019-10-09T15:02:30.543Z
13+
image: >-
14+
https://h8DxKfmAPhn8O0p3.public.blob.vercel-storage.com/static/blog/create-next-app/twitter-card.png
15+
---
16+
17+
本日、新しい Create Next App を紹介できることを嬉しく思います。
18+
19+
Create Next App は、1つのコマンドで Next.js を利用したモダンな React アプリケーションをセットアップします。
20+
21+
開始するには、次のコマンドを実行するだけです:
22+
23+
```bash filename="Terminal"
24+
npx create-next-app
25+
```
26+
27+
Create Next App は、最高の開発者体験を提供するためにゼロから再構築されました:
28+
29+
* **インタラクティブな体験**: 引数なしで `npx create-next-app` を実行すると、プロジェクトセットアップをガイドするインタラクティブな体験が開始されます。
30+
* **依存関係ゼロ**: プロジェクトの初期化はわずか**1秒**で可能です。Create Next App には依存関係がなく、**たったの 604 kB** でインストールされます。最適化前の以前のバージョンは **5.38 MB** でした。これは **4.7 MB 以上**の削減です!
31+
* **オフラインサポート**: Create Next App は自動的にオフライン状態を検出し、ローカルのパッケージキャッシュを使用してプロジェクトをブートストラップします。
32+
* **新しいデフォルトプロジェクトテンプレート**: Create Next App は、モダンな Next.js アプリケーション向けに設計された新しいプロジェクトテンプレートを使用します。Create Next App は Next.js 本体と共にメンテナンスされるため、このテンプレートは常に最新の Next.js バージョンに対応しています!
33+
* **サンプルプロジェクトのサポート**: Create Next App は [Next.js サンプル集](https://github.com/vercel/next.js/tree/canary/examples) のサンプルを使用してアプリケーションをブートストラップできます(例: `npx create-next-app --example api-routes`)。
34+
* **テスト済み**: このパッケージは Next.js モノレポの一部であり、Next.js 自体と同じ統合テストスイートを使用してテストされています。これにより、各リリースで期待通りに動作することが保証されます。
35+
36+
Create Next App は以前は [コミュニティでメンテナンス](https://open.segment.com/create-next-app/) されていましたが、Next.js の第一印象を管理することが重要だと感じました。特に [Next.js サンプル集](https://github.com/vercel/next.js/tree/canary/examples) で推奨しているためです。
37+
38+
[Segment](https://segment.com/) と協力してパッケージの所有権を移管し、特に [Fouad Matin](https://twitter.com/fouadmatin) 氏によるこれまでの管理に非常に感謝しています。

0 commit comments

Comments
 (0)