リンククローラーの概要

mablで新しいアプリケーションを作成すると、「Check all pages for broken links (すべてのページのリンク切れやエラーの有無をチェック)」というプランが作成されます。このプランは、「Visit all linked pages within the app (アプリ内のすべてのリンク先ページにアクセス)」というテストを実行します。これはリンククローラーとも呼ばれ、週1回無料で行われます。

リンククローラーテストでは、アプリケーション内のリンク切れの可能性が通知されます。リンククローラーテストの出力は、アプリケーションのテストカバレッジを計算する基準にもなります。詳細については、ページカバレッジに関する記事を参照してください。

仕組み

リンククローラーテストでは、最初にアプリケーションのURLを読み込み、DOMスナップショットとページ上の各アンカー要素のハイパーリンクを収集します。

リンクのチェック

リンククローラーは、GETリクエストを用いて各リンクを検証し、HTTPステータスにエラーがないことを確認します。次のいずれかのカテゴリに属する場合は、リンク切れと見なされます。

4xxまたは5xxステータスが返される
リダイレクト回数が多すぎる
リンクとして識別されたURLの形式が正しくない

リンクがアプリケーションのURLのドメインと一致していて、有効なコンテンツタイプを含む場合、このリンクはページキューに追加されます。

たとえば、アプリケーションのURLがhttps://app.example.comである場合、リンククローラーはhttps://app.example.com/supportにアクセスしますが、https://example.com/blogにはアクセスしません。これは、ドメインがアプリケーションのURLのドメインと一致しないためです。

有効なコンテンツタイプには、以下が含まれます。

text/html
application/xhtml+xml
application/xml

キュー内のページへのアクセス

リンククローラーでページ上のリンクのチェックが終わると、リンククローラーはページキュー内の次のページにアクセスし、そのページのリンクをチェックします。この処理はリンククローラーがキュー内のすべてのページにアクセスするまで繰り返されます。

📘
注
リンククローラーテストでは、最大500ページにアクセスし、最大10,000件の固有のリンクをチェックできます。

リンク切れレポートの生成

テストが終了すると、リンククローラーはエラー応答を返すリンクのリストを含むリンク切れレポートを生成します。ダウンロードボタンをクリックすると、リンク切れレポートがCSV形式でダウンロードされます。

詳細情報

リンククローラーテストの詳細については、次の記事をご確認ください。