HTTP クライアント

HTTP リクエストスクラッチファイルを作成する

• Ctrl+Alt+Shift+Insert を押して HTTP リクエスト を選択します。

物理 HTTP リクエストファイルを作成する

• ファイル メニューで 新規 をポイントし、 HTTP リクエスト をクリックします。

HTTP リクエストを移動する

F6 リファクタリング 移動を使用して、HTTP リクエストをスクラッチから物理ファイルに移動したり、物理ファイル間で移動したりできます。

1. エディターで移動するリクエストにキャレットを置き、次のいずれかを実行します：

   • メインメニューまたはコンテキストメニューから、 リファクタリング | 移動 を選択します。

   • Alt+Enter を押して、 HTTP リクエストの移動 インテンションアクション を選択します。

   • F6 を押す。

2. 開いた HTTP リクエストの移動 ダイアログで、次の手順を実行します。

   1. パス フィールドでリストから既存の .http ファイルを選ぶか、 でファイルを指定します。

      ファイルへのフルパスを手動で入力することもできます。 存在しないファイルの名前を指定すると、指定した名前の新しいファイルが自動的に作成されます。

   2. リクエスト リストで移動したいリクエストのチェックボックスを選択します。

   

カスタム HTTP メソッドを作成する

Web サービスでカスタム HTTP メソッドが必要な場合、WebStorm に追加して HTTP リクエストで利用可能です。

1. .http ファイルで、カスタムメソッドを大文字で入力します。

2. この方法が不明としてハイライトされたら、 Alt+Enter (コンテキストアクションの表示) を押して カスタム HTTP メソッドを追加する を選択します。

WebStorm は自動的に有効な HTTP メソッドとして認識します。 すべてのカスタム HTTP メソッド (および新しいメソッドの追加) は、IDE 設定 (Ctrl+Alt+S) の ツール | HTTP クライアント | カスタム HTTP メソッド にあります。

HTTP リクエストコレクションからリクエストを開く

1. リクエストのエディターパネルの上部にある サンプル ショートカットリンクをクリックします。

2. ポップアップメニューで、開く HTTP リクエストコレクションを選択します：

   

構造ツールウィンドウを使用して .http ファイル内を移動する

.http ファイルに複数のリクエストがある場合、 構造 ツールウィンドウは、ファイルをすばやくプレビューしてファイル内を移動できます。 ツールウィンドウには、ヘッダー、リクエスト本文、事前リクエストスクリプト、応答ハンドラースクリプトなどのリクエスト部分も表示されます。

1. 構造 ツールウィンドウを開きます: 表示 | ツールウィンドウ | 構造。

   あるいは、 Alt+7 を押します。

2. 構造 ツールウィンドウで、HTTP メソッドまたはリクエスト名、あるいはリクエストの一部をクリックします。

右クリックして を選択することで、そこからリクエストを送信することもできます。

単一のリクエストを実行する

1. 独自の Web サービスをテストする場合は、Web サービスがデプロイされ、実行されていることを確認してください。

2. 環境を定義している場合は、リクエストのエディターパネルの上部にある 実行環境で実行する リストで環境を選択します。

3. ガターで、リクエストの横にある をクリックします。

複数のリクエストを順番に実行する

.http ファイルからのすべてのリクエストを一度に実行できます。 これは、サーバーから特定のデータをリクエストし、それを client.global 変数として保存し、そのデータを含む後続のリクエストを送信するなどの複雑なシナリオに役立ちます。

1. .http ファイルを開きます。

2. エディターパネルの上部にある (ファイル内のすべてのリクエストを実行) をクリックします。

すべてのリクエストを別の .http ファイルから実行する

1. .http ファイルで、 run に続けて、含める別の .http の名前を入力します。 ファイルが同じディレクトリにある場合は、その名前を入力します。 そうでない場合は、パスを指定します。 例：

   run ./myFolder/get-requests.http

2. このファイルからのすべてのリクエストを送信するには、 run の横にある をクリックします。

別の .http ファイルから特定のリクエストを実行する

1. .http ファイルの先頭に、 import と入力し、その後に必要なリクエストを含む別の .http の名前を入力します。

