DevWeb JavaScript SDK

このセクションでは、JavaScript SDK for DevWebスクリプトの一部であるさまざまなオブジェクト、メソッド、およびプロパティについて説明します。

スクリプトに使用される概念と構造については、スクリプト構造を参照してください。

注: スクリプトを手動で作成している場合は、BOMなしでUTF-8エンコーディングを使用していることを確認してください。

このトピックの内容:

フロー制御

この機能グループは、仮想ユーザーのライフサイクルのフロー制御を担当する機能を提供します。

先頭に戻る

WebRequest

このオブジェクトを使用すると、AUTにWeb要求を送信できます。WebRequestを作成するときに、要求に必要なすべての構成を含むオプションオブジェクトを渡すことができます。次に、要求を非同期または同期で送信できます。

メソッド

先頭に戻る

WebResponse

このオブジェクトは、WebRequestの結果として返されます。自分で作成する必要はありません。

プロパティ

方法

先頭に戻る

WebSocket

AUTへのWebSocket接続を作成できるようにするオブジェクト。WebSocketを作成するときは、必要なすべての構成を含むオプションオブジェクトを渡す必要があります。その後、ソケットを介してメッセージを送受信できます。

メソッド

先頭に戻る

gRPC

gRCP APIは、DevWebスクリプトを再生するときにネイティブgRPC通信プロトコルのサポートを提供します。(gRPC-Webはサポートされていません。)

ヒント: <DevWebルートフォルダー>\examples\フォルダーには、gRPCの使用例スクリプトが含まれています。

GrpcClient

gRPCサーバーへのRPCを作成するために使用できる新しいクライアントを作成するオブジェクト。

例:

const client = new load.GrpcClient({
        host: "myHost",
        isInsecure: true,
    });

メソッド

GrpcUnaryRequest

単項RPC要求オブジェクトを作成します。

メソッド

GrpcClientStreamRequest

クライアントストリーミングRPC要求オブジェクトを作成します。

メソッド

GrpcServerStreamRequest

サーバーストリーミングRPC要求オブジェクトを作成します。

メソッド

GrpcBiDirectionalStreamRequest

双方向ストリーミングRPC要求オブジェクトを作成します。

方法

GrpcResponse

このオブジェクトは、GrpcRequestの結果として返されます。作成する必要はありません。

先頭に戻る

抽出オブジェクト

extractorsオプションパラメーターを提供することにより、特定のWebRequestの応答、特定のgRPC要求の応答、またはファイルreadメソッドから抽出される値を指定できます。

このパラメーターは、以下の抽出オブジェクトタイプで説明されているヘルパーコンストラクター関数を使用して作成される抽出オブジェクトまたは抽出オブジェクトの配列です。

抽出オブジェクトタイプ

抽出オブジェクトの結果

すべての抽出オブジェクトの結果は、結果オブジェクトのextractorsプロパティの下の単一のオブジェクトにマージされます。たとえば、WebRequestで抽出オブジェクトを使用すると、抽出された値は、その要求によって作成されたWebResponseオブジェクトのextractorsプロパティに格納されます。

抽出された値は、抽出オブジェクト名を使用してextractorsプロパティから取得できます。名前は、抽出オブジェクトコンストラクターの最初の引数として指定されます。

便宜上、抽出された各値は、スクリプト内のどこからでもアクセスできるload名前空間のextractorsプロパティにも格納されます。

注: 抽出オブジェクトのオブジェクトが別の抽出オブジェクトのオブジェクトと同じ名前の場合、最後の抽出オブジェクトの結果のみが保存され、警告がログに出力されます。

各抽出オブジェクトのオブジェクトは、異なる形式で結果を返します。特定の形式については、抽出オブジェクトタイプの特定の抽出オブジェクト定義を参照してください。

先頭に戻る

トランザクション

トランザクションは、スクリプトの特定の明確に定義された部分の実行にかかる時間を測定する手段を提供します。

プロパティ

メソッド

先頭に戻る

パラメーター

パラメーターは、ランタイムエンジンによってランタイム中に生成される値であり、load.params変数を介してスクリプトに公開されます。

