こんにちは、みんな。私たちは影から徐々に姿を現し、製品に関する一連の記事を続けています。後 前へ レビュー記事では、多くのフィードバック (ほとんどが肯定的なもの)、提案、バグレポートを受け取りました。今日はご紹介します テストメイス 実際に動作してみると、アプリケーションの機能の一部を理解できるでしょう。より完全に没入するには、次のドキュメントを参照することをお勧めします。 http://docs-ru.testmace.com。じゃ、行こう！

インストール

ありきたりな話から始めましょう。このアプリケーションは、Linux、Windows、MacOS の 3 つのプラットフォームで利用可能であり、実際にテストされています。興味のある OS のインストーラーを次からダウンロードできます。 私たちのサイト。 Linuxユーザーの場合はインストール可能です スナップパッケージ。 Microsoft Store と App Store がすぐにそれに対応することを心から願っています (必要ですか? どう思いますか?)。

実験シナリオ

テスト対象として次の標準シナリオを選択しました。

• ログイン: ユーザー - 管理者、パスワード - パスワード
• 新しいエントリを追加する
• レコードが正しく追加されたことを確認してみましょう

テストします https://testmace-quick-start.herokuapp.com/。これは正常です json サーバー、このようなアプリケーションのテストに最適です。すべての json-server ルートにトークンによる承認を追加し、このトークンを受け取るログイン メソッドを作成しました。私たちはプロジェクトを徐々に改善しながら、段階的に進めていきます。

プロジェクトを作成し、承認なしにエンティティを作成しようとしています

