XPath オンラインテストツール

いつ使うか

ウェブスクレイピングコードで商品価格のリンクを抽出したい、または自動化テストスクリプト内の要素位置をデバッグしたい、あるいは特定のHTMLセクション内に特定のタグがいくつあるか知りたい場合——XPathで一行で位置指定できます。しかし、XPathを正しく書いたかどうか？表現式は簡単にタイプミスします。当社のXPathオンラインテストツールでは、HTML/XMLドキュメントを貼り付け、XPathを書き、マッチング数とハイライト内容をすぐに表示でき、何度もページを更新したり開発者ツールを開く手間が省けます。

1文での説明

XPathはXMLドキュメント内でノードを見つけるためのパス言語で、ファイルシステムのディレクトリパスに似ています。例えば//div[@class='price']は「class属性がpriceと等しいすべてのdiv要素」を意味します。これはドキュメント内の要素に「アドレス」を与えると考え、このアドレスを使って直接それらを取得できるようにするものです。開発者は頻繁にこれを使ってウェブページからデータを抽出したり、自動化フローを制御したりします。

このツールの使い方

1. テストドキュメントを準備する：当社のツールページを開くと、大きなマルチラインテキストボックス（ラベルは「XML/HTMLドキュメント」）が表示されます。テストしたいウェブページのソースコードまたはXMLスニペットを貼り付けます。手元にない場合は、サンプルデータボタンを使用してデフォルトのHTMLを読み込むことができます。
2. XPath式を書く：隣の入力ボックス（ラベルは「XPath式」）に選択パスを入力します。例えば//a/@hrefはすべてのハイパーリンクのアドレスを抽出することを意味します。
3. 「テスト」ボタンをクリック：ツールはすぐにドキュメントを解析し、式を実行します。
4. 結果を確認：下の「マッチング結果」エリアに、マッチしたノードの数が表示され、各ノードのテキストまたは属性値がリスト形式で表示されます。ドキュメント内にハイライト機能がある場合、マッチしたノードはドキュメントプレビューでもマークされます。
5. 式を調整する：結果が正しくない場合は、XPathを修正してもう一度テストをクリックし、目的のデータが得られるまで繰り返します。

完全な例：商品リストの抽出

単純な商品HTMLがあると仮定しましょう（ドキュメントボックスに貼り付け）：

<div id="products">
  <div class="item">
    <span class="name">ワイヤレスマウス</span>
    <span class="price">¥39.9</span>
  </div>
  <div class="item">
    <span class="name">メカニカルキーボード</span>
    <span class="price">¥129</span>
  </div>
</div>

すべての商品名を抽出したいとします。XPathボックスに//span[@class='name']/text()を入力します。テストをクリックすると、結果エリアに「2つのノードにマッチしました」と表示され、以下のようにリストされます：
1. ワイヤレスマウス
2. メカニカルキーボード
名前と価格を一度に取得したい場合は、ユニオン選択を使用するか、要素の親ノードを返すことができますが、初心者はまず単純な式を使用してください。

別の対照例を見てみましょう。//span[@class='price']と書いた場合（/text()を加えない）、マッチング結果は「2つのノード」と表示されますが、各ノードは<span class="price">¥39.9</span>のような完全なタグになります——XPathはデフォルトでノードを返すため、テキストではありません。目的が数字を取得することなら、/text()またはstring()を加えることを忘れないでください。

典型的な使用シーン

• スクレイピング開発者：ECサイトから商品タイトルと価格を抽出する際に、コード実行前にツールでXPath式を検証し、パスが間違っていることをあとで発見する手間を省きます。
• フロントエンド自動化テスト：SeleniumまたはPlaywrightで要素定位を書く際に、HTMLスニペットを先にこのツールで検証してからテストスクリプトにコピーします。
• データアナリスト：XMLコンフィグファイルやRSSフィードからデータを抽出する必要が時々あるため、XPathで迅速にフィルタリングでき、任何ソフトウェアをインストールする必要がありません。
• APIデバッグ：一部のAPIがXMLデータを返す場合、特定フィールドを抽出したいときは、貼り付けて式の結果を確認できます。

一般的な誤用 / よくある落とし穴

