みなさんこんにちは、どうぞ テストメイス！ おそらく多くの人が私たちのことを知っているでしょう 私たちの 前 物品。 参加したばかりの方へ: 私たちは TestMace API と連携する IDE を開発中です。 TestMace を競合製品と比較するときに最もよく聞かれる質問は、「Postman とどう違うのですか?」です。 私たちは、この質問に詳しく答える時期が来たと判断しました。 以下に当社の利点を概説します Postman.

ノードへの分割

Postman を使用している場合は、リクエスト インターフェイスに必要な機能がすべて含まれていることをご存知でしょう。 スクリプト、テスト、そして実際にはクエリ自体があります。 これにより初心者にとっては簡単になりますが、大規模なシナリオでは、このアプローチは柔軟性がありません。 複数のクエリを作成し、それらに対して集計を実行したい場合はどうすればよいでしょうか? リクエストなしでスクリプトを実行したい場合や、論理的に分離された複数のスクリプトを連続して実行したい場合はどうすればよいでしょうか? 結局のところ、テストを通常のユーティリティ スクリプトから分離することは良い考えです。 さらに、「すべての機能を XNUMX つのノードに追加する」アプローチはスケーラブルではなく、インターフェイスはすぐに過負荷になってしまいます。

TestMace は、最初にすべての機能をさまざまなタイプのノードに分割します。 リクエストをしてみませんか？ それはあなたのためです リクエストステップ ノード脚本を書きたいですか？ それはあなたのためです スクリプト ノードテストが必要ですか? お願いします - アサーション ノードそうそう、この全体を次のようにまとめることができます。 フォルダ ノードこれらすべてを簡単に組み合わせることができます。 このアプローチは非常に柔軟であるだけでなく、単一責任の原則に従って、現時点で本当に必要なものだけを使用することもできます。 リクエストを行うだけの場合、なぜスクリプトやテストが必要なのでしょうか?

人間が読めるプロジェクト形式

TestMace と Postman には、保存方法に概念的な違いがあります。 Postman では、すべてのリクエストはローカル ストレージのどこかに保存されます。 複数のユーザー間でリクエストを共有する必要がある場合は、組み込みの同期を使用する必要があります。 実際、これは一般的に受け入れられているアプローチですが、欠点がないわけではありません。 データのセキュリティについてはどうですか? 結局のところ、一部の企業のポリシーでは、第三者へのデータの保存が許可されていない場合があります。 ただし、TestMace にはさらに優れた機能があると考えています。 そして、この改善の名前は「人間が読めるプロジェクト形式」です。

TestMace には原則として「プロジェクト」エンティティが存在するという事実から始めましょう。 そして、このアプリケーションは当初、プロジェクトをバージョン管理システムに保存することを目的として開発されました。プロジェクト ツリーはファイル構造にほぼ XNUMX 対 XNUMX で投影され、yaml が保存形式 (余分な括弧やカンマなし) として使用されます。各ノードのファイル表現については、コメント付きのドキュメントで詳しく説明されています。 しかし、ほとんどの場合、そこに目を向けることはありません。すべてのフィールド名には論理名が付いています。

これはユーザーに何を与えるのでしょうか? これにより、使い慣れたアプローチを使用して、チームのワークフローを非常に柔軟に変更できます。 たとえば、開発者はバックエンドと同じリポジトリにプロジェクトを保存できます。 ブランチでは、コード ベース自体の変更に加えて、開発者は既存のクエリ スクリプトとテストを修正できます。 リポジトリ (git、svn、mercurial - 好きなもの) に変更をコミットした後、CI (誰にも強制されていないお気に入りのもの) がコンソール ユーティリティを起動します。 テストメイス-cli、実行後に受信したレポート (たとえば、testmace-cli でもサポートされている junit 形式) が適切なシステムに送信されます。 そして、前述のセキュリティの問題はもう問題ではありません。

ご覧のとおり、TestMace はそのエコシステムやパラダイムを強制しません。 むしろ、確立されたプロセスに簡単に適合します。

動的変数

TestMace はノーコードの概念に従っています。つまり、コードを使用せずに問題を解決できる場合は、その機会を提供しようとします。 変数の操作は、ほとんどの場合、プログラミングなしで実行できる種類の機能です。

例: サーバーから応答を受信したので、応答の一部を変数に保存したいと考えています。 Postman では、テスト スクリプト (これ自体が奇妙です) で次のように記述します。

