自动化测试 / 系统课时
理解 BrowserContext
理解 BrowserContext
当自动化脚本需要在同一浏览器进程中保持多组会话彼此独立时,BrowserContext 就是最重要的隔离边界。它让不同页面拥有独立的 Cookie、缓存和站点存储,又避免为每个用户都启动一个新的浏览器进程。
学习目标
- 理解
Browser、BrowserContext与Page的包含关系。 - 说明不同上下文之间为什么不会共享 Cookie、缓存和
localStorage。 - 能创建两个上下文并用代码验证会话隔离。
BrowserContext 的隔离边界
一个 Browser 可以同时创建多个 BrowserContext,每个上下文都像一套独立的无痕浏览会话。通过 browser.newContext() 创建的上下文默认是非持久化的,关闭后不会把浏览数据写入用户配置目录。
Cookie 和网络缓存不会在不同上下文之间共享。localStorage、IndexedDB 等站点存储也属于各自的上下文;因此,即使两个页面访问完全相同的域名,只要它们分属不同上下文,就可以保持不同的登录态和前端状态。
同一上下文中的多个页面仍属于同一会话边界:对同一源而言,它们可以看到同一组 Cookie 和 localStorage。sessionStorage 更特殊,它按页面的顶级浏览上下文隔离,不能简单理解为“同一个 BrowserContext 内所有页面共享”。

用代码验证两个上下文互不共享
下面的示例不依赖外部网站。两个页面都拦截 http://example.test/ 并返回同一段 HTML,但只有第一个上下文写入 Cookie 和 localStorage。第二个上下文访问相同地址后仍应保持空状态。
const { chromium } = require('playwright');
async function main() {
const browser = await chromium.launch({ headless: true });
const aliceContext = await browser.newContext();
const guestContext = await browser.newContext();
const alicePage = await aliceContext.newPage();
const guestPage = await guestContext.newPage();
// 两个页面访问同一源,但响应由 Playwright 本地拦截,避免依赖公网。
for (const page of [alicePage, guestPage]) {
await page.route('http://example.test/', route =>
route.fulfill({ status: 200, contentType: 'text/html', body: '<h1>demo</h1>' })
);
}
// 只向 Alice 上下文写入会话状态。
await aliceContext.addCookies([
{ name: 'session', value: 'alice', url: 'http://example.test/' }
]);
await alicePage.goto('http://example.test/');
await alicePage.evaluate(() => localStorage.setItem('user', 'alice'));
await guestPage.goto('http://example.test/');
console.log('alice cookie:', await alicePage.evaluate(() => document.cookie));
console.log('alice localStorage:', await alicePage.evaluate(() => localStorage.getItem('user')));
console.log('guest cookie:', await guestPage.evaluate(() => document.cookie));
console.log('guest localStorage:', await guestPage.evaluate(() => localStorage.getItem('user')));
await aliceContext.close();
await guestContext.close();
await browser.close();
}
main();预期输出:
alice cookie: session=alice
alice localStorage: alice
guest cookie:
guest localStorage: null这组结果说明隔离发生在上下文层,而不是 URL 层。两个页面访问同一站点并不会自动共享状态;只有被放进同一个上下文,它们才处于同一组浏览器会话数据中。
页面共享与上下文共享不要混淆
如果在 aliceContext 中再创建一个页面,并访问相同源,那么它会读取到 Alice 的 Cookie 与 localStorage。这正是多标签页测试需要的行为,例如用户在主页面登录后,新打开的订单页仍然保持登录状态。
相反,把“新用户”仅仅实现成 context.newPage() 是错误的。新页面只是新的标签页,不是新的用户会话。要模拟另一个账号,应调用 browser.newContext(),再在新上下文中创建页面。
什么时候创建新上下文
需要隔离账号、权限、地区设置、设备参数或测试用例状态时,应创建新的 BrowserContext。Playwright Test 默认会为测试提供隔离的上下文,这也是测试之间不会自然串登录态的基础。
手动调用 browser.newContext() 时,应在使用结束后显式执行 context.close()。这样既能关闭该上下文中的页面,也能让录屏、HAR 等产物完整收尾;只有当多个页面确实代表同一个用户时,才应该把它们放在同一个上下文中。