JavaScript/TypeScript SDK

import { Grasp } from '@getgrasp/sdk';

const grasp = new Grasp({
  apiKey: 'your-api-key'
});

const container = await grasp.create();
console.log('Browser ready:', container.browser.wsEndpoint);

await container.shutdown();

// Using environment variable
const grasp = new Grasp();

// With explicit API key
const grasp = new Grasp({
  apiKey: 'your-api-key'
});

// Create basic container
const container = await grasp.create();

// With idle timeout
const container = await grasp.create({
  idleTimeout: 60000  // 60 seconds
});

// With proxy settings
const container = await grasp.create({
  proxy: {
    enabled: true,
    type: 'residential',
    country: 'US'
  }
});

const containerId = 'existing-container-id';
const container = await grasp.connect(containerId);

console.log('Connected to:', container.id);

await container.shutdown();

console.log('CDP endpoint:', container.browser.wsEndpoint);
console.log('Live view:', container.browser.liveURL);

type TProxySettings = {
  enabled: boolean;
  type: 'mobile' | 'residential' | 'isp' | 'datacenter' | 'custom';
  country?: string;  // ISO 3166 country code (e.g., 'US')
  state?: string;    // State code (e.g., 'CA')
  city?: string;     // City name
};

type TBrowserSettings = {
  // Browser settings - not yet implemented
};

type TTerminalSettings = {
  // Terminal settings - not yet implemented
};

type TFileSystemSettings = {
  // Filesystem settings - not yet implemented
};

try {
  const container = await grasp.create();
  // Use container
  await container.shutdown();
} catch (error) {
  console.error('Failed to create container:', error.message);
  if (error.status) {
    console.error('HTTP status:', error.status);
  }
}

import { Grasp, type GraspCreateOptions, type GraspContainer } from '@getgrasp/sdk';

const options: GraspCreateOptions = {
  idleTimeout: 60000,
  proxy: {
    enabled: true,
    type: 'residential',
    country: 'US'
  }
};

const grasp = new Grasp({ apiKey: process.env.GRASP_API_KEY });
const container: GraspContainer = await grasp.create(options);

import { Grasp } from '@getgrasp/sdk';
import { chromium } from 'playwright';

const grasp = new Grasp();

// Create container
const container = await grasp.create({
  idleTimeout: 300000  // 5 minutes
});

// Connect Playwright to cloud browser
const browser = await chromium.connectOverCDP(container.browser.wsEndpoint);
const page = await browser.newPage();

// Perform automation
await page.goto('https://news.ycombinator.com');
const headlines = await page.$$eval('.titleline > a', links =>
  links.slice(0, 5).map(link => link.textContent?.trim())
);
console.log('Top stories:', headlines);

// Clean up
await browser.close();
await container.shutdown();

// First session - create and save ID
const container = await grasp.create();
const containerId = container.id;
console.log('Container ID:', containerId);
// Save containerId to database or file

// Later session - reconnect
const grasp = new Grasp();
const container = await grasp.connect(containerId);
console.log('Reconnected to:', container.id);