Modify Response Body
- Only requests triggered by XHR/fetch can be modified by the browser extension. For other type of requests, use Desktop App
- Response Modifications will not show up in the browser network devtools due to technical contraints. Try this to test whether Response Rule is working or not.
The Modify Response Rule allows you to mock the response body of an HTTP request.
Popular use cases
- You want to work on front-end while back-end is not available or ready yet.
- You want to test application behaviour when provided altered data.
- You want to simulate errors by returning different status codes.
- You want to modify API responses but don't have access to the back-end.
Supported resource types
- Rest API: Supports modifying XHR/fetch requests.
- GraphQL API: Target & modify GraphQL api using operation.
- HTML/JS/CSS: Only available in Desktop app
Types of Modifications
Static Response Modification
In this mode, you can enter the response body which you want as the response.
- Source Condition : If the request url matches this source condition, then only the rule is applied. You can use
Equalsto match the source request. Learn more about source conditions here.
- Status Code : Update the Response status code. (2XX, 3XX, 4XX, 5XX ...). If left empty, original status code is returned.
- Static Response Body : Define the updated response body which needs to be returned.
- Source Filters : This helps you define better targeting conditions and restrict rules to be applied on specific webpages (or domains), request types, request methods, or request payload. Learn more about source filters here.
Programmatic Response Modification
method(string)- The HTTP method of the request.
GET | POST | PUT | DELETEetc.
url(string) - The request URL.
response(string)- The original response object represented as string. Eg:
responseType(string)- The content-type of the HTTP response.
requestHeaders(Object<string, string>)- The request headers sent to the server.
requestData(string)- The HTTP request payload in case of
POST | PUT | PATCHrequests.
responseJSON(JSON object)- The original response represented as JSON Object:
Return type of modifyResponse (
You can modify both response or responseJSON and return any of them. Response Rule will automatically handle the response returned for the request.
Targeting GraphQL requests
You can target GraphQL requests using the operation name in request body. To do so add:
- Payload JSON Key, e.g.,
- Value, e.g.,
To learn more about this checkout GraphQL Support.
- Modifying Response asynchronously: Async modifications lets you perform some long running tasks before returning the response
- Modifying Non Existent Domain: Helpful for frontend developers when the backend isn't ready yet.
Response Rule not working
Rule might not be working for 2 reasons
- Is not XHR/fetch request
Only requests triggered by XHR/fetch can be modified by the browser extension due to technical constraints. For other type of requests, use Desktop App instead.
- Rule working but doesn't show updated response in devtools
Response Modifications (body & status code) will not show up in the browser network devtools due to technical constraints. So your rule might actually be working but only doesn't show the updated response in the browser devtools. Try this to verify whether your Response Rule is working or not.
What happens if i leave the status code field empty
If you leave the status code empty, then the original status code of the request is returned.
Where would `console.log` show up?
Console logs will show up in the `console` of the website where you are testing rule on.
How to target `query` in graphQL requests
Right now, only targetting using `operationName` is supported.