> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qawolf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Network simulation (iOS)

> Simulate degraded network conditions on iOS devices to test how your app handles slow connections, high latency, or no connectivity.

## Examples

**Using a predefined condition:**

```js theme={null}
import { device } from "@qawolf/flows/ios";

// Traffic must be routed through the gateway before applying
// network conditions — use direct mode if you don't need a VPN

const routeCleanup = await device.routeTraffic({
    apps: ["com.example.app"],
    tunnel: { type: "direct" },
});

const conditionCleanup = await device.simulateNetworkCondition(device.NETWORK_3G);

// ... verify the app handles slow network gracefully ...

await conditionCleanup();
await routeCleanup();
```

**Custom conditions:**

```js theme={null}
import { device } from "@qawolf/flows/ios";

const cleanup = await device.simulateNetworkCondition({
  bandwidthKbps: 5000,
  latencyMs: 600,
  jitterMs: 50,
  packetLossPercent: 1.0,
});

// ... verify timeouts, retries, offline banners ...

await cleanup();
```

**Offline mode (no connectivity):**

```js theme={null}
import { device } from "@qawolf/flows/ios";

// Simulates offline mode by dropping all packets.
// Note: this may not trigger every app's offline UI —
// some apps only show offline states when the connection drops abruptly

const cleanup = await device.simulateNetworkCondition(device.NETWORK_OFFLINE);

// ... verify offline error handling, cached content ...

await cleanup();
```

## When to use

* Testing how your app behaves when loading is slow — spinners, timeouts, retry logic.
* Verifying your app shows the right error messages when connectivity is poor or lost.
* Testing video or audio streaming features that adapt quality based on available bandwidth (adaptive bitrate streaming).
* Reproducing issues customers have reported on slow or unreliable connections.
* Making sure your app degrades gracefully for users on 2G or 3G networks.

## Notes

* Before calling `device.simulateNetworkCondition()`, you must call `device.routeTraffic()`; otherwise, you will get an error.
* Always call cleanup functions in reverse order: restore network conditions first, then stop routing.
* Bandwidth limiting applies to TCP traffic only.
* Latency, jitter, and packet loss apply to all traffic (TCP and UDP).
* `NETWORK_OFFLINE` simulates no connectivity by dropping all packets. Requests will time out rather than fail immediately — this may behave differently from a true offline state on some devices.

## Full sample test

```js theme={null}
import { flow, device } from "@qawolf/flows/ios";

export default flow(
  "iOS Network Simulation with fast.com",
  { target: "iOS - iPhone 15 (iOS 26)", launch: { browserName: "safari" } },
  async ({ driver, test }) => {
    await test("Install app", async () => {

      // Start VPN
      const cleanupProxy = await device.routeTraffic({
        apps: [],
        tunnel: {
          type: "direct", 
       }});

      let cleanUpNetworkCondition = await device.simulateNetworkCondition(device.NETWORK_5G)
      console.log(await device.getNetworkCondition())
      
      await driver.url("https://fast.com");

      // switch to webview
      const contexts = await driver.getContexts();
      const webViewContext = contexts.reverse().find(context => context.toLowerCase().startsWith("webview_"));
      await driver.switchContext(webViewContext);

      // wait for the test result for 5G
      await driver.$(`//*[@id='your-speed-message']`).waitForDisplayed({timeout: 30_000});

      // clean-up and set 2G
      await cleanUpNetworkCondition();
      cleanUpNetworkCondition = await device.simulateNetworkCondition(device.NETWORK_2G_EDGE)
      console.log(await device.getNetworkCondition())
    
      await driver.url("https://fast.com");

      // wait for the test result for 2G
      await driver.$(`//*[@id='your-speed-message']`).waitForDisplayed({timeout: 30_000});
    });
  },
);
```