Function findPort

browse/src/server.ts:879–900

()

// Find port: explicit BROWSE_PORT, or random in 10000-60000
async function findPort(): Promise<number> {
  // Explicit port override (for debugging)
  if (BROWSE_PORT) {
    const result = await checkPortAvailable(BROWSE_PORT);
    if (result.available) {
      return BROWSE_PORT;
    }
    throw formatExplicitPortUnavailableError(BROWSE_PORT, result);
  }

  // Random port with retry
  const attempts: FailedPortAttempt[] = [];
  for (let attempt = 0; attempt < RANDOM_PORT_RETRIES; attempt++) {
    const port = RANDOM_PORT_MIN + Math.floor(Math.random() * (RANDOM_PORT_MAX - RANDOM_PORT_MIN));
    const result = await checkPortAvailable(port);
    if (result.available) {
      return port;
    }
    attempts.push({ port, result });
  }
  throw formatRandomPortUnavailableError(attempts);
}

/**
 * Translate Playwright errors into actionable messages for AI agents.