Puppeteer mobile proxy setup

export PROXY_URL="http://USERNAME-mbl-us-sid-pptr01-rot-sticky:[email protected]:7000"

# One browser instance per session. Chrome applies the proxy flag
# process-wide, so a second identity means a second browser.

import puppeteer from 'puppeteer';

const url = new URL(process.env.PROXY_URL);

const browser = await puppeteer.launch({
  headless: 'new',
  args: [
    // Host and port ONLY — Chrome ignores credentials placed here.
    `--proxy-server=http://${url.host}`,
  ],
});

const page = await browser.newPage();

// This is the step that is missing from most examples.
await page.authenticate({
  username: decodeURIComponent(url.username),
  password: decodeURIComponent(url.password),
});

await page.goto('https://api.ipify.org?format=json', { waitUntil: 'domcontentloaded' });
console.log(await page.evaluate(() => document.body.innerText));

await browser.close();

page.authenticate is per page. Every new page or popup needs its own call — see below.

const creds = {
  username: decodeURIComponent(url.username),
  password: decodeURIComponent(url.password),
};

// Catch pages the site opens itself, which otherwise hit a 407 you never see.
browser.on('targetcreated', async (target) => {
  if (target.type() !== 'page') return;
  const p = await target.page();
  if (p) await p.authenticate(creds);
});

const page = await browser.newPage();
await page.authenticate(creds);

Without the targetcreated hook, a window.open on the target silently breaks the run.

await page.setRequestInterception(true);

page.on('request', (req) => {
  if (['image', 'media', 'font', 'stylesheet'].includes(req.resourceType())) {
    return req.abort();
  }
  return req.continue();
});

// Mobile viewport, so the site serves its mobile build to your mobile IP.
await page.setViewport({ width: 390, height: 844, isMobile: true, deviceScaleFactor: 3 });
await page.goto('https://target.example/product/123', { waitUntil: 'domcontentloaded' });

Interception must be enabled before goto, and every request needs exactly one abort or continue.