How to specify browser language in Puppeteer

Question

I would like to launch a Google Chrome browser with language Spanish es using Puppeteer.

I've tried puppeteer.launch(args:['--lang=es',...],...) but it didn't work.

I've tried passing the environment variable LANGUAGE=es mocha puppeteer-test.js but it didn't work.

I've tried using the userDataDir option and passing a folder with a Preferences file a { "intl": { "accept_languages": "es" } } but the browser Settings - Languages still don't show Spanish and neither does window.navigator.languages neither window.navigator.language

I'm using
Puppeteer 0.11.0
Node 8.4.0
NPM 5.2.0
macOS El Capitan 10.11.6
MacBook Pro Retina, 15-inch, Mid 2015

Is passing language arguments works when starting Chromium browser from the terminal? — Dejan Toteff, Nov 08 '17 at 19:36
I have the same problem, "window.navigator" is undefined in Puppeteer's headless Chromium, even when using the --lang switch. — Bruno, Nov 10 '17 at 14:46

Md. Abu Taher · Accepted Answer · 2020-09-25T04:23:46.323

67

There are several ways to change locale, you can try all of them to find what works for you,

Use Args when launching

const browser = await puppeteer.launch({
    headless: false,
    args: ['--lang=bn-BD,bn']
});

Send the language as Header

await page.setExtraHTTPHeaders({
    'Accept-Language': 'bn'
});

Forcefully set the language

// Set the language forcefully on javascript
await page.evaluateOnNewDocument(() => {
    Object.defineProperty(navigator, "language", {
        get: function() {
            return "bn-BD";
        }
    });
    Object.defineProperty(navigator, "languages", {
        get: function() {
            return ["bn-BD", "bn"];
        }
    });
});

For the sake of testing, I'll test this in multiple languages, including es, and here is the result.

Google search:

BrowserLeaks:

edited Sep 25 '20 at 04:23

answered Nov 14 '17 at 17:38

Md. Abu Taher

17,395
5
49
73

3

Mind you, that `args` solution doesnt work on mac os – avalanche1 Feb 10 '20 at 22:33
Is there another way for mac OS X? – Aaron Jun 03 '20 at 07:40
At [Chromium issue 755338](https://bugs.chromium.org/p/chromium/issues/detail?id=755338#c13) they write that setting environment variable `LANG` should work as well on Linux. Nothing like that for Windows though, it seems... – Petr Bodnár Mar 27 '21 at 15:23
Neither of them worked for me – Srushti Shah Jun 15 '23 at 06:14

score 7 · Answer 2 · answered Nov 29 '19 at 11:08

There's an error in Md-Abu-Taher's answer.

The response to navigator.language should return a string, not an array. Try it in your own browser console.

The code snippet should be:

await page.evaluateOnNewDocument(() => {
    Object.defineProperty(navigator, "language", {
        get: function() {
            return "en-GB";
        }
    });
    Object.defineProperty(navigator, "languages", {
        get: function() {
            return ["en-GB", "en"];
        }
    });
});

Thank you for pointing that out, I've updated my answer. – Md. Abu Taher Sep 25 '20 at 04:23 — Md. Abu Taher, Sep 25 '20 at 04:23

score 3 · Answer 3 · answered Feb 24 '22 at 16:23

3

On Chrome Linux, you can do

puppeteer.launch({ ...yourParams, env: { LANGUAGE: "fr_FR" } })

I don't know for the others OS/browsers ...

answered Feb 24 '22 at 16:23

devside

2,171
1
19
23