一つのリンクを取得可能な住所へ変える
文書のURLをhttps://learn.example/guide/ch1.htmlとし、リンク先が../images/map.svg?size=2#keyだったとします。ブラウザはリンクの文字列をそのままサーバーへ渡す前に、基準URLを使って解決します。結果はhttps://learn.example/images/map.svg?size=2#keyです。ホスト名を組み合わせるだけでは、guideというディレクトリから一段戻る意味を処理できません。この教材では、URLを解釈し、どの情報を後段へ渡すかを決める部分を作ります。ページ取得や画像の描画は、その結果を受け取る別の処理です。
この例の処理を状態として並べると、最初は基準と参照の文字列だけ、次はスキームを引き継いだ絶対URL、最後は接続情報と要求対象へ分かれた結果になります。途中でimagesというパス要素を見つけても、それをホスト名として扱いません。実装上は、入力文字列、解決されたURL、ナビゲーションの実行状況を一つの変数へ上書きするよりも、別の型やフィールドへ分ける方が検査できます。特に相対参照がホストを書き換えるか、パスだけを書き換えるかを、結果の差分として確認してください。この段階で取得済みの本文やHTTP状態を持っていないことも、模型の初期条件です。
接続先と要求先を別々に記録する
HTTPSの例では、スキームとホスト、必要ならポートから接続先を決めます。HTTP要求の対象には通常、パスとクエリを使います。フラグメントのkeyは文書内の位置を表し、HTTP要求の対象には含めません。同じページで#introから#summaryへ移る操作なら、保持している文書内で移動できる場合があります。URLの全要素が毎回サーバーへ届くと考えると、ログにフラグメントがない理由を説明できません。ユーザー情報を含むURLなど、今回扱わない入力も、通常のパスへ混ぜずに拒否します。
| 要素 | この例の値 | 後段での用途 |
|---|---|---|
| ホスト | learn.example | 接続先の名前 |
| パス | /images/map.svg | 要求するリソース |
| クエリ | ?size=2 | 要求へ含める追加条件 |
| フラグメント | #key | 文書内の位置 |
相対参照は基準URLがなければ確定しない
同じnext.htmlでも、基準が/guide/ch1.htmlなら/guide/next.html、基準が/guide/なら同じく/guide/next.htmlになります。一方、/guideを基準にすると最後のguideはファイル相当の位置として扱われ、/next.htmlへ解決されます。末尾のスラッシュは単なる見た目ではありません。また、/assets/logo.svgはホスト直下からのパス、//static.example/logo.svgはスキームを引き継いでホストを変える参照です。演習では基準と入力を別々に編集し、一度に片方だけを変えて解決結果を比べます。
空の参照、?lang=en、#summaryという三つも、同じ基準URLへ与えて比べます。?lang=enは元のパスを保ってクエリを置き換え、#summaryはパスとクエリを保ってフラグメントを変えます。これらを通常のファイル名と同じ連結規則で処理すると、?や#をパス文字へ混ぜる不具合が出ます。エンコードされた%2Fを、解決前に機械的に/へ置き換えることも避けます。解決、成分の取得、表示のための復号には順序と目的があるためです。最初の対応範囲では英数字の短いパスを使い、エンコードや国際化ホストの本格対応は参照実装との試験を伴って追加します。
文字列の分割とURL解析を区別する
URLをコロンやスラッシュでsplitするだけでは、IPv6アドレスやエンコードされた区切りなどを正しく扱えません。最初の実装ではHTTP・HTTPSの短い入力に対象を限定し、対応外を明示します。実際のURL APIを比較用に使う場合も、それを自作パーサの実装成果と数えません。たとえばURL APIのhostnameはホストを返し、hostはポートを含む場合があります。接続先、表示用の住所、オリジンの比較にどの値が必要かを、呼び出し側の責任として整理してください。
正規化した結果と元の入力を照合する
基準に対して相対参照を解決した後、絶対URL、要求対象、オリジンを並べます。次の短いコードは標準URL APIで期待値を確かめる比較用です。自作部分が同じ結果を返すかは、各ケースで別に試験します。入力に#keyを加えても要求対象が変わらないこと、クエリを変えると要求対象が変わることを確認してください。二つのURLが同じオリジンかどうかだけでは、同じリソースや同じ権限で取得できるとは判断できません。各比較の目的を先に決めます。
比較用プログラムでは、URLオブジェクトが持つhashを要求対象へ加えていない点に注目します。要求対象を作る関数を独立させれば、絶対URLの表示方法を変更したときにもHTTPの入力が変わらないことを試験できます。戻り値には、成功なら各成分、失敗なら入力位置またはエラーの分類を持たせます。成功結果と失敗理由を同じ空文字で表すと、ルートの/と解析不能を呼出し側が区別できません。また、httpとhttps以外を受理するかを明示します。任意のスキームを受け付けることは、ブラウザ内で任意の処理を起動してよいという許可にはなりません。
const u = new URL('../images/map.svg?size=2#key', 'https://learn.example/guide/ch1.html');
console.assert(u.href === 'https://learn.example/images/map.svg?size=2#key');
console.assert(u.pathname + u.search === '/images/map.svg?size=2');
console.assert(u.origin === 'https://learn.example');取得できたことと遷移の完了を分ける
住所を解釈できても、名前解決や接続、HTTP応答の取得に成功するとは限りません。応答が返っても、別の場所へのリダイレクトや、表示対象として扱えない内容かもしれません。最初の模型では固定した応答だけを用い、外部サイトへ任意の要求を送りません。履歴に積む住所と現在表示する文書も区別し、解析エラーの段階で表示中の文書を消さないようにします。失敗した新しい遷移と、すでに存在する古い文書は、別の状態として保持すると説明しやすくなります。
課題:末尾とフラグメントだけを変える
基準URLがhttps://learn.example/a/b、参照がc?x=1#endのとき、絶対URLとHTTP要求対象を求めてください。解答はhttps://learn.example/a/c?x=1#endと/a/c?x=1です。次に基準末尾へ/を足すと、絶対URLはhttps://learn.example/a/b/c?x=1#endへ変わります。最後に#endを#topへ変えても、要求対象は変わりません。どの文字を変えたかだけでなく、変わった出力と変わらない出力を一行ずつ記録できれば、URL解析と取得処理の境界を理解できています。
追加の試験として、同じURLのフラグメントだけを変えた二件では要求対象が一致すること、クエリを変えた二件では一致しないことを確認します。さらにhttps://learn.example:443/aとhttps://learn.example/aを比較するときは、表示文字列の一致とオリジンの一致を別々に判定します。既定ポートの正規化を扱う実装なら、その結果を期待値へ明記します。最後に基準URLが欠けた相対参照を入力し、解析失敗が既存の成功結果を偽装していないか確かめます。正常系だけでなく、失敗した試行の後に成功例を再実行して同じ結果が得られることも、再開可能なデモの試験です。