Playwright mobile proxy setup

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

# One -sid- per browser context. Parallel workers need distinct sids.

import { chromium } from 'playwright';

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

const browser = await chromium.launch({
  proxy: {
    // Host and port ONLY. Credentials do not go in this string.
    server: `http://${url.host}`,
    username: decodeURIComponent(url.username),
    password: decodeURIComponent(url.password),
  },
});

const page = await browser.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body'));   // your carrier exit IP

await browser.close();

decodeURIComponent matters: the username contains hyphenated tokens and the key may be percent-encoded.

import { chromium } from 'playwright';

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

function proxyForSession(sid) {
  return {
    server: `http://${base.host}`,
    username: decodeURIComponent(base.username).replace(/-sid-[a-z0-9_]+/, `-sid-${sid}`),
    password: decodeURIComponent(base.password),
  };
}

// Launch once; give each context its own device via its own sid.
const browser = await chromium.launch();

const sids = ['job-a', 'job-b', 'job-c'];
const contexts = await Promise.all(
  sids.map((sid) => browser.newContext({ proxy: proxyForSession(sid) })),
);

for (const [i, ctx] of contexts.entries()) {
  const page = await ctx.newPage();
  await page.goto('https://api.ipify.org?format=json');
  console.log(sids[i], await page.textContent('body'));
}

await browser.close();

One context per session is the right mental model: contexts isolate cookies and storage, sids isolate devices.

const context = await browser.newContext({ proxy: proxyForSession('job-a') });

// You pay per gigabyte, so do not download what you will not assert on.
await context.route('**/*', (route) => {
  const type = route.request().resourceType();
  if (['image', 'media', 'font', 'stylesheet'].includes(type)) {
    return route.abort();
  }
  return route.continue();
});

const page = await context.newPage();
await page.goto('https://target.example/product/123', { waitUntil: 'domcontentloaded' });
console.log(await page.textContent('[data-testid="price"]'));

Drop stylesheet from the list if you assert on computed layout or take screenshots.