You can use these custom Sauce Labs options with the Selenium JavaScript Executor, in conjunction with the Extended debugging feature, to control networking capabilities for your tests, and to generate custom logs for extended debugging.
Extended Debugging Required
You must have Extended Debugging enabled and run your tests on Chrome browsers to use these commands.
For Chrome Only
This feature is only available for testing on Chrome browsers versions 62 and above.
Demo examples
You can find more examples of this feature written in Node.js, Python, and Java at https://github.com/saucelabs/extended_debugging_demo
Test Environment Tools
The Test Environment Tools let you simulate network conditions and manipulate network requests to understand and improve the performance of your tests.
Intercept Network Requests
Allows modifying any request made by the browser. You can blacklist, modify, or redirect these as required for your tests. For example, you can:
- Blacklist requests to 3rd party vendors
- Modify requests to REST API (Mock REST API response)
- Redirect certain parts of the app
- Insert/change headers
| JavaScript Executor Command | Request Parameters | Sample Code |
|---|---|---|
|
| driver.execute_script('sauce:intercept', {
"url": "https://saucelabs.com",
"redirect": "https://google.com"
})
|
|
| driver.execute_script("sauce:intercept", {
"url": "http://sampleapp.appspot.com/api/todos",
"response": {
"headers": {
"x-custom-header": "foobar"
},
"body": [{
"title": "Hello",
"order": 1,
"completed": false,
"url": "http://todo-backend-express.herokuapp.com/15727"
}]
}
})
|
sauce:intercept+ error |
| driver.execute_script("sauce:intercept", {
"url": "https://saucecon.com/wp-content/uploads/2017/07/SauceCon-hero-img-100-2.jpg",
error: "Failed"}
|
Example
Python example
driver.execute_script('sauce:intercept', {
"url": "https://saucelabs.com",
"redirect": "https://google.com"
})
# or
driver.execute_script('sauce:intercept', {
"url": "https://saucelabs.com/res7/v1/build/32hmv4j32v4j2j3v4j24v232vj4j",
"response": {
"statusCode": 200,
"headers": {
"etag": 3244224432,
"Cookie: "foo=bar",
...
},
"rawResponse": "{\"username\":\"..."
}
})
Throttle CPU Capabilities
Mobile devices have much less CPU power than desktops and laptops. Whenever you performance tests on a page, use CPU Throttling to simulate how your page performs on mobile devices. This will help to find performance problems in your application much easier.
| JavaScript Executor Command | Request Parameters | Example |
|---|---|---|
sauce:throttleCPU |
| driver.execute_script('sauce:throttleCPU', {
"rate": 4
})
|
Throttle Network Capabilities
With network conditioning you can test your site on a variety of network connections, including Edge, 3G, and even offline. You can throttle the data throughput, including the maximum download and upload throughput, and use latency manipulation to enforce a minimum delay in connection round-trip time (RTT).
| JavaScript Executor Command | Request Parameters | Example | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sauce:throttleNetwork |
| driver.execute_script('sauce:throttleNetwork', {
"condition": "GPRS"
})
# or
driver.execute_script('sauce:throttleNetwork', {
"condition": {
"download": 1000,
"upload": 500,
"latency": 40
}
})
|
Extended Debugging Tools
The Extended Debugging Tools provide you with additional logs to analyze your test performance.
Network Log
The Sauce Labs network log receives comprehensive information on all network requests being made by the page currently open in the browser.
| Log Type | Response |
|---|---|
sauce:network | Sample response [{
"url": "http://saucelabs.com/beta/dashboard",
"statusCode": 200,
"method": "GET",
"requestHeaders": {
...
},
"responseHeaders": {
...
},
"timing": {
"blocked": -1,
"connect": -1,
"dns": -1,
"receive": 0,
"send": 0,
"ssl": -1,
"wait": 0
}
}, {
...
}]
|
Performance Log
The Sauce Labs performance log receives performance-related metrics
| Log Type | Response |
|---|---|
sauce:performance | Sample response {
"load": 1083,
"speedIndex": 905,
"firstInteractive": 1073,
"firstVisualChange": 576,
"lastVisualChange": 1243,
"firstMeaningfulPaint": 1239,
"firstCPUIdle": 1239,
"timeToFirstByte": 69,
"firstPaint": 559,
"estimatedInputLatency": 16,
"firstContentfulPaint": 630,
"score": 0.9947067807295903,
"domContentLoaded": 1073
}
|
Overview
Content Tools