Element Text 検証は、指定した要素の存在を前提にする点で Element Visible 検証と似ていますが、Element Text 検証ではその要素に表示される「特定のテキスト値」も指定して検証します。複数のテキスト要素をまとめて検証することもできます。
検証対象のテキストは、固定文字列のほか、正規表現（Regex）、短い JS 式、パラメーターなどで表せます。詳細は Advanced text validation を参照してください。
Validate element text ステップの追加（Web）
Element Text 検証を追加するには:
- 検証を追加したい位置の >（矢印） にカーソルを合わせます。
アクションのオプションが表示されます。
- Toggle Breakpoint をクリックします。
- Play Scenario をクリックして、ブレークポイントまでテストを実行します。
- もう一度同じ位置にカーソルを合わせ、"M"（Testim の事前定義ステップ）をクリックします。
Predefined steps メニューが開きます。
- Validations をクリックします。
Validations セクションが展開されます。
- Validate element text を選択します。
- AUT ウィンドウで検証したい要素をクリックして選択します。
ステップが作成され、選択した要素のサムネイルがステップに表示されます。
- 検証ステップの後にある Toggle Breakpoint をクリックしてブレークポイントを解除します。
Validate element text ステップの追加（Mobile）
Element Text 検証を追加するには:
- 検証を追加したい位置の >（矢印） にカーソルを合わせ、Testim predefined steps ボタンをクリックします。
- Validations 内の Validate element text を選択します。
- AUT が開きます。検証したい画面上のテキスト要素を選択します。
- Text Validation ステップが作成され、選択要素のサムネイルがステップに表示されます。
Validate element text ステップの修正（Mobile & Web）
選択した要素やテキストを変更したい場合、ステップを削除して録り直す必要はありません。別の要素へ再割り当てするか、検証対象のテキストを編集できます。
選択要素の再割り当て
Validate element text ステップで選択要素を再割り当てするには:
- 再割り当てしたいステップの左側の位置にカーソルを合わせ、Toggle Breakpoint をクリックします。
- Play Scenario をクリックして、ブレークポイントまでテストを実行します。
- 対象ステップにカーソルを合わせ、Show Propertiesをクリックします。
右側に Properties パネルが表示されます。
- Target element のサムネイルにカーソルを合わせます。
Target element のオプションが表示されます。
- Reassign をクリックします。
- AUT 上で新しい要素を特定し、クリックして選択します。
選択した要素が Properties パネルの Target element に表示されます。 - 先ほどと同じステップ左の Toggle Breakpoint をクリックして、ブレークポイントを解除します。
検証テキストの編集
Validate element text ステップで検証するテキストを編集するには:
- 対象ステップにカーソルを合わせ、Show Propertiesをクリックします。
右側に Properties パネルが表示されます。
- Expected value フィールドに新しい検証テキストを入力します。
Advanced text validation
テキスト文字列全体を完全一致で指定するのが難しい場合があります。Expected Value フィールドでは、次の組み合わせでテキスト検証を作成できます：
- 正規表現（部分文字列）
- JavaScript 式
- パラメーター
正規表現（Regex）を使った検証
Testim は Expected Value 入力フィールドでの Regex をサポートしています。よく使われるケースを以下に示します：
前方一致（Starts with）
特定の単語で始まるテキストを検証します。残りのテキストが動的であっても検証をパスします：
/^My text/
後方一致（Ends with）
特定の単語で終わるテキストを検証します。残りのテキストが動的であっても検証をパスします：
/my text$/
部分一致（Contains）
特定の単語を含むテキストを検証します。残りのテキストが動的であっても検証をパスします：
/my text/
複数の選択肢（OR）とパラメーター
2 つの値のいずれかに一致するかを検証します。例えば param1 = "Hello"、param2 = "World" の場合、"Hello" または "World" でパスします：
式: new RegExp("^" + "(?:" + param1 + "" + "|" + param2 + ")" + "$")
不一致の検証（Not Equal Validation）
テキストが param1 と一致しないことを検証します。例えば param1 = "Example1" の場合、テキストが "Example1" であれば検証は失敗し、それ以外の値はパスします：
式: new RegExp("^" + "((?!" + param1 + ").)*$")
数値の検証（正の整数のみ）
テキストが正の整数（数字 0〜9）のみで構成されていることを検証します。例えば "12345" はパスしますが、"12a34" や "-123" は失敗します：
式: /^d+$/
数値の検証（正・負・小数）
正の数、負の数、小数のみで構成されていることを検証します。例えば "123"、"-123"、"3.14"、"-0.5" はパスしますが、"12a" や "." は失敗します：
式: /^-?d+(.d+)?$/
もちろん、必要に応じてその他の有効な Regex も使用できます。
JavaScript 式を使った検証
テキストが JavaScript 式の計算結果と等しいことを検証したい場合があります。例えば、テキストに現在の日付が表示されていることを確認するには、Expected Value に次の式を設定します：new Date().toDateString()。Testim はこの式の計算結果と要素のテキストを比較します。検証が失敗した場合の例を以下に示します：
パラメーターを使った検証
テストまたはスイートレベルで定義されたパラメーター、あるいは設定ファイルで定義されたパラメーターを使用してテキスト要素を検証できます。別のステップで作成したパラメーターを使用する場合は、テストレベルにエクスポートする必要があります（パラメーターのエクスポートの詳細）。
パラメーターのみ
パラメーターには 2 種類あります:
HTML: アプリ内の HTML 要素を参照できます。
JS（JavaScript）: 任意の JS 式を定義できます。Expected Value フィールドでパラメーターを使用するには:
- 以下のいずれかの方法でパラメーターを定義します。
-
カスタムステップにパラメーターを追加する（Web のみ） - カスタムステップを作成し、そのカスタムステップにパラメーターを追加できます。詳細な手順については、カスタム JavaScript ステップのパラメーターを参照してください。
-
テストデータにパラメーターを追加する - テストの最初のステップである Setup ステップにテストデータを追加してパラメーターを定義することもできます。詳細な手順については、Visual Editor からのデータ駆動テストの設定を参照してください。
-
設定ファイルにパラメーターを追加する（Web のみ） - 設定ファイルにパラメーターを追加できます。詳細な手順については、設定ファイルを使用したデータ駆動テストの設定を参照してください。
gif をクリックで拡大
</Image>
- パラメーターのスコープがステップレベルで定義されている場合は、Element Text 検証ステップまたはテストレベルにパラメーターをエクスポートする必要があります。詳細な手順については、パラメーターのエクスポートを参照してください。
例えば、username パラメーターに Hello, John という値をエクスポートするには、新しいカスタムアクションステップを追加し、エディターに以下を入力します：
exportsTest.usename = 'Hello, John';
gif をクリックで拡大
</Image>
- Element text validation ステップを作成し、Expected value にパラメーターを指定します。
gif をクリックで拡大
テスト実行後、Element text validation ステップが期待するパラメーター値と一致することを確認できます。
画像をクリックで拡大
パラメーターと固定文字列を + で結合することも可能です。例えば、username パラメーターの値を Hello, John ではなく John として定義し、Expected Value を 'Hello ' + userName と指定できます。
パラメーターと正規表現の組み合わせ
Expected value フィールドで正規表現を返す関数を定義することで、パラメーターと Regex を組み合わせられます。
例えば、パラメーターで始まる組み合わせは次のようになります：
new RegExp('^' + userName);パラメーターで終わる組み合わせは次のようになります：
new RegExp(userName + '$');