Network simulation (iOS)

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();

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();

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();

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});
    });
  },
);