Cookies
Testfully desktop app offers an advanced feature for managing cookies with a dedicated UI, which improves your testing procedures.
In the Testfully desktop app, cookies can be automatically captured and stored for each user and attached to requests.
Availability
Please note that capturing and attaching cookies is a feature that is only available in the desktop app and not in the web app.
Features
Feature | Description | Status |
---|---|---|
Automatic Cookie Capture | Automatically saves cookies from API responses tailored for each user. | Available |
Manual Cookie Addition | Enables adding cookies manually for specific tests. | Available |
Cookie Editing | Allows editing of cookie properties like value and domain. | Available |
Cookie Deletion | Offers the option to remove unneeded cookies. | Available |
Activation/Deactivation | Controls in which cookies are active based on their domain, path, and expiration. | Available |
Cookies Tab for Requests | Provides a "Cookies" tab on each request to specify cookies for that request. | Available |
Variables for Cookies | Supports using variables as values for cookies. | Available |
Cookies in Headers | Allows for manual cookie inclusion in request headers. | Available |
Cookie Monitoring | Displays returned cookies in the response widget for monitoring. | Available |
Secure Cookie Storage | Captures and stores cookies securely for each user, without sharing between users. | Available |
Automatic Cookie Capture and Persistence
When API responses include cookies, the Cookie Management functionality automatically grabs and stores these cookies for each user. This mechanism ensures that subsequent requests may use these cookies, resulting in a realistic user session. This means you won't have to capture every cookie for each request you make manually. Captured cookies are saved even after you exit the program and can be reaccessed anytime.
Accessing Cookies via the Cookie Management section
The Cookie Management section in Testfully is your central hub for managing cookies. Here's what you can do:
- Add Cookies Manually: If you need to add a cookie that isn't automatically captured or if you want to create a new cookie, you can add cookies manually through the Cookie Management.
- Edit or Delete Existing Cookies: The Cookies UI allows you to manage your cookies completely. You can edit the properties of existing cookies or delete them if they are no longer needed.
- Manage Cookie States: Cookies in Testfully have an "Active" state. Only active cookies that match the domain and path and are not expired will be used in your requests. This functionality lets you control which cookies appear in your testing scenarios.
Cookie Utilization Criteria
To use a cookie in a request, the following requirements must be met:
- Domain and Path Match: The cookie will be used only if its domain and path match the request URL.
- Active Status: Only cookies marked as "Active" and have not expired will be considered for the request.
Example: Adding a Cookie Manually
- Open the "Cookie Management" on the sidebar. This will give a list of all cookies that have been captured.
- Click "New Cookie".
- Fill in the details: Name, Value, Domain, Path, etc.
- Set the cookie as "Active".
- Click "Save".
Example: Editing a Cookie
- Go to the Cookie Management interface on the sidebar, where your captured and manually added cookies are listed.
- Select the cookie you want to edit. This allows you to change any of the cookie's properties, such as its Name, Value, Domain, Active state, etc.
- After making the necessary changes, click "Save".
Setting Cookies for Individual Requests
In addition to managing cookies globally via the Cookie Management, Testfully allows you to configure cookies for individual requests.
- Cookies Tab: Each request in Testfully has its own "Cookies" tab. This tab allows you to specify which cookies should be sent with the current request. It is especially handy for testing scenarios that require specific cookie values.
- Using Variables as Cookie Values: To increase flexibility, you can use variables as cookie values in the Cookies tab. This feature allows you to dynamically load a cookie's value from a predefined variable, increasing the adaptability of your tests.
- Setting Cookies in Headers: If your testing scenario requires it, you can set cookies directly in the request headers by selecting the "Headers" tab. This approach gives you an alternate way to add cookies to your requests.
Monitoring Cookies
The "Response" widget in the Testfully Desktop App displays the cookies returned by API endpoints, allowing you to monitor cookie behaviour and values in real time. This feature is quite helpful in understanding how your requests affect cookie states.
Secure and Isolated Cookie Storage
The Cookie Manager in Testfully is designed to automatically capture and securely store cookies for each user. This approach ensures that cookies are not shared between users, maintaining the privacy and security of your testing environment.