TypeScript/Node.js SDK

import grasp from '@grasplabs/grasp';
import { chromium } from 'playwright';

async function main() {
  // 在云环境中启动浏览器
  const connection = await grasp.launchBrowser({
    // key: process.env.GRASP_KEY || '', // 如果设置了 GRASP_KEY 环境变量则可选
    // type: 'chrome-stable',
    // headless: false, 
    // adblock: true, 
    // debug: true,
    timeout: 3600000, // 容器最多运行 1 小时（最大值：86400000 - 24小时）
  });

  console.log('浏览器连接:', connection);

  // 使用 Playwright 连接到浏览器
  const browser = await chromium.connectOverCDP(connection.wsUrl, {
    timeout: 150000,
  });

  // 可选：等待一段时间
  // await setTimeout(10000);

  // 创建第一个页面并导航
  const page1 = await browser.newPage();
  await page1.goto('https://getgrasp.ai/', { waitUntil: 'domcontentloaded' });
  await page1.screenshot({ path: 'grasp-ai.png' });
  await page1.close();

  // 获取或创建上下文
  const context = browser.contexts()[0] || await browser.newContext();

  // 创建第二个页面
  const page2 = await context.newPage();

  // 将 HTML 字符串渲染到页面
  await page2.setContent(`<h1>Hello Grasp</h1>`, { waitUntil: 'networkidle' });

  // 截图
  await page2.screenshot({ path: 'hello-world.png', fullPage: true });

  // 清理资源
  await page2.close();
  await context.close();
  await browser.close();

  console.log('✅ 任务完成。');
}

main();

const connection = await grasp.launchBrowser({
  key: 'your_api_key_here',
  type: 'chrome-stable',
  headless: false,
  timeout: 3600000,
  adblock: true,
  debug: true
});

import { chromium } from 'playwright';

const connection = await grasp.launchBrowser();
const browser = await chromium.connectOverCDP(connection.wsUrl, {
  timeout: 150000
});

// 像使用普通的 Playwright 浏览器实例一样使用浏览器
const page = await browser.newPage();
// ... 您的自动化代码

await browser.close();

import grasp from '@grasplabs/grasp';
import { chromium } from 'playwright';

async function multiplePages() {
  const connection = await grasp.launchBrowser({
    timeout: 3600000,
  });

  const browser = await chromium.connectOverCDP(connection.wsUrl, {
    timeout: 150000,
  });

  // 为隔离创建多个上下文
  const context1 = await browser.newContext();
  const context2 = await browser.newContext();

  // 不同上下文中的页面
  const page1 = await context1.newPage();
  const page2 = await context2.newPage();

  // 导航到不同的站点
  await Promise.all([
    page1.goto('https://example.com'),
    page2.goto('https://httpbin.org/json')
  ]);

  // 截图
  await Promise.all([
    page1.screenshot({ path: 'example.png' }),
    page2.screenshot({ path: 'httpbin.png' })
  ]);

  // 清理
  await context1.close();
  await context2.close();
  await browser.close();
}

import grasp from '@grasplabs/grasp';
import { chromium } from 'playwright';

async function withErrorHandling() {
  let browser;
  
  try {
    const connection = await grasp.launchBrowser({
      timeout: 3600000,
    });

    browser = await chromium.connectOverCDP(connection.wsUrl, {
      timeout: 150000,
    });

    const page = await browser.newPage();
    await page.goto('https://example.com');
    
    // 您的自动化代码
    
  } catch (error) {
    console.error('浏览器自动化过程中出错:', error);
    throw error;
  } finally {
    // 始终清理资源
    if (browser) {
      await browser.close();
    }
  }
}