Functions

Asserts whether the given values are equal. If it is not, an AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2@test:Config {}
3 function testAssertIntEquals() {
4     int answer = intAdd(5, 3);
5     test:assertEquals(answer, 8, msg = "IntAdd function failed");
6 }
7 function intAdd(int a, int b) returns (int) {
8     return (a + b);
9 }

Asserts whether the given values are exactly equal. If it is not, an AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2 class Person {
3     public string name = "";
4     public int age = 0;
5     public Person? parent = ();
6     private string email = "default@abc.com";
7     string address = "No 20, Palm grove";
8 }
9 @test:Config {}
10 function testAssertExactEqualsObject() {
11     Person p1 = new;
12     Person p2 = p1;
13     test:assertExactEquals(p1, p2, msg = "Objects are not exactly equal");
14 }

Assert failure is triggered based on your discretion. AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2 @test:Config {}
3 function foo() {
4     error? e = trap bar(); // Expecting `bar()` to panic
5     if (e is error) {
6         test:assertEquals(e.message().toString(), "Invalid Operation", msg = "Invalid error reason");
7     } else {
8         test:assertFail(msg = "Expected an error");
9     }
10 }
11 function bar() {
12     panic error("Invalid Operation");
13 }

Asserts whether the given condition is false. If it is not, a AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2 @test:Config {}
3 function testAssertFalse() {
4     boolean value = false;
5     test:assertFalse(value, msg = "AssertFalse failed");
6 }

Asserts whether the given values are not equal. If it is equal, an AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2 @test:Config {}
3 function testAssertIntEquals() {
4     int answer = intAdd(5, 3);
5     test:assertNotEquals(answer, 8, msg = "Matches");
6 }
7 function intAdd(int a, int b) returns (int) {
8     return (a + b);
9 }

Asserts whether the given values are not exactly equal. If it is equal, an AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2class Person {
3     public string name = "";
4     public int age = 0;
5     public Person? parent = ();
6     private string email = "default@abc.com";
7     string address = "No 20, Palm grove";
8 }
9 @test:Config {}
10 function testAssertNotExactEqualsObject() {
11     Person p1 = new;
12     Person p2 = new ();
13     test:assertNotExactEquals(p1, p2, msg = "Objects are exactly equal");
14 }

Asserts whether the given condition is true. If it is not, a AssertError is thrown with the given errorMessage.

Example

1import ballerina/test;
2 @test:Config {}
3 function testAssertTrue() {
4     boolean value = false;
5     test:assertTrue(value, msg = "AssertTrue failed");
6 }

Creates an AssertError with the custom message and category.

Creates a mock object of provided type description.

Prepares a provided default mock object for stubbing.

Objects and functions related to function mocking Allows a function to stub.