var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("data", jsonData.data);

しかし、私たちの意見では、このような単純で頻繁に使用されるシナリオのスクリプトを作成するのは冗長であるように思えます。 したがって、TestMace では、グラフィカル インターフェイスを使用して、回答の一部を変数に割り当てることができます。 いかにシンプルかを見てください:

そして、リクエストごとにこの動的変数が更新されるようになります。 しかし、Postman アプローチの方がより柔軟で、割り当てを行うだけでなく、いくつかの前処理も実行できると主張して、反対することもできます。 前の例を変更する方法は次のとおりです。

var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("data", CryptoJS.MD5(jsonData.data));

さて、この目的のために TestMace は スクリプト このシナリオをカバーするノード。 TestMace によってすでに実行されている前のケースを再現するには、リクエストに従ってスクリプト ノードを作成し、次のコードをスクリプトとして使用する必要があります。

const data = tm.currentNode.prev.response.body.data;
tm.currentNode.parent.setDynamicVar('data', crypto.MD5(data));

ご覧のとおり、ノードの構成はここでもうまく機能しました。 そして、上で説明したような単純なケースの場合、単純に次の式を割り当てることができます。 ${crypto.MD5($response.data)} 変数は GUI 経由で作成されます。

GUIによるテストの作成

Postman を使用すると、スクリプト (Postman の場合は JavaScript) を記述してテストを作成できます。 このアプローチには、ほぼ無制限の柔軟性、既製のソリューションの可用性など、多くの利点があります。

しかし、現実は多くの場合 (私たちはそうではありません。人生はそのようなものです)、テスターはプログラミング スキルを持っていないものの、今はチームに利益をもたらしたいと考えています。 このような場合、TestMace ではノーコードの概念に従って、スクリプトを作成することなく GUI を介して簡単なテストを作成できます。 たとえば、値が等しいかどうかを比較するテストを作成するプロセスは次のようになります。

ただし、グラフィカル エディタでテストを作成しても、その可能性は排除されません。 コードでテストを書く。 スクリプト ノードと同じライブラリがすべてここにあり、 酒蔵 テストを書くため。

リンクを介して既存のスクリプトを実行する機能 (リンク ノード)

特定のクエリやスクリプト全体をプロジェクトの異なる部分で複数回実行する必要がある場合がよくあります。 このようなリクエストの例としては、環境を望ましい状態にするカスタムの多段階認証などが挙げられます。 一般に、プログラミング言語の観点から言えば、アプリケーションのさまざまな部分で再利用できる関数が必要です。 TestMace では、この機能は次のように実行されます。 ノード使い方はとても簡単です:
1) クエリまたはスクリプトを作成する
2) リンクタイプのノードを作成します
3) パラメータで、最初のステップで作成したスクリプトへのリンクを指定します。

より高度なバージョンでは、スクリプトのどの動的変数をリンクよりも高いレベルに渡すかを指定できます。 わかりにくいと思いませんか？ 次の名前のフォルダーを作成したとします。 作成投稿、その中で動的変数がこのノードに割り当てられます postId。 現在リンクノード内にあります リンクの作成 変数を明示的に指定できます postId 先祖に割り当てられた リンクの作成。 このメカニズムは (やはりプログラミング言語で)、「関数」から結果を返すために使用できます。 全体的にクールで、DRY は本格的に普及しており、ここでもコードは XNUMX 行も破損していません。

Postman に関しては、リクエストを再利用するための機能リクエストがあります 2015年から吊り下げられている、さらにはあるようです いくつかのヒント彼らはこの問題に取り組んでいるとのこと。 もちろん、現在の形式では、Postman には実行スレッドを変更する機能があり、理論的にはおそらく同様の動作を実装することが可能ですが、これは実際に機能するアプローチというよりは、汚いハッキングに近いものです。

その他の違い

