- Tue Dec 03 2024
Cancel an in-progress request
Testfully
1.157.0
for Desktop and Web is now available, featuring an option to cancel an in-progress request. As soon as you click the Send button, the Cancel button will appear. Clicking it will cancel the request and prevent it from being sent. To cancel a request via the keyboard, use theCmd/Ctrl + Enter
shortcut, same as sending the request.Improvements and Bug Fixes
- Fixed an issue where the
$array
validator was not working as expected. - Extended the syntax for
path
variable of thestep()
function to support square brackets[]
for array access. Previously, only dot notation was supported.
- Fixed an issue where the
- Mon Dec 02 2024
Folder Runner
Testfully
1.156.0
for Desktop and Web is now available, featuring several highly requested updates and enhancements for the Folder Runner:-
Request Concurrency: Users can now define the number of requests to run concurrently in parallel mode. This level of control over simultaneous requests enables optimized test runs, whereas the default value of
5
was previously fixed and unchangeable. -
Delay: A new option in the Folder Runner settings lets you apply a delay between all requests in the folder, overriding individual request settings. Previously, delays could only be configured through Folder or Request settings.
-
Iterations: The Folder Runner now supports setting the number of iterations directly in its settings, eliminating the need to restart runs manually when executing the same folder multiple times.
-
Iteration Concurrency: For scenarios with multiple iterations, you can now specify how many iterations should run concurrently, providing better control and efficiency during execution.
-
CSV or JSON Data Files: The Folder Runner now supports CSV or JSON data files, enabling parameterization of requests in the same way it works in the Request Runner.
-
Select Requests to Run: You can choose specific requests to execute within the Folder Runner, allowing greater flexibility by avoiding the need to run all requests in the folder.
-
Sort Requests: Requests in the Folder Runner can now be sorted by name, method, or status, streamlining the process of locating and managing specific requests.
Bug Fixes
-
OAuth2 Authorization: Authorization requests now correctly capture cookies and store them in the cookie jar.
-
Keyboard Shortcuts: Resolved an issue preventing the use of
Shift + →
orShift + ←
to select text in input fields.
-
- Thu Nov 21 2024
Follow Redirects
Testfully
1.155.0
for Web & Desktop comes with the Follow Redirects feature. This feature allows you to follow redirects when sending requests in Testfully.How to enable Follow Redirects
To enable Follow Redirects for a request, open the request and click on the Settings tab in the request editor. Select “Yes” from the Follow Redirects dropdown to enable this feature. To disable it, select “No”. If you need to set a maximum number of redirects to follow, you can do so by entering a number in the Max Redirects field.
The Follow Redirects feature can be enabled for folders and environments as well. When enabled at the folder level, all requests within that folder will follow redirects. Similarly, when enabled at the environment level, all requests sent against that environment will follow redirects.
Working with Cookies in Javascript
You can now work with cookies in Javascript using the
pm.cookies.jar()
method. This method allows you to interact with cookies in the same way you would in a browser environment. You can use this method to get, set, and remove cookies in your scripts.Bug Fixes
- Fixed an issue where curl commands with content-type headers were not processed correctly.
- Fri Nov 08 2024
Testfully Command Center
Testfully
1.154.0
for Web & Desktop marks the first release of Testfully Command Center, a new feature that allows you to search and manage your requests, folders, environments and more using a command pallete. The first iteration of Command Center offers the following features:Activating Command Center
To activate the Command Center, press
Cmd/Ctrl + K
or click on the search icon in the top right corner of the app. This will open the Command Center, where you can start typing your query.Searching for Requests, Folders, Environments and More
Once the Command Center is open, you can start typing your query. The search results are displayed instantly and you can navigate through them using the arrow keys. To open a result, press
Enter
.Searching for a command
To search for a command, type
/
followed by the command name. For example, typing/import
will display the import option. Press Enter to select it, and the Command Center will guide you through the process.Available features in Command Center
-
Search: Quickly search for requests, folders, environments and more by pressing
Cmd/Ctrl + K
and typing your query. The search results are displayed instantly and you can navigate through them using the arrow keys. To open a result, pressEnter
. -
Select an environment: Easily switch between environments with the Command Center! Activate it and type / followed by the environment name. For example, typing /production will display the production environment. Press Enter to select it, and the Command Center will switch and close automatically.
-
Workspace Switch: Effortlessly switch between workspaces with the Command Center! Just activate it and type / followed by your workspace name. For instance, typing /myworkspace will display the myworkspace option. Hit Enter to select it, and the Command Center will switch and close automatically.
-
Import & Export: Import and export your requests, folders, and environments using the Command Center. Activate it and type / followed by the action you want to perform. For example, typing /import will display the import option. Press Enter to select it, and the Command Center will guide you through the process.
What’s Next?
We’re excited to make Command Center even more powerful in the upcoming releases by adding more commands. To give you a sneak peek, we’re planning to add commands for copying requests as cURL, duplicating requests, and more. Stay tuned for more updates and let us know what you think about Command Center!
-
- Fri Nov 01 2024
We’ve released a new version of Testfully Desktop & Web
1.153.0
with two new features and a few bug fixes. Here’s what’s new:Binary Request Body
You can now send binary request bodies with Testfully. Select the Binary option in the request body tab and upload your file using the file picker. Testfully will automatically set the correct content type for the file you’ve uploaded and send it as the request body. With the introduction of binary request bodies, we have also updated a few other features to support binary request bodies:
- Copy as cURL command now supports binary request bodies.
- Import cURL command now supports binary request bodies.
- Exporting a folder now includes binary request bodies.
- Importing a folder now supports binary request bodies.
Send & Download Response as File
Testfully 1.152.0 introduced a way to download the response body as a file. With the new version, you can now send a request and download the response as a file with a single click. To Send & Download a request, simply click on the Chevron icon next to the Send button and select the Send & Download option. To make it easier to send and download responses as files, we have also added a keyboard shortcut
Cmd/Ctrl + Option/Alt + Enter
to send and download responses as files.Improvements & Bug Fixes
- Fixed an issue where Testfully’s Proxy server would not send files as part of the multipart form request. This issue is related to web app only.
- The Environment dropdown in the request editor now offers a better user experience by showing scrollbars when there are a lot of environments and not enough space to display them all. Also, we have fixed an issue where the dorpdown would break environment names into multiple lines.
- Fixed an issue where the Switch To Workspace menu would not show all of the workspaces due to lack of space. Now, the menu will show a scrollbar when there are more workspaces than can be displayed.
- Tue Oct 29 2024
We’ve released a new version of Testfully Desktop & Web
1.152.0
with a lot of new features and improvements, so let’s dive into the details.Root Certificates & mTLS Authentication (Beta)
You will now be able to use mTLS authentication with Testfully Desktop & Web. This will allow you to securely connect to your services using client certificates. We’ve also added the ability to import root certificates to the application, so you can trust your self-signed certificates. This feature is currently in beta, so please let us know if you encounter any issues. Also, please be aware of the following limitations:
- Testfully’s Proxy Server (only available in the browser app) does not support root certificates that are using legacy CN fields. Please use the SAN field instead. This is a known limitation and we are working on a fix.
- Testfully’s Mac app does not support root certificates at the moment, but mTLS authentication is supported. If you’re getting an error related to root certificates, please disable the root certificate verification in the app settings. We are working on a fix for this issue.
- We do not support importing
pfx
files at the moment, something we are working on for the next release.
Both root and client certificates are currently scoped to the current user and are not shared between different users on the same machine. You can switch between multiple workspaces and the certificates will be available in all of them.
Download Response or Copy to Clipboard
The response panel now has a new option to download the response as a file. You can also copy the response to the clipboard with a single click.
Comments in JSON Editor
You can now add comments to your JSON requests in the JSON editor. This will help you to better document your requests and responses. Before sending the request, the comments will be removed automatically.
Bug Fixes
- Fixed an issue where you couldn’t utilize Testfully Proxy server due to invalid TLS Ceritifcate verification settings.
- Fixed an issue where the last route param before the query string was not being replaced correctly.
- Fixed an issue where Testfully would not produce a valid cURL command for a multipart form request with a file.
- Fixed an issue where Testfully would not correctly import a cURL command with a multipart form request with a file.
- Fixed an issue where you couldn’t duplicate an environment due to short environment names.
- Fixed an issue where you couldn’t import OpenAPI Spec files with a long endpoint path.
- Fixed an issue where Testfully would not correctly parse route parameters with a query string.
- Thu Oct 10 2024
We’ve released a new version of Testfully Desktop & Web
1.151.0
. This release fixes an issue where users were unable to send POST or PUT requests with an empty body. If you were experiencing this issue, please update to the latest version of Testfully Desktop & Web. - Sat Oct 05 2024
Include & Exclude Request Headers in Testfully
We finally pulled the trigger on a feature that many of you have been asking for. You can now include or exclude specific request headers for a request in Testfully. This feature is especially useful when you want to test how your API behaves when certain headers are included or excluded from the request. You can access this feature from the request editor’s Headers tab. This feature is available in Testfully Desktop & Web
1.150.0
and Testfully CLI1.14.0
.How to include or exclude headers in Testfully
- Open the request editor for a request.
- Go to the Headers tab.
- Hover over a header and click on the eye icon to include or exclude the header.
Other Improvements
We’ve also updated a few other features to benefits from this new feature, including:
-
Importing from Postman: When importing your Postman collections to Testfully, we now include the state of the headers (included or excluded) for each request. Previously, all headers were included.
-
Exporting requests: When exporting your requests from Testfully, we now include the state of the headers (included or excluded) for each request. Previously, all headers were included.
-
Copy as cURL: When copying a request as cURL from Testfully, we now include the state of the headers (included or excluded) for each request. Previously, all headers were included.
Last but not least, we also introduced a few bug fixes and improvements in this release, including:
- Fixed an issue where an excluded header, parameter or variable was still editable in the request editor.
- Testfully Desktop & Web now correctly sets the
Content-Length: 0
header when sending a request with an empty body. Please note that this behavior is not applicable toGET
,HEAD
,OPTIONS
requests.
- Thu Oct 03 2024
Improved Importing Experience in Testfully Cloud and Testfully Offline
Today, we released Testfully Desktop and Web v1.149.0 with an improved importing experience. Let’s see what’s new:
-
Real-time Import: Testfully Cloud users no longer need to refresh the app to see the imported data. The app now updates the data in real-time, making the importing experience more seamless. This improves makes the import experience for Testfully Cloud users as smooth as the one for Testfully Offline users.
-
Open API & Swagger Spec files in YAML: Previously, Testfully only supported JSON files for importing API and Swagger Spec files. Now, you can import YAML files as well. Since YAML is a more human-readable format, and many developers prefer it over JSON, this change makes the importing experience more flexible and user-friendly.
-
Import Postman Global Files: Postman Global files are noww supported in Testfully Cloud and Testfully Offline. This allows you to import Postman Global files and use them in your Testfully projects.
-
Upload a Zip file: You can now upload a zip file containing multiple files for importing. The good news is that you can upload a zip file containing any of the supported file types and Testfully will automatically extract and import them. This feature is available in Testfully Cloud and Testfully Offline.
-
Postman Data in .zip format: If you have a Postman Export file in .zip format, you can now import it into Testfully Cloud and Testfully Offline. This makes it easier to import Postman data into Testfully.
-
Folders for Open API and Swagger Spec files: Testfully now creates folders for Open API and Swagger Spec files using the endpoint names. This makes it easier to organize your files and find the endpoints you need.
-
- Sun Sep 29 2024
Testfully supports Route Params
Route Params make API endpoints more dynamic and flexible. You can add a route parameter to a request endpoint by adding a colon
:
before the parameter name. For example,GET /users/:id
whereid
is the route parameter. Starting from this release, you can add route parameters to your requests in Testfully and set a value for them in the request editor’s Params tab. We’ve updated Testfully Desktop & Web to1.148.0
and Testfully CLI to1.13.0
to support Route Parameters. - Fri Sep 27 2024
Quality of Life Improvements
We’ve updated Testfully Desktop & Web to
1.147.0
with a few quality of life improvements and bug fixes to make it more pleasant to use Testfully.The “Untitled Request” items in the sidebar are gone
You used to see
Untitled Request
item(s) in the sidebar. Those were created when you clicked on the+
button in the sidebar. We’ve removed them to make the sidebar cleaner. Once you save a request, it will be added to the sidebar with the name you’ve given.Creating a new request is now easier
We’ve made it easier to create a new request by adding a
+
button to the tab bar and offering a new shortcutCmd/Ctrl + N
to create a new request. This way, you can create a new request without moving your mouse to the sidebar.Paste cUrl command in the URL bar to import a request
You can now paste a cUrl command in the URL bar to import a request. Testfully will parse the cUrl command and create a new request with the details in the cUrl command. Combine this with the new
Cmd/Ctrl + N
shortcut to quickly import a request.The “https:// is not a valid endpoint” error is fixed
We’ve fixed an issue where Testfully was showing an error message saying
https:// is not a valid endpoint
when you tried to send a request to an endpoint that had a value.Request changes are now reflected immediately
Previously, when you made changes to a request field, you had to click outside the field to save the changes. Now, the changes are saved immediately, no matter where you click.
cUrl import & export of XML, YAML and other formats
Previously, you could only import and export cUrl commands in JSON format. Now, you can import and export cUrl commands in XML, YAML, and other formats.
Adding a new Environment is now easier
The + button to add a new environment is now always visible in the environment pane, making it easier to add a new environment.
API Monitoring supports query parameters
You can now add query parameters to the API Monitoring URL. This way, you can monitor an API endpoint with different query parameters.
Bug fixes
- Fixed a bug in switching between multiple tabs.
- Fri Sep 20 2024
We’ve updated Testfully Desktop & Web to
1.144.0
and Testfully CLI to1.12.1
. This release includes the following bug fix:The
test()
functionA bug was fixed in the
test()
function implementation that was causing some of the Testfully Script functions to not work as expected. This has been fixed and all functions should now work as expected. - Tue Sep 17 2024
We’ve updated Testfully Desktop & Web to
1.143.0
with the following changes:Preview Images in Response Body
You can now preview images in the response body of a request. Testfully will display the image in the response tab if the response body is an image. This feature is available for both browser-based and desktop Testfully users. To leverage this feature, please make sure your API returns correct image content type in the response header.
- Sat Aug 31 2024
We’ve updated Testfully Desktop & Web to
1.142.0
with the following changes:Microsoft Azure SSO Integration improvements
We have switched to a new Microsoft Azure SSO integration that completes the login process in end-user’s default browser. This change will provide a more seamless login experience for users who authenticate with Microsoft Azure SSO. Previously, the login process was completed in an embedded browser window within Testfully. This change will be relevant for users who authenticate with Microsoft Azure SSO via Testfully Desktop.
Bug Fixes
-
For requests without a response body, Testfully will now correctly display No Content message in the response tab instead of an empty array.
-
Fixed an issue where you could not leverage No Code API Testing feature to test response body of a request that returns a status code other than 200 family status codes. This bug was impacting browser-based Testfully users only.
-
Fixed an issue where query parameters were not being included in the request. This bug was impacting browser-based Testfully users only.
-
- Mon Aug 12 2024
We’ve updated Testfully Desktop & Web to
1.140.0
with the following changes:cURL Code Generation Improvements
This release includes two improvements to the cURL code generation feature:
- When importing a cURL command, Testfully will now automatically detect any encoded characters in the URL and decode them. This will make the generated code more readable and easier to understand.
- When importing a cURL command, Testfully will now automatically detect any query parameters in the URL and add them as query parameters for the imported request. This way the query parameters will be included in the Params tab for the imported request, making it easier to modify them if needed. Previously, the query parameters were added to the URL as part of the path, which made them harder to modify.
- Fri Aug 02 2024
We’ve updated Testfully Desktop & Web to
1.139.0
with the following changes:Domain Capture
Enterprise customers can now leverage domain capture to automatically capture ownership of all users and workspaces within a specific domain, ensuring that all users and workspaces are billed under the same subscription, leverage the same security policies, and more. If you’re an enterprise customer and would like to enable domain capture, please reach out to our support team.
Consolidated Billing for Enterprise Customers
We’ve introduced consolidated billing for enterprise customers. This feature allows you to subscribe once and use the same subscription across multiple teams and workspaces within your organization.
- Once consolidated billing is enabled, all new teams and workspaces created within your organization will automatically be billed under the same subscription.
- For workspaces with consolidated billing enabled, the billing section will be hidden, and the subscription plan will be inherited from the organization.
We’re in the process of rolling out this feature to all other customers, so stay tuned!
Bug Fixes
- Fixed an issue where you could not upgrade your subscription during your trial period.
- Fixed an issue where you could not switch from a monthly to an annual subscription plan.
- Enterprise customers can now see the “Enterprise” badge for their subscription plan instead of “Premium”.
- Tue Jul 30 2024
We’ve updated Testfully Desktop & Web to
1.138.0
with the following changes:Dependency Updates
- We have updated a few dependencies to their latest versions to ensure that Testfully Desktop & Web are secure and up-to-date.
- Thu Jul 18 2024
We’ve updated Testfully Desktop & Web to
1.137.0
with the following changes:Bug Fixes
- Fixed an issue related to getting OAuth2 access tokens from servers that do not provide a
state
parameter in the redirect URL.
- Fixed an issue related to getting OAuth2 access tokens from servers that do not provide a
- Fri Jul 12 2024
We’ve updated Testfully Desktop & Web to
1.136.0
with the following changes:Bug Fixes
- Fixed an issue where JSON responses with root-level arrays were not being displayed correctly in the API response viewer.
- Thu Jul 04 2024
We’ve updated Testfully Desktop & Web to
1.135.0
with the following changes:PDF Responses
Testfully now supports displaying PDF responses in the response viewer. This is useful for APIs that return PDFs, such as invoices, reports, etc.
Bug Fixes
- Fixed an issue where no-code validations were not correctly executed for APIs with JSON response bodies that did not have the correct
Content-Type
header.
- Fixed an issue where no-code validations were not correctly executed for APIs with JSON response bodies that did not have the correct
- Tue May 21 2024
We’ve updated Testfully CLI to version
1.11.0
and Testfully Desktop to1.133.0
with the following changes:Keyboard Shortcuts
Keyboard shortcuts are FINALLY here! You can now use the following keyboard shortcuts to navigate through the Testfully Desktop app:
Shortcut Description Ctrl + T
Create a new request Ctrl + Enter
Send a request Ctrl + S
Save a request, folder, environment or global Ctrl + Tab
Navigate to the next tab Ctrl + Shift + Tab
Navigate to the previous tab Ctrl + W
Close the current tab Ctrl + \
Toggle the sidebar Ctrl + Alt + V
Dock the response panel to the right or bottom To learn more about keyboard shortcuts, check out the Keyboard Shortcuts documentation.
Dock Response Panel to Right or Bottom
You can now dock the response panel to the right or bottom of the Testfully Desktop app using the
Ctrl + Alt + V
keyboard shortcut or by clicking theDock to Right
orDock to Bottom
buttons in the response panel.The
$.uuid()
FunctionWe’ve added a new function called
$.uuid()
that generates a random UUID (Universally Unique Identifier) value. You can use this function in your pre-request scripts to generate a unique value for your requests.Crypto API
We’ve added a new
crypto
API that allows you to generate random values using thecrypto
object. You can use this API to generate random values for your requests. Furthermore, you can now use any npm package that depends on thecrypto
module in your before-request or after-response scripts.Fixed
- Fixed an issue with the
$missing
operator against a field within an array item when the parent array is empty. The expected behaviour was to receive a failure, but we would pass. - Fixed an issue where Testfully would not use updated folder or collection variables when a variable gets updated as part of the pre-request script.
- Fixed an issue where Testfully would pick the wrong variable value when there were two or more variables. Rather than picking up the first one, we pick the last provided variable value.
- Fixed an issue with the
- Thu May 16 2024
We’ve updated Testfully CLI to version
1.10.0
and Testfully Desktop to1.132.0
with the following changes:New Features
- You can now use the
setTimeout
,setInterval
,clearTimeout
andclearInterval
functions in your scripts to delay or repeat the execution of your scripts. - To simplify the process of creating delays in your scripts, we have added a
$.sleep()
function that you can use to pause the execution of your scripts for a specified amount of time without using the traditionalsetTimeout
function. - You can now validate the response status code in the response script using the
$.response.to.have.status()
API. This API is also available via thepm.response.to.have.status()
API. - You can now validate the status of the response using
$.response.to.be.accepted
,$.response.to.be.badRequest
,$.response.to.be.forbidden
,$.response.to.be.notFound
,$.response.to.be.ok
,$.response.to.be.rateLimited
,$.response.to.be.unauthorized
,$.response.to.be.clientError
,$.response.to.be.info
,$.response.to.be.redirection
,response.to.be.serverError
,$.response.to.be.error
and$.response.to.be.success
APIs. These APIs are available via thepm.response.to.be
API. - You can now validate a response header in the response script using the
$.response.to.have.header()
API. This API is also available via thepm.response.to.have.header()
API. - You can now validate a response body in the response script using the
$.response.to.have.body()
API. This API is also available via thepm.response.to.have.body()
API. - You can now validate a JSON response body in the response script using the
$.response.to.have.json()
API. This API is also available via thepm.response.to.have.json()
API. - You can now validate the schema of a JSON response body in the response script using the
$.response.to.have.jsonSchema()
API. This API is also available via thepm.response.to.have.jsonSchema()
API.
Fixed
- Fixed an issue where some users would see a warning about memory leaks when running a before-request or after-response script.
- Fixed an issue where global or environment variables that were set in a before-request script were not used in the request correctly.
- You can now use the
- Sat May 04 2024
We’ve updated Testfully CLI to version
1.9.1
. This release includes the following bug fixes.Fixed
- Fixed an issue where the logs were not being displayed correctly in the CLI output when running tests with the
--logs
flag. - Fixed an issue where the CLI would not be able to load
npm
modules and dependencies.
- Fixed an issue where the logs were not being displayed correctly in the CLI output when running tests with the
- Tue Apr 30 2024
We’ve updated Testfully Web and Desktop apps to version
1.130.0
. This release includes the following changes:Improvements
- Proxy settings for a folder are now used when acquiring OAuth2 tokens for your requests.
- When OAuth2 authorization fails, you will now see a more detailed error message to help you troubleshoot the issue.
- You can use variables for proxy settings.
- When a before or after script fails, you will still have access to the full request and response data in the logs.
- When an error is thrown in a script, an assertion fails or you use
console.error
, a little badge will appear in the Logs tab to indicate that there was an error. - Workspace names are now sorted alphabetically in the workspace switcher.
Fixed
- Fixed an issue where global status code assertions were not working correctly when the validation was executed against an environment with a set of validations.
- Thu Apr 18 2024
We’ve updated Testfully CLI to version
1.9.0
. This release includes the following changes:Support for
$.request.skip()
and$.setNextRequest()
APIsLast week we introduced two new APIs to the JavaScript API that you can use in your scripts:
$.request.skip()
and$.setNextRequest()
. These APIs are now supported in Testfully CLI. You can use these APIs in your scripts to skip a request or set the next request to be executed in a folder run. For any skipped requests, Testfully CLI now includes an entry in the JUnit reporter and displays the skipped request in the logs.High-Performance Verbose Mode in Testfully CLI
We’ve re-engineered the verbose mode in Testfully CLI to perform better under heavy load and to display detailed logs for each request in a more readable format.
Order of Execution in Testfully CLI
We’ve improved the order of execution in Testfully CLI to ensure that requests are executed in the correct order. This is useful when you have dependencies between requests and you want to ensure that requests are executed in the correct order. Also, the JUnit reporter now includes requests based on the order of execution.
- Tue Apr 16 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.129.0
. This release includes the following changes:Copy as cURL
You can now copy a request as a cURL command. This is useful when you want to share a request with someone else or when you want to run the request from the command line. To copy a request as a cURL command, hover over the request in the sidebar and click the ”..” button, then click “Copy as cURL”. The “Copy as cURL” option offers the following features:
- Variables (global, environment or folder) are replaced with their values so that the cURL command is ready to run.
- The cURL command includes the request method, URL, headers, cookies, params and body. To generate a cURL command for a single request, you only need a valid URL. Other request details are optional.
- Authorization settings are included in the cURL command, so you don’t need to worry about authentication. This feature is available for all types of authentication supported by Testfully.
- Shared headers and params (via the parent folder) are included in the cURL command.
- If you work with multi-step requests, each step is included in the cURL command.
Terminate a Folder Run in Progress
Sometimes we need to stop a folder run in progress. For example, if a folder run is taking too long or if we realize that we made a mistake in the folder run configuration. Now you can terminate a folder run in progress by clicking the “Cancel” button in the folder run progress bar. When you terminate a folder run, the folder run stops immediately and the results are saved up to that point.
$.request.skip()
and$.setNextRequest()
APIsWe’ve added two new APIs to the JavaScript API that you can use in your scripts:
-
$.request.skip()
: This API allows you to skip the current request, it works when you send a single request via the “Send” button or when a request is executed as part of running a folder. This is useful when you want to skip a request based on a condition. If you’re coming from Postman, you will be pleased to know thatpm.execution.skipRequest()
is also supported. The$.request.skip()
API is available in the before-request phase and won’t have any effect in the after-request phase. -
$.setNextRequest(requestName)
: This API allows you to set the next request to be executed in a folder run. This is useful when you want to dynamically change the order of requests in a folder run based on the results of the current request. The$.setNextRequest()
API is available in both the before-script and after-request phases of a request. To terminate a folder run, you can use$.setNextRequest(null)
. If you’re coming from Postman, you will be pleased to know thatpostman.setNextRequest(requestName)
is also supported with the same behavior.
Inspect skipped requests
When a request is skipped, you can now inspect the request details and any available logs. This is useful when you want to understand why a request was skipped or when you want to debug your scripts.
Improved Basic, Bearer and API Key Authentication
We’ve improved the way Basic, Bearer and API Key authentication is handled in Testfully. Now, when you set up Basic, Bearer or API Key authentication, there will be a default value for header names, which you can change if needed. This makes it easier to set up authentication for your requests.
Bug Fixes
- Fixed an issue where some of the requests that were created in earlier versions of Testfully could not be duplicated.
- Fixed an issue where an invalid AWS Signature V4 token was generated when the request had one or more query parameters.
- Mon Apr 08 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.128.0
and Testfully CLI to1.8.0
. This release includes the following changes:Disable SSL Certificate Validation in Testfully CLI
Testfully CLI now supports disabling SSL certificate validation for requests and folders, so if you have a self-signed certificate, you can now use Testfully CLI without any issues.
Improvements
- The default mode for running tests in Testfully Web and Testfully Desktop is now
Serial
instead ofParallel
. If you want to run tests in parallel, you can change the mode in the settings.
Bug Fixes
- Fixed an issue where the Testfully Desktop would timeout after 30 seconds when trying to connect to an API that was taking longer to respond, even though the timeout was set to a higher value. You can now set the timeout value to any value you want, and Testfully Desktop will wait for the response.
- Fixed an issue where Testfully Offline (Windows) would not be able to import large collections of requests.
- Testfully Offline now correctly imports requests without a parent folder. Previously, requests without a folder would be imported into the root folder, but now they are imported under the correct parent folder.
- The default mode for running tests in Testfully Web and Testfully Desktop is now
- Tue Apr 02 2024
We’ve updated Testfully CLI to
1.7.0
. This release includes the following changes:Test Reports
Testfully CLI can now generate test reports in JUnit format. You can generate test reports by using the
--reporters
option with therun
command. For example, you can generate test reports using thetestfully run rick-and-morty.json --reporters junit
command. If you want to specify the directory/file path to export the JUnit report, you can use the--reporter-junit-export
option. For example, you can use thetestfully run rick-and-morty.json --reporters junit --reporter-junit-export ~/Downloads/junit-report.xml
command. To learn more about the--reporters
option, see the Testfully CLI documentation. - Mon Apr 01 2024
We’ve updated Testfully CLI to
1.6.0
. This release includes the following changes:The
--globals
and-g
options for therun
commandThe
--globals
or-g
option allows you to provide a JSON file that contains global variables to use in your requests. The global variables are available in all requests in the file. If you provide global variables in the environment file, the global variables in the environment file take precedence over the global variables in the globals file. To learn more about the--globals
option, see the Testfully CLI documentation.Default command for Testfully CLI
We’ve added the
run
command as the default command for Testfully CLI. You can now run requests without specifying therun
command. For example, you can run requests using thetestfully rick-and-morty.json
command.To update Testfully CLI to the latest version, run the
npm install -g @testfully/cli@latest
command. To verify the version, run thetestfully --version
command. At the time of writing, the latest version is1.6.0
. - Sun Mar 31 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.127.0
. This release includes the following changes:Export & Import Workspace Globals
- Workspace globals are now available for export in the desktop and web apps. This feature allows you to export workspace globals to a JSON file and import them into another workspace.
- You can now import a JSON file containing workspace globals into a workspace.
- When exporting a workspace to a JSON file, you can now choose to include or exclude workspace globals.
- Thu Mar 28 2024
We’ve updated Testfully CLI to version
1.5.0
. This release includes the following changes:New Features
- The latest Testfully CLI update (version 1.5.0) now includes a useful
--environment
option. This feature allows you to specify a path to an environment file. Testfully will then utilize this file to load various variables and settings. For detailed information on how to make the most of the Testfully CLI and the new--environment
option, please visit our Testfully CLI reference documentation.
- The latest Testfully CLI update (version 1.5.0) now includes a useful
- Wed Mar 27 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.126.0
. This release includes the following changes:Improvements
- Testfully Offline comes with a brand-new import engine. It’s now faster and more reliable than ever before to import your data from other systems.
- Tue Mar 19 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.124.0
. This release includes the following changes:New Features
- Text fields in a
multipart/form-data
request body now support custom content types. Previously, this was only possible with file fields. - You can now have multiple
multipart/form-data
text or file fields with the same name. This is useful when you need to send multiple files with the same name in a single request or when you need to send multiple values with the same name in a single request.
- Text fields in a
- Fri Mar 08 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.123.0
and Testfully CLI to1.4.0
. This release includes the following changes:Improvements
-
Testfully Web, Desktop and CLI now support a global object called
globals
. This object can be used to access current global variables in your before/after scripts. Primarily, this is useful for folks who are switching from Postman to Testfully and have a lot of scripts that rely on theglobals
variable.$.globals.toObject()
is a superior way to access global variables in your scripts. -
Testfully Web, Desktop and CLI now support the
pm.info
variable. Folks who are switching from Postman to Testfully and have a lot of scripts that rely on thepm.info
can now use this object.
Fixed
- Fixed an issue with Testfully CLI where an After Script was erroring out when response headers contained a
Set-Cookie
header.
-
- Thu Mar 07 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.122.0
. This release includes the following changes:Improvements
- Testfully Cloud & Offline users can now disable SSL verification at the folder-level. Previously, this option was available for each request or for an environment.
- Wed Mar 06 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.121.0
and Testfully CLI to version1.3.0
. This release includes the following changes:Improvements
-
Testfully Cloud and Offline users can specify a delay between requests in a collection/folder run using a new
delay
field in the collection/folder settings. This is useful when you want to simulate a real user’s behavior, or when you want to avoid overloading your server with too many requests at once. -
Testfully CLI now honors the new
delay
field in the collection/folder settings when running a collection/folder. -
Testfully CLI offers a new
--request-delay
option to specify a delay between requests when running a collection/folder. This option takes precedence over thedelay
field in the collection/folder settings. -
Schema Validation (contract testing) now supports iterating over an array of primitive values or objects and validating each object against a schema. Previously, you could only validate the first element in the array. Also, you can now validate API responses that contain a root-level array.
-
Testfully CLI was updated to the latest version to support the new schema validation features.
-
Testfully CLI now supports signing requests using the AWS Signature Version 4 signing process.
-
We’ve upgraded the engine behind our API monitoring feature to support schema validation.
-
Environment-based authorization is now available for API monitoring. This means you can now set up different authorization settings for each environment in your API monitoring configuration.
-
- Fri Feb 23 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.120.0
. This release includes the following changes:Improvements
-
Testfully Cloud and Offline users can now authenticate API requests using the AWS Signature Version 4 signing process. This is useful when you want to access AWS services using Testfully.
-
AWS Signature Version 4 signing is now available for folder-based or environment-based authorization.
-
- Mon Feb 12 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.118.0
. This release includes the following changes:New Features
-
Testfully Desktop now supports cookies. You can now view, add, edit, and delete cookies in the Cookies tab of the request editor. This is useful when you want to test how your application behaves when cookies are present or when you want to test your application’s security features.
-
Cookies are automatically captured and sent with requests using Testfully’s new Cookie Manager (jar).
-
- Tue Jan 30 2024
We’ve updated Testfully Desktop and Testfully Web to version
1.116.0
and Testfully CLI to version1.2.0
. This release includes the following changes:Improvements
-
Testfully Desktop users can now set a custom callback URL for their OAuth2 authorization flow. Previously, the callback URL was fixed to
https://app.testfully.io/oauth2/callback
. We’ve received feedback from users that their organization prefers to not use the Testfully callback URL. Web users should continue to use the Testfully callback URL as it’s the only supported option right now. -
When activating a new license, things should be a bit smoother now, with fewer errors and more helpful messages.
-
Testfully CLI supports legacy Postman API and can import
npm
packages.
Bug Fixes
- Fixed a bug where the Testfully Desktop app would be unable to get the OAuth2 token for some users and would show an
Internal Error
message.
-
- Tue Jan 23 2024
Introducing NPM package imports
We’ve added support for importing NPM packages directly into your code. This is a great way to use existing libraries in your code to implement things like encryption, hashing, validation etc. This feature is avaialble via a Plus or Premium subscription or a Testfully Offline Pro license.
To learn more, please check out the Using npm packages documentation.
- Mon Jan 22 2024
Today, we released Testfully
1.111.0
for all users. This release includes a bunch of bug fixes and improvements.Improvements
-
Testfully now remembers the last selected tab for a request, an environment, a folder or the response widget. This means that when you switch between requests, environments, folders or response widgets, Testfully will remember the last selected tab and will automatically select it for you. This is a small improvement but it will save you a lot of time when you are working with multiple tabs.
-
Response widget now remembers the last selected tab for a previous request and uses it for the next request.
-
Available ID Token for OAuth2 authorization requests is now displayed in the authorization tab.
-
Testfully now supports a range of Postman legacy scripting APIs including
postman.setEnvironmentVariable
,postman.getEnvironmentVariable
,postman.clearEnvironmentVariable
,postman.setGlobalVariable
,postman.getGlobalVariable
,postman.clearGlobalValue
,postman.getResponseHeader
,responseCode
,responseHeaders
andtests
object for automated testing.
Bug Fixes
- Fixed an issue where the response widget was not displaying the response body in Firefox.
-
- Fri Jan 05 2024
We’ve released Testfully Desktop and Testfully Web
1.105.0
with the following improvements and bug fixes.Improvements
- We’ve introduced a new global variable to Testfully Scripts called
responseBody
to make it easier for folks who are switching from Postman to Testfully to have fully working scripts. TheresponseBody
variable is a string representation of the response body. We recommend using the$.response.body
instead ofresponseBody
in your scripts as it’s more explicit and easier to understand.
Bug Fixes
- Curl commands with escaped quotes in the request body are now correctly imported into Testfully.
- Some Postman Collection 2.0 and 2.1 requests with Url-encoded payload were not imported into Testfully due to a bug in the Postman Collection parser. This issue has been fixed.
- Fixed a bug where Form-data requests with empty files were not imported into Testfully from Postman.
- Testfully Offline users could not save changes to their multi-step requests. This issue has been fixed.
- Menu for a multi-step request was not fully visible when the request payload tab was selected. This issue has been fixed.
- We’ve introduced a new global variable to Testfully Scripts called
- Tue Jan 02 2024
Work with XML & SOAP API Endpoints in Testfully
XML support is finally here! You can now work with XML API endpoints in Testfully and inspect the response body using a dedicated XML inspector. We’ve also added support for Yaml, HTML, Javascript, and plain text responses and request bodies. This means you can now work with any API endpoint in Testfully, regardless of the response type.
A brand new Response Inspector
Building the XML support allowed us to rethink the response inspector in Testfully and offer a better experience. The new experience is available for all response types and allows you to:
- View syntax-highlighted responses for JSON, XML, YAML, HTML, Javascript, and plain text responses.
- Collapse and expand any node in the response body.
- Search for any node in the response body using the search bar
(CMD/CTRL+F)
. - Copy and paste the response using
CTRL/CMD+C
andCTRL/CMD+V
.
- Sat Dec 23 2023
Testfully CLI
We’re excited to announce that we have released a brand-new Testfully CLI, compatible with both Testfully Cloud and Testfully Offline workspaces. It’s a privacy-first, robust, and cloud-free CLI that allows you to run your tests from your local machine, or your CI/CD pipeline. Running your tests is as simple as exporting your data, and running a single command. The CLI is available for Windows, macOS, and Linux, and can be installed via
npm
.To learn more about Testfully CLI, check out our documentation.
Other Improvements & Bug Fixes
- Easily import Open API Spec 3.0 and 3.1 files into Testfully, available in both Testfully Cloud and Testfully Offline workspaces.
- Testfully imports XML, HTML, YAML, Plain Text, and Javascript responses and request bodies from Postman and Insomnia.
- We fixed a bug that caused Testfully not to import multi-line cUrl commands.
- We fixed a bug that caused Testfully to not be able to import an exported Testfully folder.
- Relocating a request to a different folder wouldn’t result in using the folder variables of the new folder. We fixed this bug and now Testfully uses the folder variables of the new folder when relocating a request immediately.
- Sun Dec 10 2023
Work with folder variables in your scripts
Variables (environment, folder, collection, global) are a great way to store and reuse values across your requests.
$.globals
and$.environment
enabled our users to work with global and environment variables via code. Starting today, you can leverage$.parentFolder.variables
and$.rootFolder.variables
to work with folder variables.API Description $.parentFolder.variables
Access variables from the parent folder of the current request. $.rootFolder.variables
Access variables from the root folder of the current request. pm.collectionVariables
Alias for $.rootFolder.variables
, makes your Postman scripts work without any changeWith the addition of these APIs, you have programmatic access to all variables (global, environment, folder, collection) in your Testfully scripts. To learn more about the new APIs, check out our documentation.
- Wed Dec 06 2023
BDD-Style Testing in Javascript Now Available in Our API Client
Two new APIs, endless possibilities. You can now use the BDD-style API Testing to write your API tests in Javascript using
test
andexpect
APIs. This allows you to write your tests in a more human-readable way, making it easier to understand what your tests are doing.If you’re coming from Postman, you’ll feel right at home because the syntax is not only identical but also we support
pm.expect
andpm.test
APIs.To learn more about API testing and other Testfully Scripts capabilities, check out our documentation.
- Sun Dec 03 2023
Import cURL commands
cURL is the de facto standard for sharing API requests. To help you get started with the API, we’ve added the ability to import cURL commands into Testfully. To learn more, check out our documentation.
- Wed Nov 29 2023
Request Timeout Settings
You can now configure the timeout setting for requests. This is useful if you have a slow connection to the API or if you are using a proxy that has a timeout. The default timeout is 30 seconds. This release offers the following features:
- Adjust Request Timeout settings for a request, folder or environment. Learn More.
- Exporting and importing Testfully folders, requests or environments include the timeout settings.
- The
sendRequest
function in the Testfully API now accepts atimeout
parameter. Learn More
- Tue Oct 31 2023
Before & After Request Scripts
Being able to run custom Javascript code before or after a request was by far the most requested feature in the last few months. We’re excited to share that this feature is now available for both Testfully Cloud and Testfully Offline. Starting today, you can enhance your request, automate repetitive tasks, and implement custom workflows using Javascript.
We have designed this feature to be compatible with Postman’s pre-request and test scripts. If you’re migrating from Postman, you can easily import your Postman collection to Testfully and your scripts will work as expected.
To learn more about this feature, please check out our documentation.
- Mon Oct 16 2023
Export & Import Testfully Environments
Testfully Cloud and Offline users can export & import Testfully environments. To learn more, please read this article.
- Fixed: We’ve resolved an issue related to missing header name when exporting requests or folders with Basic Authorization scheme.
- Sun Oct 08 2023
- Export Testfully Offline Workspace Data: Similar to Testfully Cloud workspaces, Testfully Offline workspace data can be exported and imported. To learn more, please read this article.
- Mon Oct 02 2023
- Import Postman Environments You can now import your Postman environment files through the API Client interface. Additionally, Testfully now supports importing environments directly from Postman Backup files.
- We’ve resolved an issue related to not being able to add or update global values in some edge cases.
- We’ve fixed an issue related to importing Insomnia files with variables using the
{{ _.['variable-name']}}
format.
- Fri Sep 29 2023
-
Import a Postman backup (dump) file The latest version of Testfully supports Postman Backup (dump) files in JSON format. You can use this feature to import multiple collections, folders, and requests in one go. If you have a .zip file, please extract and upload files individually.
-
We’ve resolved an issue related to some of the requests not being imported due to the long request title.
-
- Mon Sep 18 2023
-
Testfully Offline, your cloud-free API client is HERE! Download the latest version of Testfully Desktop Apps via the download page to start using Testfully Offline.
-
We’ve resolved an issue related to receiving
You don't have access to the workspace
when switching between two Testfully accounts. -
We’ve resolved an issue related to tabs constantly switching between themselves.
-
- Thu Sep 07 2023
- Audience for all OAuth2 grant types When doing OAuth2 authentication, you can use the “Audience” field for all grant types. Previously, this field was only available for the Client Credentials grant type.
- We’ve resolved an issue with the desktop version of Testfully where it was incorrectly sorting fields within JSON request payload fields alphabetically instead of preserving the user-provided order.
- Sat Aug 26 2023
- HTTP Proxy is here! You can now send HTTP requests via your HTTP proxy of choice. To learn more, please read this article.
- Mon Aug 21 2023
- We have introduced a new editor for the JSON fields. It makes the editing experience of JSON input values much more pleasant and offers a range of new features including search, auto-format, code indention, and find & replace.
- Fixed an issue related to using the OAuth2 authorization feature for getting a valid token from a Microsoft Azure AD tenant.
- Fri Aug 11 2023
- Fixed an issue related to unsubscribing from our mailing list via the provided link in the What’s New in Testfully newsletter. We have also unsubscribed users who could not unsubscribe from the newsletter due to this issue.
- Sun Jul 30 2023
- Rather than showing
Access Denied
error when a user accesses restricted areas (for example, user management), we no longer show unavailable menu options to the user. - We have rolled out a series of changes related to our infrastructure to improve the performace of both desktop and web apps.
- Desktop app no longer rejects invalid JSON payloads, allowing testing of API behavior with invalid input data.
- Fixed issue with Testfully rejecting requests with
{{}}
in the payload, improving app flexibility. - Issue resolved: saving requests with
{{}}
in the payload is now possible in the app. - A visual bug related to the navbar in Firefox is now fixed.
- Rather than showing
- Thu Jul 27 2023
- Easily export your folders and requests by clicking a few buttons starting today. Find more information in the How to export your data article.
- Utilize Testfully’s Importer tool to import the data you have exported using our Export tool.
- We have fixed an issue related to processing Postman Collection 2.0 files that were exported using old versions of Postman.
- Tue Jul 25 2023
- Testfully supports Postman Collection V2.0 as well as V2.1.
- When importing Postman collections, Testfully brings collection variables & auth settings, folder auth settings and request auth settings.
- Import collections to the root of your workspace by clicking on the ”+” icon, and selecting “Import”.
- We have improved the overall UX of our Import tool to ask fewer questions from the end-user, and offer a better experience when importing data goes wrong.