Selenium IDE イベント

Selenium IDE は、再生ステータスや記録ステータスをプラグインに通知するために、使用中にイベントを送信します。

イベントリクエストは、アクションリクエストと非常によく似ています。

イベントリクエスト

{
  action: "event",
  event: "recordingStarted",
  options: {
    event specific keys...
  }
}

action - event、実行されるアクションがイベントであることを示します。
event - そのイベントの一意の識別子。
options - そのイベントに関する情報を含む JavaScript オブジェクト。

イベントへの応答

一部のイベントは通知のみであり、Selenium IDE は計算のためにそれを停止する機会を与えません。一方、一部のイベントでは Selenium IDE は待機できます。参照については、イベントリストを参照してください。

イベントへの応答は、他のリクエストと同様に、リクエストの受信を参照してください。

イベントへの応答に関しては、注意すべきいくつかの落とし穴があります。詳細については、イベントに応答する際のエッジケースを参照してください。

イベントリスト

Selenium IDE によって出力されるイベントのリスト。

システムイベント

projectLoaded

ユーザーが新しいプロジェクトファイルをロードするたびにポップアップするイベント。

注: Selenium IDE はこのイベントで待機しません。

オプション

projectName - ロードされたプロジェクトの名前
projectId - ロードされたプロジェクトの ID

記録イベント

recordingStarted、recordingStopped

ユーザーがアクションの記録を開始または終了するたびにポップアップするイベント。

注: Selenium IDE はこのイベントで待機しません。

オプション

testName - コマンドが記録されるテスト。

commandRecorded

コマンドが記録されたときにポップアップするイベント。

注: Selenium IDE はこのイベントで待機します。

オプション

tabId - コマンドが記録されたタブのタブ ID。
command - 記録されたコマンド。
target - 記録されたターゲット。
targets - 記録されたすべてのターゲットとそれらの戦略のオプションのリスト。
value - 記録された値。

再生イベント

playbackStarted、playbackStopped

テストケースの実行が開始または終了したときにポップアップするイベント。

注: Selenium IDE はこれらのイベントで待機します。

オプション

runId - このテスト実行の一意の識別子。
testId - このテストケースの一意の識別子 (異なる実行間で保持されます)。
testName - 実行中のテストの名前。
suiteName - オプション。実行中のスイートの名前 (スイートの一部として実行された場合にのみ定義されます)。
projectName - 現在のプロジェクトの名前。

suitePlaybackStarted

テストスイートの実行が開始されるときにポップアップするイベント。

注: Selenium IDE はこのイベントで待機します。

suitePlaybackStopped

テストスイートの実行が終了したときに発生するイベント。

注: Selenium IDE はこのイベントで待機しません。

オプション

runId - このテスト実行の一意の識別子。
suiteName - 実行中のスイートの名前。
projectName - 現在のプロジェクトの名前。

Selenium IDEは（開始イベントとは異なり）停止イベントを待機しません。これは、IDEがフリーズしたようにユーザーが感じないようにするためです。後続のテスト実行では異なるrunIdを持つため、ティアダウンコードを実行できます。

注意: スイートイベントは、通常のテストケースイベントに加えて発生します。

イベントへの応答時のエッジケース

何もせずにイベントに応答する

プラグインがイベントに応答し、コードに no-op がある場合は、その場合に sendResponse(undefined) を実行してください。

非同期コードでイベントに応答する

プラグインがイベントに応答し、非同期コードを実行する場合は、非同期クロージャの外で return true を必ず実行してください。

詳細については、非同期リクエストを参照してください。