パラメーター変数を使用するたびに、パラメーター定義ファイルの次の値選択戦略に基づいて、次の値が自動的にロードされます。

詳細については、値のパラメーター化を参照してください。

先頭に戻る

一般的なメソッド

先頭に戻る

Timer

指定された遅延後に起動するタイマーを作成できるようにするオブジェクト。タイマーは、停止するまで、1回、または指定された遅延が経過するたびに起動できます。

メソッド

先頭に戻る

ランデブー

ランデブー関数は、DevWebスクリプトにランデブーポイントを作成します。このステートメントが実行されると、仮想ユーザーは実行を停止し、許可が続行されるのを待ちます。

  • この関数は、アクションセクションでのみ使用でき、初期化セクションまたはファイナライズセクションでは使用できません。
  • ランデブー関数に提供される名前パラメーター (rendezvous_name) には、スペースを入れないでください。

注: この機能は、OpenText Performance Engineering for Developersを使用してローカルでスクリプトを実行する場合は使用できません。

例:

load.action("Action", async function () {
        load.rendezvous("rendezvous_name")
    });

先頭に戻る

グローバル

loadオブジェクトのプロパティを変更することは許可されていませんが、データを保存するためのグローバルオブジェクトが提供されています。このオブジェクトには、load.globalプロパティを使用してアクセスできます。

例:

load.global.myData = 1; 

// in another file ...

 load.log(`The value of myData is ${load.global.myData}`); 

先頭に戻る

Config

実行中の仮想ユーザーにさまざまな設定データを提供するために使用されるグローバル設定オブジェクト。

プロパティ

先頭に戻る

Utils

utilsオブジェクトには、一般的なスクリプトタスクに役立ついくつかの便利な関数があります。

メソッド

チェーン

このクラスは、他のutils関数またはシグネチャーの1つを持つカスタム関数への呼び出しをチェーンするメカニズムを提供します: func()func(value)func(value、options)

例:

const myChain = new load.utils.Chain("base64Encode",(value)=>{ return {encoded:value};}); 
const myValue = myChain.run("Hello"); //myValue = {"encoded":"SGVsbG8="}

先頭に戻る

ネット

net APIは、便利なネットワーク関連の機能を提供します。

先頭に戻る

Azure

Microsoft Azure Key Vaultは、シークレット (パスワード、証明書、暗号化キーなどの機密データ) を安全に保管してアクセスするために使用されるクラウドサービスです。Azure API関数は、Microsoft Azure Key Vaultへのアクセスをサポートしています。詳細については、Azure Key Vaultシークレットにアクセスするを参照してください。

先頭に戻る

Cookie

この機能グループを使用すると、Web要求で使用されるCookieを追加、削除、またはクリアできます。

Cookie

Cookieのすべてのフィールドをカプセル化するオブジェクト。

先頭に戻る

VTS

VTS統合APIを使用すると、VTSサーバーに接続して、列からの読み取りと書き込み、インデックスの管理など、さまざまな操作を実行できます。

VTSClient

VTSClientは、VTSサーバーにコマンドを発行する役割を果たします。これを使用して、VTSColumnVTSRowなど他のVTS関連のコンストラクトを取得します。

クライアントを使用すると、複数の列または行に影響を与える一般的な操作を実行できます。

メソッド

VTSColumn

これは、VTSサーバー上の列を指します。このオブジェクトを使用して、基になる列に対して操作を実行します。

プロパティ

メソッド

VTSRow

これは、VTSサーバー上の行を指します。このオブジェクトを使用して、基になる行に対して操作を実行します。

プロパティ

メソッド

先頭に戻る

File

特定のファイルに対するファイル操作を可能にするオブジェクト。

メソッド

先頭に戻る

SSE

サーバー送信イベント (SSE) はサーバープッシュテクノロジーであり、クライアントがHTTP接続を介してサーバーから自動更新を受信できるようにします。SSEオブジェクトにより、AUTへの接続が可能になり、サーバーから送信されたイベント通知を受信できるようになります。

SSEインスタンスを作成するときは、必要な設定をすべて含むoptionsオブジェクトを渡します。

メソッド

先頭に戻る

関連項目: