Then Steps

Asserting for HTTP Status Codes
​
Then response status code should be {expected status code}
If we want to test if the response to the request that we did is having the expected status code. Let say we are expecting a successful request having a 200 status code.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response status code should be 200
Copied!
If the status code is not as expected this will generate a failed test.
​
Then response status code should not be {expected status code}
This is the same as above but a negative test instead.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response status code should not be 404
Copied!
​
Validating HTTP Headers
​
Then response header {expected HTTP Header} should exist
This will assert if the expected HTTP Header exist from the response.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response status code should not be 200
7
    Then response header "Server" should exist
Copied!
If the header does not exists then it will failed the test, and will have a message Expected header (Server) is missing.
​
Then response header {expected HTTP Header} should not exist
This is the negative test of the previous HTTP Header test. If the expected header exists then the test will failed.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response status code should not be 200
7
    Then response header "Server" should not exist
Copied!
​
Then response header {expected HTTP Header} should be {expected HTTP Header value}
If we want to test not just the existence of the header, we can also assert if the value of the response header is the same as what we are expecting.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response status code should not be 200
7
    Then response header "Server" should be "Autokin Server 2.1"
Copied!
​
Then response header {expected HTTP Header} should not be {expected HTTP Header value}'
This step is the reverse or negative test for the HTTP Header and value check.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response status code should not be 200
7
    Then response header "Server" should not be "Autokin Server"
Copied!
​
Verifying Response Body
​
Then response body should be valid json
This is a simple assert step to validate if the response body is in JSON format.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response body should be valid json
Copied!
​
Then response body should be json data of
If we want to assert the JSON body as a whole and compare to what we expect we can use this step.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response body should be json data of
7
    """
8
    `{
9
        "id": 3001,
10
        "name": "Juan Pedro",
11
        "country": "PH"
12
    }`
13
    """
Copied!
This step will compare each of the JSON property and value as well. If the structure or the value does not match to the response then it will fail the test.
​
Asserting for JSON Paths and Value
The following steps will be used to assert paths and values of the JSON body response.
For our examples, we will use this response body
1
`{
2
    "id": 3001,
3
    "name": "Juan Pedro",
4
    "country": "PH",
5
    "city": null,
6
    "tasks": [
7
        `{
8
            "tid": 1,
9
            "name": "Task 1"
10
        }`,
11
        `{
12
            "tid": 2,
13
            "name": "Task 2"
14
        }`
15
    ]
16
}`
Copied!
​
Then I expect that path {path} from body has value of {expected value}
Let us assert for a specific path with expected value, for example, in the above reponse we want to check for
path for id to have the value 3001
and the path for country to have the expected value of PH
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I expect that path "$.id" from body has value of 3001
7
    Then I expect that path "$.country" from body has value of "PH"
Copied!
​
Then I expect that path {path} from body has null value
Let us assert for a specific path with expected null value, for example, in the above reponse we want to check path for city which has a null value.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I expect that path "$.city" from body has null value
Copied!
​
Then response body should have path {expected JSON path}
This simple step is just to assert if the expected path exists.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then response body should have path "$.id"
7
    Then response body should have path "$.tasks[0].tid"
8
    Then response body should have path "$.tasks[1].name"
Copied!
​
Then I expect that from path of{JSON Path} contains {expected value}
Assert if one of the values that can be retrieve using the JSON path contains part of the expected value. If the path resolves to an object, it will be converted to string and will be use as part of the comparison.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I keep the value of header "Server" as "serverName"
7
    Then I expect that from path of "$.data..role" contains "Autokin Admin"
Copied!
Then I expect that from path of{JSON Path} not contains {expected value}
Assert if none of the values contains the expected value. This is the negative assertion of the previous Then.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I keep the value of header "Server" as "serverName"
7
    Then I expect that from path of "$.data..role" not contains "Autokin Admin"
Copied!
​
For more information, see https://goessner.net/articles/JsonPath/, and Autokin is using https://github.com/json-path/JsonPath for JSON Path processing.
​
Storing Response Values
To chain scenarios, we need to keep some of the value that was part of the repponse from previous scenarios, to do this we can use the following steps.
​
Then I keep the value of body path {JSON body path} as {store name}
Let us have an example to store a value form the response body using a specific JSON path.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then Then I keep the value of body path "$.id" as "userId"
Copied!
Now, we can use userId in some of the steps to pass as value of the header or parameters.
​
Then I keep the value of header {name} as {store name}
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I keep the value of header "Server" as "serverName"
Copied!
​
Then I expect that the stored value in {store name} is {expected value}
We can also assert if the value stored is the same as what we are expecting.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I keep the value of header "Server" as "serverName"
7
    Then I expect that the stored value in "serverName" is "Autokin Server"
