Error Handling

{
  "error": {
    "code": "url_unreachable",
    "message": "The provided URL could not be reached by our test runners.",
    "details": {
      "url": "https://example.com/checkout",
      "http_status": 503,
      "retried": true
    }
  }
}

import { SimuTest, SimuTestError, AuthError, QuotaError, RateLimitError } from '@simutest/node';

const client = new SimuTest({ apiKey: process.env.SIMUTEST_API_KEY });

try {
  const test = await client.tests.create({
    url: 'https://example.com',
    task: 'Find the pricing page',
    sessions: 100,
  });
} catch (err) {
  if (err instanceof AuthError) {
    // Invalid or expired API key — check your key
    console.error('Authentication failed:', err.message);
  } else if (err instanceof QuotaError) {
    // Monthly session quota exceeded
    console.error('Quota exceeded:', err.details.quota_resets_at);
  } else if (err instanceof RateLimitError) {
    // Too many requests — retry after the indicated delay
    const retryAfter = err.retryAfter; // seconds
    await sleep(retryAfter * 1000);
  } else if (err instanceof SimuTestError) {
    // All other API errors
    console.error(`[${err.code}] ${err.message}`);
  } else {
    throw err; // re-throw unexpected errors
  }
}

async function withRetry<T>(fn: () => Promise<T>, maxAttempts = 3): Promise<T> {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    try {
      return await fn();
    } catch (err) {
      const isRetryable =
        err instanceof RateLimitError ||
        (err instanceof SimuTestError && err.retryable);

      if (!isRetryable || attempt === maxAttempts) throw err;

      const delay = err instanceof RateLimitError
        ? err.retryAfter * 1000
        : Math.min(1000 * 2 ** (attempt - 1), 10000);

      await sleep(delay);
    }
  }
  throw new Error('Unreachable');
}