• 名前空間を忘れる：ドキュメントにデフォルト名前空間がある場合（SOAPやSVGなど）、//tagは通常マッチしないため、名前空間プレフィックスを最初に登録する必要があります。当ツールは現在、名前空間がないか明示的なプレフィックスでのマッチのみサポートしており、名前空間が発生した場合はlocal-name()関数を手動で削除するか使用してください。
• 大文字小文字の区別：XPathはタグ名と属性名に大文字小文字を区別します。HTMLでは<Div>と<div>のように大文字小文字が混在することが多く、2つの異なるノードであるため、式を書くときは注意が必要です。
• //の不正な使用がパフォーマンスの問題を引き起こす：ツールは小さなドキュメントを迅速に処理しますが、実際の大きなドキュメントで//を乱用するとすべてのノードをスキャンするため、/html/body/div[1]/のような具体的なパスを使用して効率を向上させることをお勧めします。
• パスに余分なスペースがある：//div [@class=...]（角括弧の前に空白がある）は構文エラーで、ツールは「無効な式」と表示します。式を書くときはスペースをランダムに追加しないでください。
• text()がすべてのテキストを取得できると思う：text()は直接テキスト子ノードのみを返し、ネストされた要素内のテキストは自動的にマージされません。すべてのテキストを取得するにはstring()またはnormalize-space()を使用してください。

注意事項 / 制限と制約

• ドキュメントサイズの制限：ページのレスポンス速度のため、貼り付けられるXML/HTMLドキュメントは500KB以下に制限されています。非常に大きなファイルは、フラグメントに分割してテストすることをお勧めします。
• XSLTなどの拡張関数をサポートしていない：ツールは標準XPath 1.0のみを実装しています（ほとんどのブラウザのデフォルト実装）。XPath 2.0/3.0の算術、型変換、正規表現などの関数はサポートされていません。
• 名前空間処理：現在、デフォルト名前空間を自動的に処理できないため、式内でlocal-name()を手動で使用するか、名前空間宣言を先に削除する必要があります。
• 実行環境：ツールはブラウザフロントエンドで実行され、ドキュメントや式を保存しないため、ページを更新するとすぐに失われます。結果を時間内に保存してください。
• 機密データのテストに使用しないでください：ローカル処理ですが、ネットワーク転送プロセス（HTTPS暗号化）に注意し、パスワードやキーなどの機密情報を含むテキストを貼り付けないことをお勧めします。

よくある質問 FAQ

1. HTMLを貼り付けましたが、XPathがノードを見つけられません
   HTMLが正しいか確認してください（例：タグが閉じているか、属性値が引用符で囲まれているか）。不正なHTMLは予期しない構造の解析につながる可能性があります。ブラウザ開発者ツールで「Copy outerHTML」を試してみてください。
2. 式は正しいですが、結果は空リストです
   考えられる原因は、パスの大文字小文字が間違っている、属性値のスペルが違っている、またはXPathで@class='value'を使用しているが実際の属性値の前後に空白がある場合です。まず//*を使ってすべての要素を確認し、段階的に絞り込みます。
3. contains()関数をサポートしていますか？
   サポートしています。例えば//div[contains(@class, 'price')]はclass属性に「price」を含むdivにマッチします。
4. ハイパーリンクのhrefとテキストを抽出したいのですが、どう書きますか？
   //aを使ってすべてのa要素を返すと、結果フレームにノードのテキスト（inner text）が表示されます。href属性を取得するには//a/@hrefを使用しますが、属性ノードが返されてテキストは空であることに注意してください。2つの式を同時に書いて2回テストするか、マルチ式機能を使用できます（ツールが提供している場合）。
5. このツールは実際のウェブサイトでXPathの効果をテストできますか？
   貼り付けた静的ドキュメントのみをテストできます。ツールはネットワークリクエストを行わないため、動的に読み込まれるコンテンツをシミュレートできません。動的ページをテストするにはブラウザ開発者ツールを使用してください。
6. 結果フレームに[object Text]などが表示されていて、目的のテキストではありません
   これは、XPathがテキストノードオブジェクトを文字列ではなく返しているためです。式の末尾に/text()または/string()を追加して文字列を取得します。

上の入力ボックスで、自分のHTMLとXPath式を試してみてください。