JXBrowser的navigator.languages始终为空，如何正确设置该属性？

你遇到的这个问题并非JXBrowser的普遍Bug，而是大概率遗漏了针对Chromium语言环境的关键配置步骤。你之前设置的--lang=en启动参数和setAcceptLanguage("en-US")主要影响HTTP请求的Accept-Language头，并不会直接填充JavaScript环境中的navigator.languages属性。下面给你具体的解决思路和操作步骤：

1. 配置完整的Chromium启动语言参数 #

Chromium的--lang参数需要传入带区域的优先级语言列表，单一语言代码无法正确触发navigator.languages的赋值。比如你可以这样设置：

EngineOptions options = new EngineOptions.Builder(RenderingMode.HARDWARE_ACCELERATED)
        .addChromiumSwitches("--lang=en-US,en") // 优先使用美式英语，其次通用英语
        .build();
Engine engine = Engine.newInstance(options);

这个参数会告诉Chromium初始化时采用指定的语言优先级，从而让navigator.languages返回对应的数组。

2. 补充BrowserContext的语言偏好配置 #

除了启动参数，还可以通过JXBrowser的PreferencesAPI直接修改Chromium的用户级语言偏好，确保配置生效：

BrowserContext context = engine.newBrowserContext();
Preferences preferences = context.preferences();
// 设置语言优先级列表
preferences.putString("intl.accept_languages", "en-US,en");
// 保存配置使其生效
preferences.save();

这个操作会写入Chromium的用户配置文件，让navigator.languages读取到正确的语言数组。

3. 验证配置是否生效 #

你可以通过注入一段简单的JS代码来确认navigator.languages的值是否正确：

Browser browser = context.newBrowser();
browser.navigation().loadUrl("你的目标网站地址");
// 在控制台打印结果
browser.mainFrame().executeJavaScript("console.log('navigator.languages:', navigator.languages)");
// 或者直接获取返回值
Object languages = browser.mainFrame().executeJavaScript("navigator.languages");
System.out.println("当前navigator.languages值：" + languages);

临时替代方案：直接修改navigator.languages（若上述方法失效） #

如果因为JXBrowser版本限制或其他特殊原因无法通过配置解决，你可以在页面加载完成后通过JS注入直接覆盖该属性：

browser.mainFrame().addLoadListener(new LoadAdapter() {
    @Override
    public void onFinishLoadingFrame(FinishLoadingFrame event) {
        if (event.isMainFrame()) {
            // 重定义navigator.languages的取值逻辑
            event.frame().executeJavaScript("""
                Object.defineProperty(navigator, 'languages', {
                    get: () => ['en-US', 'en']
                });
                """);
        }
    }
});

这个方法属于临时 workaround，但能快速满足目标网站对navigator.languages的要求。

内容的提问来源于stack exchange，提问作者pythoniosIV