まず、新しいプロジェクトを作成しましょう(File->新しいプロジェクト）。アプリケーションを初めて起動する場合は、新しいプロジェクトが自動的に開きます。まず、新しいレコードを作成するリクエストを行ってみましょう (承認なしでレコードの作成が可能な場合)。プロジェクト ノードのコンテキスト メニューから項目を選択します ノードを追加 -> リクエストステップ。ノード名を次のように設定します。 作成投稿。その結果、ツリーに新しいノードが作成され、このノードのタブが開きます。次のリクエストパラメータを設定しましょう。

• リクエストタイプ: POST
• URL： https://testmace-quick-start.herokuapp.com/posts
• リクエスト本文: 値を含む json {"title": "New testmace quick start post"}
  すべてを正しく実行すると、インターフェイスは次のようになります。

ただし、リクエストを実行しようとすると、サーバーは 401 コードを返し、許可がなければこのサーバーでは何も取得できません。まあ、一般的には予想通りです）。

認可リクエストの追加

すでに述べたように、POST エンドポイントがあります。 /login、これは json をフォームのリクエスト本文として受け取ります。 {"username": "<username>", "password": "<password>"}どこ username и password (繰り返しになりますが、上記の導入段落から) には意味があります admin и password それぞれ。応答として、このエンドポイントは次のような json を返します。 {"token": "<token>"}。認証に使用させていただきます。作成しましょう リクエストステップ 名前付きノード ログイン、祖先として機能します プロジェクト ノードドラッグ アンド ドロップを使用して、ツリー内の特定のノードをそのノードよりも高い位置に移動します 作成投稿。新しく作成したリクエストに次のパラメータを設定しましょう。

• リクエストタイプ: POST
• URL： https://testmace-quick-start.herokuapp.com/login
• リクエスト本文: 値を含む json {"username": "admin", "password": "password"}

リクエストを実行し、レスポンス内のトークンを含む 200 番目のコードを受信して​​みましょう。このようなもの：

リファクタリング: ドメインの重複を削除する

これまでのところ、リクエストは単一のスクリプトにリンクされていません。しかし、欠点はこれだけではありません。よく見ると、両方のリクエストで少なくともドメインが重複していることがわかります。良くない。今後のスクリプトのこの部分をリファクタリングする時期が来ました。変数はこれに役立ちます。

大まかに言うと、変数は他の同様のツールやプログラミング言語と同じ役割を果たします - 重複を排除し、可読性を高めます。変数について詳しくは、 私たちのドキュメント。この場合、ユーザー変数が必要になります。

プロジェクトノードレベルで変数を定義しましょう domain 意味のある https://testmace-quick-start.herokuapp.com。 このために必要です

• このノードを含むタブを開き、右上の電卓アイコンをクリックします。
• クリック + 変数の追加
• 変数名と値を入力します
  この場合、変数が追加されたダイアログは次のようになります。

わかりました。継承により、この変数を任意のネスト レベルの子孫で使用できるようになりました。私たちの場合、これらはノードです ログイン и 作成投稿。テキストフィールドで変数を使用するには、次のように記述する必要があります。 ${<variable_name>}。たとえば、ログイン URL は次のように変換されます。 ${domain}/login、それぞれ 作成投稿 ノードの URL は次のようになります ${domain}/posts.

したがって、DRY 原則に基づいて、シナリオをわずかに改善しました。

トークンを変数に保存する

変数について話しているので、このトピックを少し拡張してみましょう。現時点では、ログインに成功すると、サーバーから認証トークンを受け取ります。これは後続のリクエストで必要になります。このトークンを変数に保存しましょう。なぜなら変数の値はスクリプトの実行中に決定されます。これには特別なメカニズムを使用します。 動的変数.

まず、ログイン要求を実行しましょう。タブ内 解析済み 回答するには、カーソルをトークンの上に移動し、コンテキスト メニュー (マウスの右ボタンまたはボタンをクリックすると呼び出されます) で項目を選択します。 変数に代入する。次のフィールドを含むダイアログが表示されます。

• パス — 答えのどの部分が採用されるか (私たちの場合は body.token)
• 現在の価値 — パスに沿って存在する値 (この場合、これはトークン値です)
• 変数名 — 変数の名前。 現在の価値 保存されます。私たちの場合は次のようになります token
• Node — どの祖先に変数が作成されるか 変数名。プロジェクトを選択しましょう

完成したダイアログは次のようになります。

これで、ノードが実行されるたびに ログイン 動的変数 token 応答からの新しい値で更新されます。そして、この変数は次の場所に保存されます プロジェクト ノードに追加され、継承のおかげで子孫も利用できるようになります。

動的変数にアクセスするには、次を使用する必要があります。 組み込み変数 $dynamicVar。たとえば、保存されたトークンにアクセスするには、次のように呼び出す必要があります。 ${$dynamicVar.token}.

認可トークンをリクエストに渡します

前の手順で認証トークンを受け取りました。後はヘッダーを追加するだけです。 Authorization 意味のある Bearer <tokenValue> 承認を必要とするすべてのリクエスト（以下を含む） 作成投稿。これを行うにはいくつかの方法があります。

1. トークンを手動でコピーし、対象のリクエストに認可ヘッダーを追加します。この方法は機能しますが、その使用は「作成して捨てる」タイプのリクエストにのみ限定されます。スクリプトの繰り返し実行には適していません
2. 機能を使用する 認可.
3. 使用する デフォルトのヘッダー

2 番目の方法を使用するのは明らかですが、この記事の文脈では、このアプローチは面白くありません。そうですね、実際のところ、承認メカニズムプラスマイナスは他のツールでよく知られています (たとえ次のようなものがあっても) 認可の継承）そして疑問が生じる可能性は低いです。

もう 1 つはデフォルトのヘッダーです。簡単に言うと、デフォルト ヘッダーは、明示的に無効にしない限り、デフォルトでリクエストに追加される継承された HTTP ヘッダーです。この機能を使用すると、たとえば、カスタム認証を実装したり、スクリプト内の重複を単純に削除したりできます。この機能を使用して、ヘッダーでトークンを渡してみましょう。

以前は、トークンを動的変数に慎重に保存していました。 $dynamicVar.token プロジェクトノードレベルで。残っているのは次のことを行うだけです。

1. デフォルトのタイトルを定義する Authorization 意味のある Bearer ${$dynamicVar.token} プロジェクトノードレベルで。これを行うには、ノードのプロジェクト インターフェイスで、デフォルトの見出し (ボタン ヘッダ をクリックして)、対応するタイトルを追加します。値が入力されたダイアログは次のようになります。
   
2. ログイン要求からこのヘッダーを無効にします。これは当然のことです。ログイン時にはまだトークンを持っていないため、このリクエストでトークンをインストールします。したがって、タブのリクエストのログインインターフェイスで ヘッダ の領域における 遺伝性 Authorization ヘッダーのチェックを外します。

それだけです。これで、ログイン ノードを除く、プロジェクト ノードの子であるすべてのリクエストに認証ヘッダーが追加されます。この段階ではすでにスクリプトの準備ができていることがわかり、あとはそれを起動するだけです。を選択してスクリプトを実行できます。 ラン プロジェクト ノードのコンテキスト メニュー内。

投稿作成が正しいかどうかを確認する

この段階で、スクリプトはログインし、認証トークンを使用して投稿を作成できます。ただし、新しく作成された投稿の名前が正しいことを確認する必要があります。つまり、本質的に残っているのは次のことを行うことだけです。

• IDで投稿を受信するリクエストを送信し、
• サーバーから受信した名前が投稿の作成時に送信された名前と一致することを確認します。

最初のステップを見てみましょう。 ID 値はスクリプトの実行中に決定されるため、動的変数 (次のように呼びます) を作成する必要があります。 postId) ノードから 作成投稿 プロジェクトノードレベルで。これを行う方法はすでに知っています。セクションを参照してください。 トークンを変数に保存する。残っているのは、この ID を使用して投稿を受信するリクエストを作成することだけです。これを行うには、RequestStep を作成しましょう ポストを受け取る 次のパラメータを使用します。