2. run と入力し、実行するリクエストの名前を指定します。

   Ctrl+Space を押すと、インポートされたファイルで利用可能なすべてのリクエストを表示できます。

   

インポートされた .http ファイルからの変数を上書きする

インポートされた .http ファイルに変数が含まれている場合は、特定の実行に対してその値を指定または変更できます。

1. run と入力し、 .http ファイルまたはリクエストの名前を指定します。

2. リクエストまたはファイルの名前の後に、 (@variable=value) 形式で変数を入力します。 複数の変数を指定するには、コンマで区切ります。 例：

   import new-requests.http run #GET request with one var (@host=example.com) run #GET request with two vars (@host=example.com, @user=userName)

受け取った応答を見る

1. レスポンス受信直後に自動表示される サービスツールウィンドウに切り替えます。

2. デフォルトでは、サーバーのレスポンスはリクエストヘッダーの content-typeフィールドで指定された形式で表示されます。 レスポンスを他のフォーマットへ変換する場合は、 をクリックし、 テキスト​、 JSON、 XML 、または HTML（エイチティーエムエル） を選択してください。

   

レスポンスにバイナリファイルが含まれている場合、このファイルも .idea/httpRequests/ ディレクトリに保存されます。 レスポンスがイメージ、PDF、HTML ファイルの場合は、IDE 内で直接プレビューできます。

サービス ツールウィンドウでイメージをプレビューします。

サービス ツールウィンドウで PDF ファイルをプレビューします。 サービス ツールウィンドウで PDF プレビューの表示を無効にするには、 をクリックして PDF プレビューのインライン化を有効化 オプションをクリアします。

応答が HTML ファイルの場合は、 プレビューの表示 をクリックして、JCEF ベースのブラウザーを使用してエディタータブでプレビューできます。

レスポンスハンドラースクリプトがある場合、このスクリプトの一部として実行されたテストの結果は、 サービス ツールウィンドウの テスト タブに表示されます。 各テストをクリックすると、対応するレスポンスハンドラースクリプト内のテストソースコードに簡単に移動できます。

イベントストリームをサブスクライブすると、WebStorm は サービス ツールウィンドウにイベントを表示します。 ここでは、 をクリックして、クライアント / サーバー接続のステータスを表示し、接続を終了することもできます。 コンテンツタイプ（text/event-stream または application/x-ndjson のいずれか）に応じて、応答はプレーンテキストまたは改行で区切られた JSON としてフォーマットされます。 イベントストリームの各行を処理する応答ハンドラースクリプトを作成できます。

ストリームイベントのファイルへの リダイレクトは現在サポートされていません。

エディターで応答ファイルを開く

1. 開きたいレスポンスへのリンクにキャレットを置きます。

2. 次のいずれかを実行します：

   • メインメニューで 表示 | ソースに移動 へ移動します。

   • Ctrl+B または F4 を押します。

   • サービス ツールウィンドウまたはエディター (スクラッチファイルの場合) で、応答行のリンクを Ctrl+Click します。

     

     

JSONPath を使用して JSON レスポンスからデータを抽出する

HTTP クライアントは JSONPath クエリをサポートしており、受信した JSON ドキュメントからデータを解析して抽出することができます。 これを行うには、 応答ハンドラースクリプトで次の関数を使用します。

この関数をすばやく挿入するには、 jsonPath ライブテンプレートを使用します。

1. リクエスト後、応答ハンドラースクリプト部分で、 > jsonPath と入力し始めます。

2. Enter を押してライブテンプレートを展開し、JSONPath 式を補完します。

   例: この式は、 slideshow オブジェクトの一部である slides 配列内の最初の要素の title フィールドの値を取得して出力します。

   GET https://examples.http-client.intellij.net/json > {% client.log(jsonPath(response.body, "$.slideshow.slides[0].title",)) %}

   取得した値を サービス ツールウィンドウの レスポンスハンドラー タブでプレビューします。

XPath を使用して XML 応答からデータを抽出する

HTTP クライアントは XPath 式に対応しており、受信 XML 文書のデータ解析や抽出が可能です。

