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 69 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
The Test Environment Tools let you simulate network conditions and manipulate network requests to understand and improve the performance of your tests.
Allows modifying any request made by the browser. You can blacklist, modify, or redirect these as required for your tests. For example, you can:
| 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
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\":\"..."
}
})
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
})
|
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
}
})
|
The Extended Debugging Tools provide you with additional logs to analyze your test performance.
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
}
}, {
...
}]
|
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
}
|