Using Cookies

When a web service needs to store information for later use, it adds the Set-Cookie header to the response. The value of the header contains the name and value of a cookie.

Optionally, the Set-Cookie header may specify directives – additional parameters that control lifetime, visibility for server resources and so on. To learn more about possible directives, see the documentation on the MDN Web Docs website. For example, the following header specifies the cookie visible for the /store resource and its child resources:

Once a client receives this header in one of the responses, it should save the cookie. After this, the subsequent client requests to the same server will contain the Cookie header that specifies stored cookies. The client stores cookies until they expire or the HTTP session is closed. The sent cookies may look like this:

Store Received Cookies

By default, ReadyAPI does not store any cookies. To change this behavior, enable the Session test case option:

Click the image to enlarge it.

It forces ReadyAPI to store received cookies and include them to the subsequent requests to the server:

Click the image to enlarge it.

Add Cookies Manually

You can also, include the Cookie header manually:

Click the image to enlarge it.

The value of the header can contain more than one cookie. For this, separate them with a semicolon:

Cookie: name=value; foo=bar

When ReadyAPI runs load tests, it executes underlying test cases. If the Session test case option is enabled for them, ReadyAPI stores cookies received during the sessions. In this case, virtual users have separate HTTP sessions, so cookies received by one of them will not affect others.

Mock services simulate web services, so they can send cookies to clients. For this, use the Set-Cookie header with the name and value of the cookie:

Click the image to enlarge it.

You can specify as many Set-Cookie headers as you need.

Each cookie can contain directives that control a cookie’s lifetime, visibility for server resources, and so on. For example, the following header specifies a cookie that expires in 30 seconds:

To learn more about directives, see the documentation on the MDN Web Docs website.