TestOwl LogoTestOwlDocs

Network, Proxy & Storage

The Network, Proxy & Storage section in the Environment editor controls how your test environment communicates with your application and what browser state is available before execution starts.

Configure network behavior, proxy settings, and preloaded browser storage to test different real-world scenarios without adding extra test steps.

Network

Configure how requests are sent and how your application responds under different network conditions.

FieldDescription
Basic AuthenticationProvide username and password credentials for applications protected with HTTP Basic Authentication, such as password-protected staging environments.
Network ThrottlingSimulate different connection speeds by selecting a built-in profile or a custom throttle preset.
Request HeadersAdd custom HTTP headers that are sent with requests made during the test execution.

Custom network throttle presets

In addition to built-in network profiles, you can create custom throttle presets from the Network Throttling dropdown by selecting Add custom preset.

Configure the following values:

  • Name — A unique name for the preset, such as Flaky 3G or Office Wi-Fi.
  • Download — Maximum download speed in Kbps.
  • Upload — Maximum upload speed in Kbps.
  • Latency — Network delay in milliseconds.

Custom presets are available at the project level, allowing your team to reuse the same network configurations across environments.

The number of saved custom presets depends on your plan. See Plans & Usage for details.

Proxy

Configure a proxy server for routing browser traffic during test execution.

FieldDescription
ServerThe proxy server address. Example: 127.0.0.1:8080
BypassA comma-separated list of hosts that should bypass the proxy. Example: localhost, 127.0.0.1
Username / PasswordAuthentication credentials required by the proxy server.

Saved proxy passwords are never displayed after saving. Instead, TestOwl shows a Clear saved password option, keeping credentials secure similar to Secrets.

Storage

Preload browser storage before the test starts instead of creating separate steps to set up the required state.

FieldDescription
CookiesAdd key-value pairs that are stored as browser cookies when the test begins.
Local StorageAdd key-value pairs that are stored in the browser's localStorage.
Session StorageAdd key-value pairs that are stored in the browser's sessionStorage.

Preloaded storage is useful for scenarios such as:

  • Starting a test with an existing login session.
  • Enabling feature flags before execution.
  • Setting application preferences without recording additional steps.

Next steps