• 変数のスコープをより細かく制御できます。 Postman で変数を定義できる最小のスコープはコレクションです。 TestMace を使用すると、任意のクエリまたはフォルダーの変数を定義できます。 Postman 共有コレクションではコレクションのみをエクスポートできますが、TestMace では共有はどのノードでも機能します
• TestMace がサポートする 継承可能なヘッダー、デフォルトで子クエリに置き換えることができます。 ポストマンはこれについて次のように述べています。 チャレンジ、さらには閉鎖されていますが、解決策として提供されています... スクリプトを使用する。 TestMace では、これはすべて GUI を介して構成され、特定の子孫で継承されたヘッダーをオプションで無効にするオプションがあります。
• 元に戻す/やり直し。 ノードの編集時だけでなく、移動、削除、名前変更など、プロジェクトの構造を変更する操作時にも機能します。
• リクエストに添付されたファイルはプロジェクトの一部となり、Postman とは異なり完全に同期されながらプロジェクトと一緒に保存されます。 (はい、起動するたびにファイルを手動で選択し、アーカイブ内の同僚に転送する必要はなくなりました)

すでに開発中の機能

特に機能が非常に優れており、すでにリリース前の磨きがかかっている場合には、次のリリースで秘密のベールを取り除きたいという誘惑に抵抗することができませんでした。 それでは、会いましょう。

機能

ご存知のとおり、Postman はいわゆる動的変数を使用して値を生成します。 それらのリストは印象的です そして、関数の大部分は偽の値を生成するために使用されます。 たとえば、ランダムな電子メールを生成するには、次のように記述する必要があります。

{{$randomEmail}}

ただし、これらは変数 (動的ではありますが) であるため、関数として使用することはできません。パラメーター化できないため、文字列からハッシュを取得することはできません。

TestMace には「正直」な機能を追加する予定です。 ${} の内部では、変数にアクセスできるだけでなく、関数を呼び出すこともできます。 それらの。 悪名高い偽メールを生成する必要がある場合は、次のように書きます。

${faker.internet.email()}

これが関数であるという事実に加えて、オブジェクトのメソッドを呼び出すことができることに気づくでしょう。 また、動的変数の大きくてフラットなリストの代わりに、論理的にグループ化されたオブジェクトのセットが用意されています。

文字列のハッシュを計算したい場合はどうすればよいでしょうか? 簡単に！

${crypto.MD5($dynamicVar.data)}

変数をパラメータとして渡すこともできることに気づくでしょう。 この時点で、好奇心旺盛な読者は何かが間違っていると疑うかもしれません...

式での JavaScript の使用

...それには十分な理由があります。 関数の要件が形成されているときに、有効な JavaScript は式で記述する必要があるという結論に突然到達しました。 したがって、次のような式を自由に記述できるようになりました。

${1 + '' + crypto.MD5('asdf')}

これらすべてをスクリプトなしで、入力フィールド上で行うことができます。

Postman に関して言えば、ここでは変数しか使用できず、ほんのわずかな式を書こうとすると、バリデーターは罵倒して計算を拒否します。

高度なオートコンプリート

現在、TestMace には次のような標準のオートコンプリートがあります。

ここでは、オートコンプリート行に加えて、この行が何に属しているかが示されています。 このメカニズムは、括弧 ${} で囲まれた式でのみ機能します。

ご覧のとおり、変数のタイプ (文字列、数値、配列など) を示す視覚的なマーカーが追加されています。 オートコンプリート モードを変更することもできます (たとえば、変数またはヘッダーを使用したオートコンプリートを選択できます)。 しかし、これさえも最も重要なことではありません。

まず、オートコンプリートは式内でも機能します (可能な場合)。 これは次のようになります。

次に、スクリプトでオートコンプリートが利用できるようになりました。 仕組みを見てみましょう！

この機能を Postman と比較することは意味がありません。オートコンプリートは、変数、ヘッダー、およびそれらの値の静的リストにのみ制限されています (何か忘れた場合は修正してください)。 スクリプトはオートコンプリートされません:)

まとめ

XNUMX月で製品開発開始からXNUMX年を迎えました。 この間、私たちは多くのことを成し遂げることができ、いくつかの点では競合他社に追いつくことができました。 しかし、それはともかく、私たちの目標は、API を操作するための本当に便利なツールを作成することです。 私たちにはまだやるべきことがたくさんあります。来年のプロジェクト開発の大まかな計画は次のとおりです。 https://testmace.com/roadmap.

皆様のフィードバックにより、豊富な機能をより適切に操作できるようになります。また、皆様のサポートは、私たちが正しいことをしているという力と自信を与えてくれます。 たまたま今日は私たちのプロジェクトにとって重要な日です。TestMace が公開された日です。 ProductHunt。 私たちのプロジェクトをサポートしてください。それは私たちにとって非常に重要です。 さらに、今日のPHページには魅力的なオファーがあり、限定されています

出所： habr.com