ステップを作成した後、そのステップのプロパティを編集できます。設定可能なプロパティオプションは、編集するステップのタイプによって異なります。ステップのプロパティを編集するには：
- 目的のステップの上にマウスを移動し、Show Properties アイコンをクリックします。
プロパティパネルが右側に開きます。
- 目的の変更を行います。
変更はテストに自動的に適用されます。
エディター画面を閉じる前に、ヘッダーバーの Save ボタンをクリックして、すべての変更を保存してください。
プロパティの設定
プロパティパネルに表示されるプロパティのリストは、選択されたステップのタイプによって異なります。ほとんどのタイプのステップに関連するプロパティがいくつかあり、特定の専門的なタイプのステップにのみ関連するプロパティもあります。 以下の表は、さまざまなプロパティの設定方法と、関連機能のより詳細なドキュメントへのリンクを示しています。
| プロパティ | 適用対象 | 説明 | 関連ドキュメント |
|---|---|---|---|
| 一般プロパティ | |||
| Description | すべて | これはステップの編集可能な名前です。テストをより理解しやすくするために、ステップに情報的な名前を付けるようにしてください。 | |
| Disable Auto-scroll | 記録されたステップと検証 | ターゲット要素を見つけるにはスクロールが必要な場合がありますが、テストが最初に記録されたときには必要ありませんでした。デフォルトでは、Testim はビューポート外の要素に自動的にスクロールします。このチェックボックスを選択すると、このステップのこの機能が無効になります。Testim はビューポート内のみを検索し、ビューポート外にはスクロールしません。 | 自動スクロール |
| Element must be visible | 記録されたステップと検証 | ターゲット要素がページ上に存在するが、ユーザーには表示されない場合があります。例えば、要素が現在ビューポートにない場合や、可視性が「display: none」に設定されている場合です。このボックスがチェックされている場合（デフォルト）、ターゲット要素が表示されている場合にのみステップが実行されます。 | 要素が表示されていない場合 |
| Error Suffix | すべて | ステップが失敗したときに表示されるエラーメッセージにサフィックスとしてカスタムメッセージを追加します。単純な文字列（例：'my custom error'）を入力するか、パラメーターを含む文字列（例：'my custom error' + `Param1`）を入力できます。 | エラーサフィックスのカスタマイズ |
| Override timeout | Sleep と Generate Date 以外のすべて | 「ステップタイムアウト」は、Testim がテストステップの失敗を登録する時間経過（ミリ秒）です。各ステップのデフォルトの時間経過は、最初に Setup ステップ構成で設定されます。このチェックボックスを選択すると、このステップのデフォルト設定を上書きし、異なる時間経過値（ミリ秒）を指定できます。注：ステップタイムアウトがステップの実行時間を超えることを確認してください。失敗したステップは、正常に実行するための時間が不足するまで再試行されます。 | |
| Target Element | 記録されたステップと検証 | これは、AUT（テスト対象アプリケーション）ブラウザで選択された要素（プロパティパネルの要素のサムネイル画像で表される）で、このテストステップの実行時にクリックされます。ターゲット要素は編集可能です。サムネイルの上にマウスを移動すると、Highlight、Reassign、Improve、View locators のオプションが表示されます。 | ターゲット要素のプロパティ編集 |
| When this step fails | すべて |
ステップが失敗した場合、デフォルトの動作は、ステップにエラーをマークしてテストを停止することです。このデフォルトの動作を上書きできます。このプロパティのオプションは次のとおりです：
|
テストが失敗した理由は？ |
| When to run step | すべて |
「when to run step」機能を使用すると、テストのステップをいつ実行するか、または実行しないかを制御できます。以下のオプションを適用できます：
Never (skip) - ステップは実行されません。 |
条件分岐 |
| 専門プロパティ | |||
| Add Prefix | Generate random value | 値にプレフィックス文字列を追加します。例えば、「User」を追加すると、すべての値が User で始まります：User47、User65、User32。 | ランダム値の生成ステップ |
| Add Suffix | Generate random value | 値にサフィックス文字列を追加します。 | ランダム値の生成ステップ |
| Allow API request retry | Add API action, Validate API | 失敗した場合に API リクエストを再試行します。 | API 検証 |
| Attribute name | Validate HTML attribute | これは、ステップが最初に作成されたときにユーザーが入力した属性名です。名前を変更するには、フィールド内をクリックして内容を編集します。 | HTML 属性の検証 |
| Cookie name | Get Cookie | Get Cookie ステップを使用すると、UI から直接テストのコンテキストで Cookie を取得できます。ステップを作成した後、ステップを編集して、取得したい Cookie の名前を指定する必要があります。名前を入力または変更するには、フィールド内をクリックして内容を編集します。 | Cookie（クッキー） |
| Date format | Generate date | Testim が Generate date ステップに使用するデフォルトの形式は「YYYY-MM-DD」です。この形式を変更するには、フィールド内をクリックして内容を編集します。形式は任意の JS 日付形式にできます。 | JS 日付フォーマット |
| Expected status | Validate checkbox, Validate radio button | このプロパティは、チェックボックスまたはラジオボタンのチェック済みまたは未チェック状態を検証する場合に適用されます。デフォルト設定は Checked です。設定を変更するには、Unchecked ラジオボタンをクリックします。注：チェックボックスとラジオボタンの検証は、ネイティブのチェックボックスまたはラジオ入力要素でのみ使用できます。基礎となる入力を使用しないカスタムチェックボックスの実装はサポートされていません。 | チェックボックス／ラジオボタン検証の追加方法 |
| Expected value | Validate element text, Validate CSS property, Validate HTML attribute, Wait for element text | これは、このステップの実行時に Testim が探している値です。この値は、ステップが作成されたときに最初に設定されました。値を変更するには、フィールド内をクリックして内容を編集します。注：Expected value フィールドでは、パラメーター、正規表現、JavaScript 式を使用できます。 | 高度なテキスト検証 |
| Extract Mode | Add extract value step | 抽出するデータタイプを指定します。デフォルトでは、モードは文字列全体を抽出することです。モードを変更して、数値、日付を抽出するか、正規表現を使用してテキストの一部のみを抽出できます。Number/Date/Regular Exp を抽出する場合でも、抽出された値は文字列になることに注意してください。 | 値の抽出 |
| Length | Generate random value | 生成される値の長さを指定します。 | ランダム値の生成ステップ |
| Native events | Click | Click ステップは（プロジェクトレベルで）ネイティブまたは非ネイティブイベントに変換するように構成されています。ネイティブイベントは通常、マウスボタンのクリックやタッチデバイスでのタップなど、ユーザーの操作によってトリガーされます。ネイティブクリックが発生すると、ブラウザは組み込みのイベント処理パイプラインに従って、イベントをネイティブに処理します。非ネイティブイベント（合成またはプログラマティッククリックとも呼ばれる）は、JavaScript またはその他のプログラマティック手段を使用して人工的に作成およびディスパッチされるクリックイベントです。非ネイティブクリックは通常、ユーザーの操作をシミュレートするためにスクリプトまたは自動化ツールによって生成されます。「click ステップ」が成功したにもかかわらず、クリックが実際には実行されなかったためにテストが失敗することがあります。考えられる解決策として、Native events チェックボックスを選択または選択解除してください。 | |
| Pre-step delay (ms) | Validate element not visible, Wait for element not visible | 要素が表示されていないことを確認する前に遅延時間を設定したい場合があります。例えば、要素がページに突然表示されないことを確認したい場合です。デフォルトでは、遅延は設定されていません。遅延を設定するには、Pre-step delay チェックボックスを選択し、遅延時間をミリ秒で設定します。 | 要素が不可視であることの検証 |
| Property name | Validate CSS property | これは、ステップが最初に作成されたときにユーザーが入力した CSS プロパティ名です。名前を変更するには、フィールド内をクリックして内容を編集します。 | |
| Replace with a clone | Add custom action, Add API action, Add custom validation, Validate API, Add network validation, Add custom wait for | 共有ステップを編集している場合、1 か所で変更すると、プロジェクトのすべてのインスタンスで変更されます。特定のテストのみのステップを変更するには、Replace with a clone をクリックします。 | グループの特定インスタンスのみを変更する方法 |
| See old revisions | Add custom action, Add API action, Add custom validation, Validate API, Add network validation, Add custom wait for | 共有ステップへの変更を含む変更を含むテストを保存するたびに、変更前のテストのバージョンが自動的に保存されます。これらのテストの各バージョンはリビジョンと呼ばれます。リビジョンリストには、変更メッセージ、変更を行ったユーザーの名前、変更が行われた日付が含まれます。リビジョンを使用すると、常に変更を振り返り、古いリビジョンに戻す力が得られます。See old revisions リンクをクリックして、リビジョンリストを表示します。 | リビジョン |
| Send via web page | Add API action, Validate API | このプロパティは、HTTP リクエストを送信する場合、または API 呼び出しから返される値を検証する場合に適用されます。API が Cookie などのブラウザ情報も送信する必要がある場合は、このオプションをチェックしたままにします（自動的に送信されます）。ブラウザのコンテキスト外で API 呼び出しを送信して、ブラウザの制限が適用されないようにする場合にのみ、このオプションをオフにします（例えば、API が CORS をサポートしていない場合）。 | API テスト |
| (Shared) step name | Add custom action, Add API action, Add custom validation, Validate API, Add network validation, Add custom wait for | これは、ステップが最初に作成されたときにユーザーが入力した名前です。名前を変更するには、フィールド内をクリックして内容を編集します（ステップが共有ステップの場合、プロパティは Shared step name というラベルが付けられます。ステップが共有ステップでない場合、プロパティは Step name というラベルが付けられます）。 | |
| Sleep duration | Sleep | このプロパティは、次のステップに進む前にテストが待機する時間を設定します。デフォルトは 1 秒（1,000 ms）です。この値を変更するには、フィールド内をクリックして、新しいスリープ値（ms）を編集します。 | 待機（Wait for） |
| String type | Generate random value | 生成される文字列のタイプ。文字のみ、数字のみ、またはその両方の混合が含まれます。 | ランダム値の生成ステップ |
| Time difference | Generate date | 生成された日付/時刻は、ブラウザ時刻または UTC（UTC が選択されている場合）の前または後に設定できます。 | 日付の生成 |
| URL to assign | Add navigation action | テスト中に別のページに移動するための URL を指定します。 | パラメーターの追加方法 |
| Use UTC | Generate date | ブラウザのタイムゾーンの代わりに UTC を使用する場合に選択します。 | 日付の生成 |
| Variable name | Add extract value step, Get cookie, Generate random value, Generate date | これは、これらの各ステップでデータを保持する変数に Testim が使用するデフォルト名です。名前を変更するには、フィールド内をクリックして内容を編集します。注：変数名は JavaScript の名前制限の対象となります。例えば、スペースや特殊文字は使用できません。 | JavaScript 変数 |
| Variable scope | Add extract value step, Get cookie, Generate random value, Generate date |
これらのタイプのステップで Testim が使用する変数のスコープを選択できます。デフォルトでは、変数スコープは Test に設定されています。変更したい場合は、Variable scope ドロップダウンをクリックして、次の 3 つのオプションのいずれかを選択します：
|
|
| PARAMS | Add custom action, Add API action, Add custom validation, Validate API, Add network validation, and Add custom wait for | パラメーターは、事前に情報がわからなくても、さまざまなシナリオをテストするためにステップで使用できます。PARAMS の横にある+をクリックすると、Testim でステップで使用する HTML パラメーターと JS パラメーターを定義できます。 | パラメーター |