1. 応答ハンドラースクリプトでは、次の関数を使用します。

   xpath(XMLToParse, XPathExpression)

2. XMLToParse に解析する XML コンテンツ (たとえば、 response.body) を入力し、 XPathExpression に XPath 式を入力します。

例：

スクラッチファイル内のレスポンスを比較する

スクラッチファイルからリクエストが実行されると、応答出力ファイルへのリンクが元のリクエストの下に追加されます。

• 以下のいずれかを行います：

  • 応答ファイルへのリンクにキャレットを置きます。 Alt+Enter を押し、 <レスポンス名> と比較 インテンションアクションを選びます。

  • ガターの をクリックし、リストから <レスポンス名> と比較 を選択します：

    

リクエスト履歴の応答を比較する

物理ファイルからリクエストが実行されると、応答出力へのリンクが リクエストの履歴に追加されます。

1. 応答ファイルへのリンクにキャレットを置きます。 メインメニューで 表示 | ソースに移動 に移動するか、 Ctrl+B または F4 を押して、このファイルを新しいエディタータブで開きます。

2. メインメニューで 表示 | 比較 に移動するか、 Ctrl+D を押します。 WebStorm は httpRequests フォルダーから応答ファイルを開くよう促します。

3. 現在のファイルと比較する応答ファイルを選択し、 開く をクリックします。

2 つの応答ファイルが 差分ビューアーで開かれ、それらの内容を比較できます。

リクエスト履歴を開く

• リクエストのエディターパネルの上部にある をクリックします。

• メインメニューから ツール | HTTP クライアント | HTTP リクエスト履歴を表示 を選択します。

出力をカスタムファイルまたはディレクトリにリダイレクトする

• HTTP クライアントは、出力をカスタムファイルまたはディレクトリにリダイレクトできます。 強制リダイレクトとソフトリダイレクトの 2 つの演算子をサポートしています。

  • >> オペレーターは常に新しいファイルを作成し、要求されたファイル名がすでに存在する場合は、ファイル名に -n 接尾辞を追加します。

  • >>! オペレーターは、ファイルがすでに存在する場合、ファイルを書き換えます。

始める前に

• JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの マーケットプレース タブに プロトコルバッファおよび gRPC プラグインをインストールします。

proto ファイルから gRPC リクエストを生成する

• proto ファイルで、RPC メソッドの近くにある HTTP クライアントでリクエストを生成 をクリックします。

gRPC メタデータを送信する

• GRPC リクエストに、次の構文を使用して gRPC メタデータを入力します: Metadata-key: Value

  例：

  GRPC localhost:8080 X-Myhostname: Example.org

安全な gRPC を使用する

サーバー側 TLS で保護された接続も開始できます。

• アドレスの前に grpcs を入力してください。例：

  GRPC grpcs://ijhttp-examples.jetbrains.com/hello.HelloService/SayHello

複数のメッセージを送信する

• === セパレーターを使用して、複数のメッセージを送信します。

  { "message": "First message sent on connection" } === // message separator { "message": "Second message" } === { "message": "Third message" }

サーバーの応答後にメッセージを送信する

• メッセージの前に、 === wait-for-server と入力します。

  これにより、HTTP クライアントはメッセージを送信する前にサーバーの応答を待機します。 === wait-for-server 行を繰り返すことにより、複数の応答を待つことができます。 例: 次のメッセージは、3 つのサーバー応答の後に送信されます。

  === wait-for-server === wait-for-server === wait-for-server { "message": "This messages is sent after 3 server responses" }

インタラクティブにメッセージを送信する

接続を開始すると、 サービス ツールウィンドウから直接サーバーと対話できます。 新しいメッセージごとにメッセージを送信したり、サーバーの応答を表示したりできます。

1. サービス ツールウィンドウで、開いている接続を選択します。

2. ウィンドウの下部の WebSocket に送信されるメッセージ に、メッセージの内容を入力します。

3. その右側で、メッセージ形式（プレーンテキスト、JSON、XML、HTML）を選択します。

4. Ctrl+Enter を押してリクエストを送信します。

ウィンドウ上部にサーバー応答が表示されます。

GraphQL クエリを使用して HTTP リクエストを作成する

