如何在Playwright单个测试用例中设置Accept-Language请求头

核心原因：Accept-Language是浏览器上下文初始化时根据内置语言配置自动生成的默认头，上下文创建完成后再通过setExtraHTTPHeaders()设置的头优先级低于浏览器默认生成值，无法覆盖，因此直接在默认注入的page/context实例上修改头的方式无效。
可通过以下两种方案实现单测试用例粒度的Accept-Language配置，不需要修改全局设置：

方案一：块级配置（适合固定配置的单测试/测试组） #

通过test.describe包裹需要特殊语言配置的测试用例，在块内调用test.use()指定配置，配置仅对块内测试生效，不会影响块外其他用例，不需要手动管理上下文、页面实例的生命周期，写法最简洁。

import { test, expect } from '@playwright/test';

test.describe('德语场景验证', () => {
  // 仅当前块内的测试会使用该配置
  test.use({
    // 同步配置navigator.language等前端JS可读取的语言属性
    locale: 'de-DE',
    extraHTTPHeaders: {
      'Accept-Language': 'de-DE,de;q=0.9,en;q=0.8'
    }
  });

  test('language is interpreted correctly', async function({ page }) {
    const response = await page.goto('http://example.com');
    const acceptLanguageHeader = await response.request().headerValue('Accept-Language');
    expect(acceptLanguageHeader).toBe('de-DE,de;q=0.9,en;q=0.8');
    // 写入依赖语言配置的业务断言
  });
});

// 块外测试不受影响，沿用全局默认语言配置
test('默认语言场景测试', async ({ page }) => {
  // 默认语言逻辑
});

方案二：动态创建上下文（适合运行时动态决定语言配置的场景） #

如果需要在测试执行过程中动态切换语言，或者不想新增describe块，可以直接从测试fixtures中获取browser实例，在test函数内部手动初始化浏览器上下文，初始化时传入语言头配置即可。该方式灵活度最高，配置完全作用于当前test内创建的资源，不会对其他测试造成任何影响。

import { test, expect } from '@playwright/test';

test('language is interpreted correctly', async function({ browser }) {
  // 初始化上下文时直接传入配置，后续生成的page会自动携带指定头
  const context = await browser.newContext({
    locale: 'de-DE',
    extraHTTPHeaders: {
      'Accept-Language': 'de-DE,de;q=0.9,en;q=0.8'
    }
  });
  const page = await context.newPage();

  const response = await page.goto('http://example.com');
  const acceptLanguageHeader = await response.request().headerValue('Accept-Language');
  expect(acceptLanguageHeader).toBe('de-DE,de;q=0.9,en;q=0.8');
  // 写入依赖语言配置的业务断言

  // 测试结束后关闭手动创建的上下文
  await context.close();
});

注意：手动创建的上下文必须在测试结束后调用close()方法关闭，避免浏览器进程资源泄漏。

已验证的无效方案说明 #

• 对框架默认注入的、已经初始化完成的context/page实例调用setExtraHTTPHeaders()设置Accept-Language：优先级低于浏览器默认生成的头，不会生效。该方法仅对自定义的非默认头有效。
• 修改全局配置（配置文件、全局test.use()设置）：所有测试用例都会继承该配置，无法满足单用例差异化验证多语言场景的需求。
• 仅设置extraHTTPHeaders不配置locale：会出现请求头Accept-Language和页面内JS读取的navigator.language值不一致的问题，可能导致前端多语言逻辑判断异常。

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