Apex リファレンスガイド
jAssert クラス
名前空間
Assert のメソッド
Assert のメソッドは次のとおりです。
areEqual(expected, actual, msg)
署名
public static void areEqual(Object expected, Object actual, String msg)
パラメーター
- expected
- 型: Object
- 予期される値。
- actual
- 型: Object
- 実際の値。
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
最初の 2 つの引数が同じでない場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String sub = 'abcde'.substring(2);
2Assert.areEqual('cde', sub, 'Expected characters after first two'); // SucceedsareEqual(expected, actual)
署名
public static void areEqual(Object expected, Object actual)
パラメーター
- expected
- 型: Object
- 予期される値。
- actual
- 型: Object
- 実際の値。
戻り値
型: void
使用方法
2 つの引数が同じでない場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String sub = 'abcde'.substring(2);
2Assert.areEqual('cde', sub); // SucceedsareNotEqual(notExpected, actual, msg)
署名
public static void areNotEqual(Object notExpected, Object actual, String msg)
パラメーター
- notExpected
- 型: Object
- 予期されない値。
- actual
- 型: Object
- 実際の値。
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
最初の 2 つの引数が同じである場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String sub = 'abcde'.substring(2);
2Assert.areNotEqual('xyz', sub, 'Characters not expected after first two'); // SucceedsareNotEqual(notExpected, actual)
署名
public static void areNotEqual(Object notExpected, Object actual)
パラメーター
- notExpected
- 型: Object
- 予期されない値。
- actual
- 型: Object
- 実際の値。
戻り値
型: void
使用方法
2 つの引数が同じである場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String sub = 'abcde'.substring(2);
2Assert.areNotEqual('xyz', sub); // Succeedsfail(msg)
署名
public static void fail(String msg)
パラメーター
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
一般に、例外の発生が予期される try/catch ブロックのテストケースで使用されます。ただし、アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックで捕捉することはできません。
例
1// test case where exception is expected
2try {
3 SomeClass.methodUnderTest();
4 Assert.fail('DmlException Expected');
5} catch (DmlException ex) {
6 // Add assertions here about the expected exception
7}fail()
署名
public static void fail()
戻り値
型: void
使用方法
一般に、例外の発生が予期される try/catch ブロックのテストケースで使用されます。ただし、アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックで捕捉することはできません。
例
1// test case where exception is expected
2try {
3 SomeClass.methodUnderTest();
4 Assert.fail();
5} catch (DmlException ex) {
6 // Add assertions here about the expected exception
7}isFalse(condition, msg)
署名
public static void isFalse(Boolean condition, String msg)
パラメーター
戻り値
型: void
使用方法
条件が true の場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Boolean containsCode = 'Salesforce'.contains('code');
2Assert.isFalse(containsCode, 'No code'); // Assertion succeedsisFalse(condition)
署名
public static void isFalse(Boolean condition)
パラメーター
- condition
- 型: Boolean
- false であるかどうかを検査して確認する条件。
戻り値
型: void
使用方法
条件が true の場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Boolean containsCode = 'Salesforce'.contains('code');
2Assert.isFalse(containsCode); // Assertion succeedsisInstanceOfType(instance, expectedType, msg)
署名
public static void isInstanceOfType(Object instance, System.Type expectedType, String msg)
パラメーター
- instance
- 型: Object
- 種別を検査するインスタンス。
- expectedType
- 型: System.Type
- 予期される種別。
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
インスタンスが指定の種別でない場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Account o = new Account();
2Assert.isInstanceOfType(o, Account.class); // SucceedsisInstanceOfType(instance, expectedType)
署名
public static void isInstanceOfType(Object instance, System.Type expectedType)
パラメーター
- instance
- 型: Object
- 種別を検査するインスタンス。
- expectedType
- 型: System.Type
- 予期される種別。
戻り値
型: void
使用方法
インスタンスが指定の種別でない場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Account o = new Account();
2Assert.isInstanceOfType(o, Account.class); // Succeeds1Account o = new Account();
2Assert.isInstanceOfType(o, Account.class, 'Expected type.'); // SucceedsisNotInstanceOfType(instance, notExpectedType, msg)
署名
public static void isNotInstanceOfType(Object instance, System.Type notExpectedType, String msg)
パラメーター
- instance
- 型: Object
- 種別を検査するインスタンス。
- notExpectedType
- 型: System.Type
- 予期されない種別。
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
インスタンスが指定の種別である場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Contact con = new Contact();
2Assert.isNotInstanceOfType(con, Account.class, 'Not expected type'); // SucceedsisNotInstanceOfType(instance, notExpectedType)
署名
public static void isNotInstanceOfType(Object instance, System.Type notExpectedType)
パラメーター
- instance
- 型: Object
- 種別を検査するインスタンス。
- notExpectedType
- 型: System.Type
- 予期されない種別。
戻り値
型: void
使用方法
インスタンスが指定の種別である場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Contact con = new Contact();
2Assert.isNotInstanceOfType(con, Account.class); // SucceedsisNotNull(value, msg)
署名
public static void isNotNull(Object value, String msg)
パラメーター
- value
- 型: Object
- null でないかどうかを検査して確認する値。
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
値が null の場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String myString = 'value';
2Assert.isNotNull(myString, 'myString should not be null'); // SucceedsisNotNull(value)
署名
public static void isNotNull(Object value)
パラメーター
- value
- 型: Object
- null でないかどうかを検査して確認する値。
戻り値
型: void
使用方法
値が null の場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String myString = 'value';
2Assert.isNotNull(myString); // SucceedsisNull(value, msg)
署名
public static void isNull(Object value, String msg)
パラメーター
- value
- 型: Object
- null であるかどうかを検査して確認する値。
- msg
- 型: String
- (省略可能) エラーメッセージの一部として返されるカスタムメッセージ。
戻り値
型: void
使用方法
値が null でない場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1String myString = null;
2Assert.isNull(myString, 'String should be null'); // SucceedsisTrue(condition, msg)
署名
public static void isTrue(Boolean condition, String msg)
パラメーター
戻り値
型: void
使用方法
指定された条件が false の場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Boolean containsForce = 'Salesforce'.contains('force');
2Assert.isTrue(containsForce, 'Contains force'); // Assertion succeedsisTrue(condition)
署名
public static void isTrue(Boolean condition)
パラメーター
- condition
- 型: Boolean
- true であるかどうかを検査して確認する条件。
戻り値
型: void
使用方法
指定された条件が false の場合、致命的なエラーが返され、コードの実行が停止します。
アサーションの失敗は、例外としてログに記録されていても、try/catch ブロックを使用して捕捉することはできません。
例
1Boolean containsForce = 'Salesforce'.contains('force');
2Assert.isTrue(containsForce); // Assertion succeeds