Data Driven Tests

There a many times where you'll want to run the same steps with different input data. Gondola supports this using JSON or CSV formatted files. There are two ways in which Gondola works with data files.

1. The test case runs for each object (JSON) or row (CSV) in the data file.
2. Internal loop: a portion of the test case iterates through the data with a loop.

Data Files

Location

Data files should be stored under the data folder in the project root.

JSON format

[
    {
        "firstName": "john",
        "lastName": "doe",
        "password": "",
        "driverLicense": "CA123456",
        "passport": "830537258",
        "phoneNumber": "1-325-324-5553"
    },
    {
        "firstName": "david",
        "lastName": "baker",
        "password": "123456",
        "driverLicense": "CA654321",
        "passport": "942058316",
        "phoneNumber": "2-856-524-8636"
    }
]

CSV

firstName,lastName,password,driverLicense,passport,phoneNumber
john,doe,,CA123456,830537258,1-325-324-5553
david,baker,123456,CA654321,942058316,2-856-524-8636

Method 1 Looping the Entire Test Case

Add the data file location to the test case settings.

You can access the current object or row using the variable $current Using the JSON or CSV above:

• 1st Test Case Run:
  • $current.firstName = "john"
  • $current.password = ""
• 2nd Test Case Run:
  • $current.firstName = "david"
  • $current.password = "123456"

Add the data file before the function declaration like the following:

Data(importData("./data/users.json")).TestCase("Valid login (Access granted)", async (current: any) => 
{...});

You can access the current object or row using the variable $current Using the JSON or CSV above:

• 1st Test Case Run:
  • $current.firstName = "john"
  • $current.password = ""
• 2nd Test Case Run:
  • $current.firstName = "david"
  • $current.password = "123456"

Data(importData("./data/users.json")).TestCase("Valid login (Access granted)", async (current: any) => {
    await loginPage.login(current.firstName, current.password);
    await homePage.checkOpened();
});

Method 2: Internal Loop

The data is imported using native code. This must be done by adding the line below TypeScript Mode to the Test Case.

let users = importData("./data/users.json");

It's imported as an array. Using the JSON above:

• users[0].firstName= "john"
• users[1].firstName= "david"

After you've added it you can access the array in GTD:

The line below imports the data.

let users = importData("./data/users.json");

It's imported as an array. Using the JSON above:

• users[0].firstName= "john"
• users[1].firstName= "david"

TestCase("Valid login (Access granted)", async () => {
    let users = importData("./data/users.json");
    let index = 0;

    while (index < users.length) {
      await loginPage.login(users[index].firstName, users[index].password);
      await homePage.checkOpened();
      index = index + 1;
    }
});