1. .http ファイルに、 GRAPHQL キーワードに続けてサーバーアドレスを入力します。

2. リクエストの本文で、GraphQL 操作（クエリ、ミューテーション、サブスクリプション）を作成します。例:

   ### HTTP request with GraphQL query GRAPHQL http://localhost:8080/graphql query { toDos { title, completed, author { username } } }

GraphQL クエリ入り HTTP リクエストの作成を高速化するには、次のことができます：

• .http ファイルのエディターパネルの上部にある をクリックし、 GraphQL クエリリクエスト を選択します。

• .http ファイルで、 gqlr と入力し、 Enter を押して GraphQL ライブテンプレートを適用します。

GraphQL 変数を使用する

HTTP リクエスト本文でクエリ文字列と分離して動的データを渡したい場合、GraphQL 変数が利用可能です。

• クエリ部分の後に JSON 変数辞書を入力します：

  query ($name: String!, $capital: String!) { country(name: $name, capital: $capital) { name capital } } { "name": "France", "capital": "Paris" }

  HTTP クライアント環境変数を GraphQL 変数値として利用することもできます。 例えばこの JSON では、 "{{Author}}" が環境変数となり、リクエスト送信時に選択した環境に応じて実行時値が決まります：

  { "author": "{{Author}}" }

1. 設定 ダイアログ（Ctrl+Alt+S ）で、 外観 & 振る舞い の システム設定 を選択し、次に HTTP プロキシ を選択します。

2. 開いた HTTP プロキシダイアログで 手動プロキシ構成 を選択し、以下を指定します：

   • ホスト名 および ポート番号 フィールドにプロキシのホスト名とポート番号を入力します。

   • 認証を有効にするには、 プロキシ認証 チェックボックスを選択して、対応するフィールドにユーザー名とパスワードを入力します。

証明書へのパスを指定

1. .http ファイルの 実行環境で実行する リストで、 環境を Private ファイルに追加… を選択します。

2. 開いた http-client.private.env.json ファイルで、必要な環境に SSLConfiguration オブジェクトを追加します。 clientCertificate に、クライアント証明書へのパスを入力します。 証明書キーが別のファイルに保存されている場合は、そのパスを clientCertificateKey に入力します。 例：

   { "dev": { "MyVar": "SomeValue", "SSLConfiguration": { "clientCertificate": "cert.pem", "clientCertificateKey": "MyFolder/key.pem" } } }

   また、 clientCertificate と clientCertificateKey をオブジェクトとして記述することもでき、パスに加えて証明書のフォーマットを指定できます。 例：

   { "dev": { "SSLConfiguration": { "clientCertificate": { "path": "file.crt", "format": "PEM" }, "clientCertificateKey": { "path": "file.key", "format": "DER" } } } }

証明書のパスフレーズを設定する

クライアント証明書を生成するときにパスフレーズを使用した場合は、それを HTTP クライアントに提供する必要があります。

1. http-client.private.env.json ファイルで、 "hasCertificatePassphrase": true を SSLConfiguration オブジェクトに追加します。例:

   { "dev": { "SSLConfiguration": { "clientCertificate": "file.crt", "hasCertificatePassphrase": true } } }

2. ガターの をクリックするか、キャレットを hasCertificatePassphrase に置いて Alt+Enter を押し、 ''{0}'' の値を設定 を選択します。

3. 表示されたウィンドウで証明書のパスフレーズを入力してください。

   

パスフレーズを今すぐ入力したくない場合は、2 番目の手順を省略できます。 この場合、WebStorm は HTTPS リクエストを実行する際にパスフレーズの入力を求めます。

証明書の検証を無効にする

開発目的で、自己署名証明書または期限切れの証明書を持つホストがある場合があります。 このホストを信頼する場合は、その証明書の検証を無効にすることができます。

• http-client.private.env.json ファイルで、 verifyHostCertificate": false を SSLConfiguration オブジェクトに追加します。 例：

  { "sslTest": { "SSLConfiguration": { "verifyHostCertificate": false } } }

この環境でリクエストを実行すると、WebStorm はホスト証明書を検証しません。