• リクエストタイプ: GET
• URL: ${ドメイン}/posts/${$dynamicVar.postId}

2 番目のステップを実装するには、次のことを理解する必要があります。 アサーション 結び目。アサーション ノードは、特定のリクエストに対するチェックを作成できるノードです。各アサーション ノードには、複数のアサーション (チェック) を含めることができます。あらゆる種類のアサーションの詳細については、 ドキュメンテーション。 我々は使用するだろう Compare 演算子によるアサーション equal。アサーションを作成するにはいくつかの方法があります。

1. 長さ。 RequestStep ノードのコンテキスト メニューからアサーション ノードを手動で作成します。作成したアサーション ノードで、対象のアサーションを追加し、フィールドに値を入力します。
2. 速い。コンテキスト メニューを使用して、RequestStep ノード応答からのアサーションとともにアサーション ノードを作成します。

2 番目の方法を使用してみましょう。私たちの場合は次のようになります。

理解できない人のために、何が起こっているかを次に示します。

1. ノードでリクエストを行う ポストを受け取る
2. タブ内 解析済み 応答し、コンテキスト メニューを呼び出して選択します アサーションの作成 -> 比較 -> 等しい

おめでとうございます。最初のテストが作成されました。シンプルですね。これで、スクリプトを完全に実行して結果を楽しむことができます。残っているのは、それを少しリファクタリングして取り出すことだけです title 別の変数に入れます。ただし、これは宿題として残しておきます)

まとめ

このガイドでは、本格的なシナリオを作成し、同時に製品の機能の一部を確認しました。もちろん、すべての機能を使用したわけではありません。次の記事で、TestMace の機能の詳細な概要を説明します。乞うご期待！

追伸すべての手順を再現するのが面倒な人のために、親切に記録しました。 リポジトリ 記事のプロジェクトを使って。次のように開くことができます File -> プロジェクトを開く をクリックしてプロジェクトフォルダーを選択します。

出所： habr.com