withNetworkSettledWait

export declare function withNetworkSettledWait<T>(callback: (page: Page) => Promise<T>,
  options?: {
    page: Page;
    timeoutInMs?: number;
    maxInflightRequests?: number;
  }): Promise<T>;

Executes a callback function and waits for network requests to settle before returning.

This function monitors network activity and waits for all pending requests to complete (or reach the specified maximum) before resolving. Useful for ensuring dynamic content has fully loaded after performing actions that trigger network requests.

Examples

Navigation with Network Settlement

import { withNetworkSettledWait } from "@intuned/browser";
export default async function handler(params, page, context){
// Navigate and ensure all resources are loaded
await withNetworkSettledWait(
  async (page) => {
    await page.goto('https://spa-app.com/dashboard');
    // Return when navigation is complete and network is idle
  },
  {
    page,
    timeoutInMs: 20000,
    maxInflightRequests: 0 // Wait for complete network silence
  }
);
}

Arguments

callback · Function · required

The callback function to execute. Receives the page object as parameter

options · Object

Configuration options for network monitoring

Show options

options.page · Page

The Playwright page object to monitor for network activity

options.timeoutInMs · number

Maximum time to wait in milliseconds before timing out. Defaults to 30000

options.maxInflightRequests · number

Maximum number of pending requests to consider as “settled”. Defaults to 0 (waits for all requests to complete)

Returns: Promise<T>

Promise that resolves to the callback’s return value after network settles