---
title: 'Custom WebDriver commands: performance, network and mocking.'
description: 'Custom WebDriver Commands by TestingBot: mock responses and monitor
  performance during your tests.'
source_url:
  html: https://testingbot.com/support/web-automate/selenium/network
  md: https://testingbot.com/support/web-automate/selenium/network.md
---

# Custom WebDriver Commands by TestingBot

TestingBot has added custom WebDriver commands for Chrome and Microsoft Edge browsers.

With these custom commands, you can **retrieve various metrics** , **throttle network speed** and **monitor/adjust network requests** during your test.

These custom commands can be used with WebDriver's `JavascriptExecutor`.

**Important:** to be able to use these commands, **you need to pass** `debugging: true` in your desired capabilities.

## Throttle Network

### Description:

This call allows you to throttle network speed, or even simulate no network connection (offline-mode).

[Java](https://testingbot.com#) [Python](https://testingbot.com#) [NodeJS](https://testingbot.com#) [Ruby](https://testingbot.com#) [PHP](https://testingbot.com#) [C#](https://testingbot.com#)

```java
((JavascriptExecutor) driver).executeScript("tb:throttle", "3G");
// or
Map<String, Object> throttleMap = new HashMap<>();
throttleMap.put("downloadSpeed", 10 * 1024);
throttleMap.put("uploadSpeed", 10 * 1024);
throttleMap.put("latency", 0);
throttleMap.put("loss", 0);
((JavascriptExecutor) driver).executeScript("tb:throttle", throttleMap);
```

```python
driver.execute_script("tb:throttle", "3G")
# or
driver.execute_script("tb:throttle", {
    "downloadSpeed": 10 * 1024,
    "uploadSpeed": 10 * 1024,
    "latency": 0,
    "loss": 0
})
```

```javascript
await driver.executeScript('tb:throttle', '3G');
// or
await driver.executeScript('tb:throttle', {
    "downloadSpeed": 10 * 1024,
    "uploadSpeed": 10 * 1024,
    "latency": 0,
    "loss": 0
});
```

```ruby
driver.execute_script("tb:throttle", "3G")
# or
driver.execute_script("tb:throttle", {
    "downloadSpeed" => 10 * 1024,
    "uploadSpeed" => 10 * 1024,
    "latency" => 0,
    "loss" => 0
})
```

```php
$driver->executeScript("tb:throttle", ["3G"]);
// or
$driver->executeScript("tb:throttle", [
    "downloadSpeed" => 10 * 1024,
    "uploadSpeed" => 10 * 1024,
    "latency" => 0,
    "loss" => 0
]);
```

```csharp
((IJavaScriptExecutor)driver).ExecuteScript("tb:throttle", "3G");
// or
((IJavaScriptExecutor)driver).ExecuteScript("tb:throttle", new Dictionary<string, object>
{
    ["downloadSpeed"] = 10240,
    ["uploadSpeed"] = 10240,
    ["latency"] = 0,
    ["loss"] = 0
});
```

#### Options:

| `tb:throttle` Specifying a predefined condition | Condition \| Download Speed (kb/sec) \| Upload Speed (kb/sec) \| Latency (ms) \|\| `airplane` Simulate Offline Mode \| 0 \| 0 \| 0 \| \| `disable` Default - useful if you want to undo the `offline` command. \| no throttle \| no throttle \| no throttle \| \| `edge` \| 250 \| 150 \| 300 \| \| `3G` \| 400 \| 100 \| 100 \| \| `4G` \| 18000 \| 9000 \| 100 \| |
| `tb:throttle` Specify custom settings | `downloadSpeed` \| `uploadSpeed` \| `latency` \|\| ... kb / sec \| ... kb / sec \| ... ms \| |

## Intercept/Mock

### Description:

With these commands, you can intercept and even fake responses during your test.   
Blacklist requests, add/modify headers, mock responses, ...

The `url` parameter supports wildcard statements, for example: `https://www.testingbot.com/*`.

### Redirect a URL

Instructs Chrome/Edge to redirect to `redirect` upon navigating to `url`.

[Java](https://testingbot.com#) [Python](https://testingbot.com#) [NodeJS](https://testingbot.com#) [Ruby](https://testingbot.com#) [PHP](https://testingbot.com#) [C#](https://testingbot.com#)

```java
Map<String, Object> interceptMap = new HashMap<>();
interceptMap.put("redirect", "https://www.google.com");
interceptMap.put("url", "https://testingbot.com");
((JavascriptExecutor) driver).executeScript("tb:intercept", interceptMap);
```

```python
driver.execute_script("tb:intercept", {
    "redirect": "https://google.com",
    "url": "https://testingbot.com"
})
```

```javascript
await driver.executeScript('tb:intercept', {
    "redirect": "https://google.com",
    "url": "https://testingbot.com"
});
```

```ruby
driver.execute_script("tb:intercept", {
    "redirect" => "https://www.google.com",
    "url" => "https://testingbot.com"
})
```

```php
$driver->executeScript("tb:intercept", [
    "redirect" => "https://google.com",
    "url" => "https://testingbot.com"
]);
```

```csharp
((IJavaScriptExecutor)driver).ExecuteScript("tb:intercept", new Dictionary<string, object>
{
    ["redirect"] = "https://www.google.com",
    ["url"] = "https://testingbot.com"
});
```

### Trigger Failure

Allows you to return a specific error for a specific request.

[Possible errors](https://chromedevtools.github.io/devtools-protocol/tot/Network#type-ErrorReason):

- Failed
- Aborted
- TimedOut
- AccessDenied
- ConnectionClosed
- ConnectionReset
- ConnectionRefused
- ConnectionAborted
- ConnectionFailed
- NameNotResolved
- InternetDisconnected
- AddressUnreachable
- BlockedByClient
- BlockedByResponse

[Java](https://testingbot.com#) [Python](https://testingbot.com#) [NodeJS](https://testingbot.com#) [Ruby](https://testingbot.com#) [PHP](https://testingbot.com#) [C#](https://testingbot.com#)

```java
Map<String, Object> interceptMap = new HashMap<>();
interceptMap.put("error", "ConnectionRefused");
interceptMap.put("url", "https://testingbot.com");
((JavascriptExecutor) driver).executeScript("tb:intercept", interceptMap);
```

```python
driver.execute_script("tb:intercept", {
    "error": "ConnectionRefused",
    "url": "https://testingbot.com"
})
```

```javascript
await driver.executeScript('tb:intercept', {
    "error": "ConnectionRefused",
    "url": "https://testingbot.com"
});
```

```ruby
driver.execute_script("tb:intercept", {
    "error" => "ConnectionRefused",
    "url" => "https://testingbot.com"
})
```

```php
$driver->executeScript("tb:intercept", [
    "error" => "ConnectionRefused",
    "url" => "https://testingbot.com"
]);
```

```csharp
((IJavaScriptExecutor)driver).ExecuteScript("tb:intercept", new Dictionary<string, object>
{
    ["error"] = "ConnectionRefused",
    ["url"] = "https://testingbot.com"
});
```

### Mock Response

Allows you to return a different response (body or headers).

[Java](https://testingbot.com#) [Python](https://testingbot.com#) [NodeJS](https://testingbot.com#) [Ruby](https://testingbot.com#) [PHP](https://testingbot.com#) [C#](https://testingbot.com#)

```java
Map<String, Object> mockMap = new HashMap<>();
Map<String, Object> headersMap = new HashMap<>();
headersMap.put("x-a-header", "Sample");
Map<String, Object> responseMap = new HashMap<>();
responseMap.put("statusCode", 200);
responseMap.put("headers", headersMap);
responseMap.put("body", "Hello World");
mockMap.put("response", responseMap);
mockMap.put("url", "https://testingbot.com");
((JavascriptExecutor) driver).executeScript("tb:intercept", mockMap);
```

```python
driver.execute_script("tb:intercept", {
    "response": {
        "statusCode": 200,
        "headers": {
            "x-a-header": "Sample"
        },
        "body": "Hello World"
    },
    "url": "https://testingbot.com"
})
```

```javascript
await driver.executeScript('tb:intercept', {
    "response": {
        "statusCode": 200,
        "headers": {
            "x-a-header": "Sample"
        },
        "body": "Hello World"
    },
    "url": "https://testingbot.com"
});
```

```ruby
driver.execute_script("tb:intercept", {
    "response" => {
        "statusCode" => 200,
        "headers" => {
            "x-a-header" => "Sample"
        },
        "body" => "Hello World"
    },
    "url" => "https://testingbot.com"
})
```

```php
$driver->executeScript("tb:intercept", [
    "response" => [
        "statusCode" => 200,
        "headers" => [
            "x-a-header" => "Sample"
        ],
        "body" => "Hello World"
    ],
    "url" => "https://testingbot.com"
]);
```

```csharp
((IJavaScriptExecutor)driver).ExecuteScript("tb:intercept", new Dictionary<string, object>
{
    ["response"] = new Dictionary<string, object>
    {
        ["statusCode"] = 200,
        ["headers"] = new Dictionary<string, object> { ["x-a-header"] = "Sample" },
        ["body"] = "Hello World"
    },
    ["url"] = "https://testingbot.com"
});
```

## Retrieve Network Log

### Description:

With the `tb:network` command you can fetch a log of network calls from Chrome and Microsoft Edge.

[Java](https://testingbot.com#) [Python](https://testingbot.com#) [NodeJS](https://testingbot.com#) [Ruby](https://testingbot.com#) [PHP](https://testingbot.com#) [C#](https://testingbot.com#)

```java
((JavascriptExecutor) driver).executeScript("tb:network");
```

```python
driver.execute_script("tb:network")
```

```javascript
await driver.executeScript('tb:network');
```

```ruby
driver.execute_script("tb:network")
```

```php
$driver->executeScript("tb:network");
```

```csharp
((IJavaScriptExecutor)driver).ExecuteScript("tb:network");
```

### Looking for more help?

Have questions or need more information? Reach out via email or Slack.

[Email us](https://testingbot.com/contact/new) [Join our Slack](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)