useragent.md

polyfill.userAgent

Change the browser's user agent.

Options

This plugin supports the following option:

• userAgent: User agent value.

Examples

Use the plugin and specify a Chrome user agent on Windows.

import { chromium } from "playwright-ghost";
import plugins from "playwright-ghost/plugins";

const browser = await chromium.launch({
  plugins: [
    plugins.polyfill.userAgent({
      userAgent:
        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML," +
        " like Gecko) Chrome/134.0.0.0 Safari/537.36",
    }),
  ],
});
// ...

Use the plugin and specify the current Chromium user agent without "Headless".

import { chromium } from "playwright-ghost";
import plugins from "playwright-ghost/plugins";

const getUserAgent = async () => {
  const browser = await chromium.launch();
  const context = await browser.newContext();
  const page = await context.newPage();
  const userAgent = await page.evaluate("navigator.userAgent");
  await context.close();
  await browser.close();
  return userAgent.replace("Headless", "");
};

const browser = await chromium.launch({
  plugins: [
    plugins.polyfill.userAgent({
      userAgent: await getUserAgent(),
    }),
  ],
});
// ...

Advanced

Import

If you want to import only this plugin, you can use the "playwright-ghost/plugins/polyfill/useragent" path in the import.

import { chromium } from "playwright-ghost";
import polyfillUserAgentPlugin from "playwright-ghost/plugins/polyfill/useragent";

const browser = await chromium.launch({
  plugins: [
    polyfillUserAgentPlugin(
      "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like" +
        " Gecko) Chrome/138.0.7204.64 Mobile Safari/537.36",
    ),
  ],
});
// ...