XPath テスターの概要と機能
「XPath テスター」は、提供された XML または HTML コンテンツに対して XPath 式をテストするためのツールです。このツールを使用することで、指定した XPath 式に一致するコンテンツ内のすべての部分を特定し、そのタイプ、名前、パス、および値のプレビューを検査することができます。また、個々の結果の値を簡単にコピーすることも可能です。
入力項目と制限事項
本ツールでは、以下の情報を入力として受け付けます。
- XML / HTML 入力: XML または HTML 形式のテキストコンテンツを入力します。入力可能な最大文字数は 500,000 文字です。
- XPath 式: テストしたい XPath 式を入力します。入力可能な最大文字数は 4,000 文字です。
- 入力タイプ: 「XML」または「HTML」のいずれかのモードを選択します。
出力情報と結果の確認
テストを実行すると、以下の出力および詳細情報が表示されます。
- 結果数: 一致したノードの総数が表示されます。
- 詳細: 一致した各ノードについて、そのタイプ、名前、パス、およびプレビューが表示されます。
- 結果をコピー: 個々の結果の値をコピーするためのボタンが提供されます。
- 文字数: 入力されたドキュメントの文字数が表示されます。
- 結果数（統計）: 画面上に表示されている結果の数が示されます。
動作ルールとエラーメッセージ
ツールを快適かつ安全にご利用いただくため、以下の評価ルールと制限事項が設けられています。
- タイムアウト: ページの応答性を維持するため、XPath 式の評価は 2 秒後に自動的に停止します。処理に時間がかかりすぎた場合は、「この XPath の実行は制限時間を超過しました。式を絞り込むか、より小さなサンプルを使用してください。」というメッセージが表示されます。
- ドキュメントのサイズ制限: 入力されたドキュメントが大きすぎる場合、「このドキュメントは、ここでテストするには大きすぎます。より小さなサンプルでお試しください。」と表示されます。
- XPath 式の長さ制限: XPath 式が長すぎる場合は、「この XPath 式は、ここでテストするには長すぎます。」と表示されます。
- 解析エラー: 入力ドキュメントが解析できない形式である場合、「このドキュメントを解析できませんでした。」と表示されます。
- 無効な式: 入力された XPath 式が正しくない場合は、「この XPath 式は有効ではありません。」と表示されます。
- 評価エラー: XPath の評価自体が行えなかった場合は、「この XPath を評価できませんでした。」と表示されます。
- 結果なし: 一致する結果が見つからない場合は、「結果はありません。」と表示されます。
- 件数制限: 一致する結果が 200 件を超えた場合、ツールは「最初の
{max}件を表示しています。」と表示し、最初の 200 件のみを出力します。
なお、本ツールはオンライン上のウェブページのリアルタイムな構造、レンダリングされた DOM、またはネットワークリクエストを再現するものではありません。
XML モードと HTML モードの違い
選択する入力タイプによって、評価のルールが異なります。
- XML モード: XML 名前空間のルールが厳格に適用されます。XML 内で宣言されている名前空間プレフィックスは、XPath 内で
//x:itemのように使用することができます。また、デフォルト名前空間が設定されている場合、//itemもそのドキュメントの宣言に従って評価されます。 - HTML モード: 柔軟な解析が行われます。
//aのようなシンプルなパスを使用して、通常のタグに簡単に一致させることができます。
プライバシーとデータ処理
プライバシー保護のため、入力された XML、HTML、および XPath のテスト処理はすべてお客様のお使いのブラウザ内で行われます。データが BroBroGo にアップロードされることは一切ありません。
よくある質問（FAQ）
XML だけでなく HTML に対しても XPath をテストできますか？
はい、テストできます。XML モードでは XML 名前空間のルールが適用されます。HTML モードはより柔軟で、//a のようなシンプルなパスで通常のタグに一致させることができます。
XML 名前空間はどのように機能しますか？
XML 内で宣言されている名前空間プレフィックスは、XPath 内で //x:item のように使用できます。デフォルト名前空間の場合、//item もドキュメントの宣言に従います。
クエリがタイムアウトするのはなぜですか？ 非常に大きなドキュメントや広範囲な式は、評価に時間がかかる場合があります。このツールはページの応答性を維持するために2秒後に処理を停止します。パスを絞り込むか、より小さなサンプルでお試しください。