timing

const timing: object

Defined in: utils/timing.ts:254

Timing namespace object for convenient access.

Type Declaration

humanDelay()

humanDelay: (min, max) => Promise<void>

Sleep for a random duration (for human-like timing).

Useful for browser automation to appear more human-like.

Parameters

min

number = 50

Minimum delay in milliseconds (default: 50)

max

number = 150

Maximum delay in milliseconds (default: 150)

Returns

Promise<void>

Promise that resolves after the random delay

Example

// Default human-like delay (50-150ms)
await humanDelay();

// Custom range for slower actions
await humanDelay(100, 300);

randomDelay()

randomDelay: (min, max) => number

Generate a random delay within a range.

Parameters

min

number

Minimum delay in milliseconds

max

number

Maximum delay in milliseconds

Returns

number

Random integer between min and max (inclusive)

Example

const delay = randomDelay(50, 150);  // e.g., 87

withRetry()

withRetry: <T>(fn, options) => Promise<T>

Execute an async function with retry logic.

Type Parameters

T

T

Parameters

fn

() => Promise<T>

Async function to execute

options

RetryOptions = {}

Retry options

Returns

Promise<T>

Promise that resolves with the function result or rejects after all retries exhausted

Example

// Basic retry with defaults (3 retries, exponential backoff)
const result = await withRetry(() => unreliableApi());

// Custom retry configuration
const result = await withRetry(
  () => fetchWithErrors(),
  {
    maxRetries: 5,
    delay: 500,
    backoff: "exponential",
    shouldRetry: (error) => error.status === 429 || error.status >= 500,
    onRetry: (error, attempt, delay) => {
      console.log(`Retry ${attempt} after ${delay}ms`);
    }
  }
);

withTimeout()

withTimeout: <T>(fn, timeoutMs, signal?) => Promise<T>

Execute an async function with a timeout.

Type Parameters

T

T

Parameters

fn

() => Promise<T>

Async function to execute

timeoutMs

number

Timeout in milliseconds

signal?

AbortSignal

Optional AbortSignal for early cancellation

Returns

Promise<T>

Promise that resolves with the function result or rejects on timeout

Throws

Error with “Operation timed out” message if timeout is exceeded

Example

const result = await withTimeout(
  () => fetch("https://api.example.com/data"),
  5000
);

// With abort signal
const controller = new AbortController();
const result = await withTimeout(
  () => longRunningTask(),
  30000,
  controller.signal
);

Example

import { timing } from "llmist";

await timing.humanDelay();
const result = await timing.withTimeout(() => fetch(url), 5000);
const data = await timing.withRetry(() => api.call(), { maxRetries: 3 });