フロントエンド

どのようなものか

フロントエンドは、ソフトウェアシステムのうち、人が見て操作する部分で
す。ページ、画面、フォーム、操作部品と、それを描いて入力へ応じるコー
ドを含みます。英語ではfront
endやfront-endとも書き、ウェブでは、同じ領域をクライアント側ともよく
呼びます。

ウェブでは、ブラウザーが理解する三つの言語で作ります。HTMLが構造と意
味を、CSSが見た目を、JavaScriptが振る舞いを与えます。ブラウザーは、
W3CのArchitecture
of the World Wide
Webが、利用者に代わってサーバーからデータを取得し表示するソフトウェ
ア、ユーザーエージェントと呼ぶものです。フロントエンドが送るものはす
べて、サービス提供者とは別の人が所有するデバイスへ届きます。

対になるのは、データを保存し、業務規則を適用し、要求へ答えるバックエ
ンドです。通常はAPIを通じ、HTTPで通信します。ネットワークを境界にし
たくなりますが、今のフレームワークは、それを曖昧にします。Next.jsで
は、ページとレイアウトは、既定でサーバーコンポーネントです。利用者の
見るものを作っても、実行するのはサーバーです。ファイル先頭の`"use
client"`が境界を示し、そのファイル、インポートしたもの、描くコンポー
ネントが、ブラウザーへ送るバンドルに入ります。コードがフロントエンド
になる理由は、表示と操作という役割です。実行場所は、別の判断です。

なぜ重要なのか

最初に決めるのは、処理をどこで行うかです。W3Cのアーキテクチャー文書
は、クライアントがすべてを処理する構成から、サーバーがすべてを処理す
る構成までの幅を示し、多くの設計が両者を組み合わせていると述べていま
す。処理をどこに置くかは、同文書によれば、クライアントの能力、サー
バーの能力と負荷、両者の間の帯域幅によって決まります。双方のトレード
オフも説明します。サーバーで内容を個別化するとキャッシュの効率が下が
り、クライアント数に上限がなければ、計算をそちらへ分散する方が、規模
を広げやすくなります。一般的なのは、一度だけ作るページ、要求ごとに
サーバーで描くページ、ブラウザーで組み立てるページ、その混合です。全
員に同じなら、一度作ってキャッシュするのが最も安く、特定の顧客のデー
タなら、どこかで要求ごとに描きます。ブラウザーを選べば、読者全員が、
そのコードを取得します。

二つ目は、どこまで信頼するかです。実際の答えは、サーバーは何も信頼し
ない、というものです。ブラウザーを持つ人は、届いたものを読み、変え、
再送できます。隠したボタンや送信を拒むフォームは、正直な利用者への配
慮で、ほかの人には、小さい回り道です。そのため、重要な権限と検証は、
サーバーで繰り返します。秘密も同じです。バンドルへ届いたAPIキーは、
変数名にかかわらず公開です。Content
Security
Policyは、注入したスクリプトのできることを狭めます。仕様も、多層防御
とし、慎重な入力検証と出力の符号化を、決して置き換えないとします。

アクセシビリティーも、ここで決まります。2024年12月公開のW3C勧告、
WCAG
2.2は、検査できる達成基準を定め、多くがフロントエンドの選択にかかり
ます。キーボードで操作部品へ届いて使えるか、支援技術へ名前と役割を示
すか、などです。標準のHTML要素はいくつかの要件を最初から満たします
が、独自のウィジェットでは、それぞれの要件を満たす動作を手作業で実装
し直す必要があります。

そして、データベースの保存方法を知るフロントエンドは、データベースの
変更のたびに、変わらなければなりません。表示に専念すれば、両側をそれ
ぞれの都合に合わせて変更できます。

実際の活用例

あるプラットフォームのNext.js
16のフロントエンドは、アプリの部分ごとに、描画方法を選びます。マーケ
ティングと公開のページは静的に生成し、操作する部分はブラウザーで描き
ます。ログイン後のダッシュボードや大規模なディレクトリー一覧では、
N+1によって、一ページが往復通信の連鎖になっていました。
`createPrefetchedServerPage`というファクトリーが、サーバーでデータを
先に取り、取得済みの状態でクライアントへ渡します。各データ要求につい
て、キャッシュの無効化方針も文書化しています。移したページは、一往復
で読み込め、次に移行するページも、その動作を引き継ぎます。移行は進行
中で、認証が必要なアプリの残りの部分は、クライアントで描画しながら移
行の順番を待っています。