Copied!
​
Then I save data from path{JSON Path} that contains {expected value} to file {file path}
Allow to capture filtered data and save into a local file.
1
Scenario: Getting user information 
2
    Given that a endpoint is up at mydomain.com
3
    Given I set Content-Type header to application/json
4
    Given I set DocId header to 3001
5
    When I GET /users/info
6
    Then I keep the value of header "Server" as "serverName"
7
    Then I expect that from path of "$.data..role" contains "Autokin Admin"
8
    Then I save data from path "$.data..role" that contains "Admin" to file "admin.json"
Copied!

Autokin REST - Previous

When Steps

Next - Autokin Web

Given Steps

Last modified 11mo ago

Copy link

Contents

Asserting for HTTP Status Codes

Validating HTTP Headers

Verifying Response Body

Asserting for JSON Paths and Value

Storing Response Values

Asserting for HTTP Status Codes

Then response status code should be `{expected status code}`

Then response status code should not be `{expected status code}`

Validating HTTP Headers

Then response header `{expected HTTP Header}` should exist

Then response header `{expected HTTP Header}` should not exist

Then response header `{expected HTTP Header}` should be `{expected HTTP Header value}`

Then response header `{expected HTTP Header}` should not be `{expected HTTP Header value}`'

Verifying Response Body

Then response body should be valid json

Then response body should be json data of

Asserting for JSON Paths and Value

Then I expect that path `{path}` from body has value of `{expected value}`

Then I expect that path `{path}` from body has null value

Then response body should have path `{expected JSON path}`

Then I expect that from path of`{JSON Path}` contains `{expected value}`

Then I expect that from path of`{JSON Path}` not contains `{expected value}`

Storing Response Values

Then I keep the value of body path `{JSON body path}` as `{store name}`

Then I keep the value of header `{name}` as `{store name}`

Then I expect that the stored value in `{store name}` is `{expected value}`

Then I save data from path`{JSON Path}` that contains `{expected value}` to file `{file path}`

Asserting for HTTP Status Codes

​

Then response status code should be {expected status code}

​

Then response status code should not be {expected status code}

​

Validating HTTP Headers

​

Then response header {expected HTTP Header} should exist

​

Then response header {expected HTTP Header} should not exist

​

Then response header {expected HTTP Header} should be {expected HTTP Header value}

​

Then response header {expected HTTP Header} should not be {expected HTTP Header value}'

​

Verifying Response Body

​

Then response body should be valid json

​

Then response body should be json data of

​

Asserting for JSON Paths and Value

​

Then I expect that path {path} from body has value of {expected value}

​

Then I expect that path {path} from body has null value

​

Then response body should have path {expected JSON path}

Then I expect that from path of{JSON Path} contains {expected value}

Then I expect that from path of{JSON Path} not contains {expected value}

​

Storing Response Values

​

Then I keep the value of body path {JSON body path} as {store name}

​

Then I keep the value of header {name} as {store name}

​

Then I expect that the stored value in {store name} is {expected value}

Then I save data from path{JSON Path} that contains {expected value} to file {file path}

Then response status code should be `{expected status code}`

Then response status code should not be `{expected status code}`

Then response header `{expected HTTP Header}` should exist

Then response header `{expected HTTP Header}` should not exist

Then response header `{expected HTTP Header}` should be `{expected HTTP Header value}`

Then response header `{expected HTTP Header}` should not be `{expected HTTP Header value}`'

Then I expect that path `{path}` from body has value of `{expected value}`

Then I expect that path `{path}` from body has null value

Then response body should have path `{expected JSON path}`

Then I expect that from path of`{JSON Path}` contains `{expected value}`

Then I expect that from path of`{JSON Path}` not contains `{expected value}`

Then I keep the value of body path `{JSON body path}` as `{store name}`

Then I keep the value of header `{name}` as `{store name}`

Then I expect that the stored value in `{store name}` is `{expected value}`

Then I save data from path`{JSON Path}` that contains `{expected value}` to file `{file path}`