Node.js Quickstart

Install
Terminal window
```
npm install rayobrowse playwright
```

Local usage

import { Rayobrowse } from 'rayobrowse';
import { chromium } from 'playwright';

const client = new Rayobrowse({
  endpoint: 'ws://localhost:9222',
  apiKey: '',
});

const wsUrl = await client.connectUrl({ os: 'windows' });
const browser = await chromium.connectOverCDP(wsUrl);
const page = await browser.newPage();
await page.goto('https://example.com');
console.log(await page.title());
await browser.close();

Cloud usage

const client = new Rayobrowse({
  endpoint: 'wss://cloud.rayobrowse.com',
  apiKey: 'your-api-key',
});

const wsUrl = await client.connectUrl({
  os: 'windows',
  proxy: 'http://user:pass@host:port',
});

Error handling

import { AuthError, ConcurrencyLimitError, RateLimitError } from 'rayobrowse';

try {
  const wsUrl = await client.connectUrl({ os: 'windows' });
} catch (err) {
  if (err instanceof AuthError) {
    console.error('Invalid API key');
  } else if (err instanceof ConcurrencyLimitError) {
    console.error(`Limit: ${err.active}/${err.limit}`);
  } else if (err instanceof RateLimitError) {
    console.error(`Rate limited, retry in ${err.retryAfter}s`);
  }
}

Node.js Quickstart

Next steps