創業者による、海事プラットフォームNextMarinerでの設計への貢献は、フ
ロントエンドの仕事を、一つだけにします。Next.jsのフロントエンドは、
表示と操作を担当します。Fiber上のHumaで作る、責務を意図的に絞ったGo
のAPIが、経路を決め、検証し、セキュリティフィルターを適用し、処理を
調整します。業務ロジックは、PostgreSQLの関数に置きます。同じ規則を三
層すべてに実装するのではなく、SQLという一層だけで業務規則を変更でき
る設計です。境界を文書化し、コードレビューで守りました。記録された結
果は、表示、要求の処理、業務規則の責任が、分かれたことです。

アプリを強化する仕事は、クライアントを敵対的と見なすことから始まりま
す。フロントエンドでは、Next.jsの`proxy.ts`のプロキシーミドルウェア
が、要求ごとに生成したnonceと`strict-dynamic`を持つContent
Security Policyを、HSTS、SameSite
Cookieとともに設定します。境界自体は、サーバーです。利用プランの段
階、役割、組織と船舶の範囲を含む権限を、サーバーで全要求に対して再確
認します。フロントエンドの制限は、利用体験にすぎません。見えるものを
形作り、できることは、サーバーが決めます。

問題が起きるところ

問題は、ブラウザーで決めたことがサーバーの仕事だった、または、その逆
だった、という原因を共有しがちです。

全訪問者が取得できるJavaScriptへ、APIキーが出ます。
Next.jsでは、名前が`NEXT_PUBLIC_`で始まる環境変数だけが、ブラウザー
のバンドルへ届きます。クライアントコードから読むほかの変数は、空の文
字列になります。要求が認可されないからと、動かすために環境変数の名前
を急いで変えると、公開ファイルへ秘密を埋め込みます。秘密を使うコード
はサーバーへ置き、モジュールに`server-only`パッケージを読み込ませ、
クライアントコンポーネントからのインポートで、ビルドを失敗させます。
すでに外部へ配信されたキーは、すべて交換します。

```ts
import "server-only";
export async function getInvoices(customerId: string) {
    const url = `${process.env.BILLING_URL}/customers/${customerId}/invoices`;
    const headers = { Authorization: `Bearer ${process.env.BILLING_KEY}` };
    const res = await fetch(url, { headers });
    return res.json();
}
```

画面が隠した記録へ、利用者が届きます。
権限の検査が、ルートガード、隠したメニュー、無効化されたボタンとし
て、フロントエンドにありました。通信を読む人は、別の引数でAPIを直接
呼べます。要求ごとに、すべての権限を、ログイン中の利用者と該当する記
録に照らして、サーバーで確かめます。画面側は、正直な利用者の利便性と
して扱います。

読み込み表示ごとに、少しずつ埋まります。
各コンポーネントが、描いた後でデータを取り、子コンポーネントの要求が
親コンポーネントの要求を待つため、ページの読み込みが、往復通信の連鎖
するウォーターフォールになります。一ページのデータをまとめてデータの
取得元に近い場所で、フレームワークが対応している場合はサーバー側で取
得し、子コンポーネントへ渡します。

独自の部品を、キーボードやスクリーンリーダーの利用者が操作できませ
ん。
クリックできる`div`は、マウスでボタンのように操作できても、ボタンに
備わるほかの機能はありません。フォーカスを受けず、EnterとSpaceを無視
し、支援技術へ種類も示しません。WCAG
2.2は、レベルAで、全機能のキーボード操作を2.1.1、全コンポーネントの
名前と役割を4.1.2で求めます。`button`、`a`、`input`、`label`を、本来
の用途で使い、公開前に、新しい画面をすべて、キーボードだけで試しま
す。

参考資料

  * World Wide Webのアーキテクチャー、第一巻 —
ユーザーエージェントと、クライアントとサーバーの分担についての、W3C
勧告です。

  * HTML標準 — ウェブのフロントエンドを作る、要素とブラウザーAPIにつ
いての、WHATWGのLiving
Standardです。

  * ウェブコンテンツのアクセシビリティー指針、WCAG 2.2 —
操作画面のアクセシビリティーの基となる、検査可能な達成基準を持つW3C
勧告です。

  * Content Security Policy Level 3 —
nonceと`strict-dynamic`を定義する、W3Cの作業草案です。

  * Next.js：サーバーとクライアントのコンポーネント —
一つのフレームワークが、フロントエンドのコードをサーバーとブラウザー
へどう分担させるかを説明します。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/frontend/	engineer.company	70
