Script Mode

Infinite Scroll Scraping

Collect every item from a lazy-loaded feed:

await page.goto('https://example.com/feed');

let items = [];
let previousHeight = 0;

while (true) {
const newItems = await page.$$eval('.feed-item', els =>
  els.map(el => ({
    title: el.querySelector('h3')?.textContent?.trim(),
    url: el.querySelector('a')?.href,
    date: el.querySelector('time')?.getAttribute('datetime')
  }))
);

items = [...new Map(
  [...items, ...newItems].map(i => [i.url, i])
).values()];

await page.evaluate(() => window.scrollTo(0, document.body.scrollHeight));
await page.waitForTimeout(2000);

const currentHeight = await page.evaluate(() => document.body.scrollHeight);
if (currentHeight === previousHeight) break;
previousHeight = currentHeight;
}

await saveJson('feed-items', items);
await saveScreenshot('feed-bottom');

Try doing that with JSON steps.

Multi-Viewport Responsive Testing

Test a page across every breakpoint in one job:

const viewports = [
{ name: 'mobile',  width: 375,  height: 812 },
{ name: 'tablet',  width: 768,  height: 1024 },
{ name: 'laptop',  width: 1366, height: 768 },
{ name: 'desktop', width: 1920, height: 1080 },
];

for (const vp of viewports) {
await page.setViewportSize({ width: vp.width, height: vp.height });
await page.goto('https://example.com', { waitUntil: 'networkidle' });
await saveScreenshot(`responsive-${vp.name}`);
}

Four screenshots, four viewports, one job, one API call.

Complex Login with 2FA Handling

Handle multi-step authentication flows with conditionals:

await page.goto('https://app.example.com/login');

await page.fill('#email', 'user@example.com');
await page.fill('#password', 'your-password');
await page.click('button[type="submit"]');

// Handle email verification if it appears
try {
await page.waitForSelector('#verification-input', { timeout: 5000 });
// Prompt appeared — fill the code you received
await page.fill('#verification-input', '123456');
await page.click('#verify-btn');
} catch {
// No verification prompt — already through
}

await page.waitForSelector('.dashboard', { timeout: 10000 });
await saveScreenshot('authenticated-dashboard');

Steps mode can't branch. Script mode can.

Data Extraction + Screenshots in One Job

Scrape a product catalog and screenshot each page:

await page.goto('https://store.example.com/products');

const products = [];
let pageNum = 1;

while (true) {
const pageProducts = await page.$$eval('.product-card', cards =>
  cards.map(card => ({
    name: card.querySelector('.name')?.textContent?.trim(),
    price: card.querySelector('.price')?.textContent?.trim(),
    sku: card.dataset.sku,
    inStock: !card.classList.contains('out-of-stock')
  }))
);

products.push(...pageProducts);
await saveScreenshot(`catalog-page-${pageNum}`);

const nextBtn = await page.$('a.next-page:not(.disabled)');
if (!nextBtn) break;

await nextBtn.click();
await page.waitForLoadState('networkidle');
pageNum++;
}

await saveJson('full-catalog', { total: products.length, products });

Multi-page crawl, structured data extraction, and visual proof—all in one job.

Popup and New Window Handling

Capture OAuth popups or payment windows:

await page.goto('https://app.example.com');

const popup = await waitForWindow(() =>
page.click('#google-signin-btn')
);

await popup.fill('input[type="email"]', 'user@gmail.com');
await popup.click('#next');
await saveScreenshot('oauth-popup');