关于Playwright+WebKit生成salt文件的用途、清理及配置疑问

一、salt文件的用途 #

WebKit生成的salt文件是随机盐值文件，专门用来给浏览器的本地存储（包括localStorage、sessionStorage、IndexedDB等）生成唯一的隔离标识。核心作用是防止不同测试实例之间的存储数据互相干扰，确保每个测试的运行环境独立干净。

二、为什么WebKit不自动清理这个文件 #

Playwright测试结束后会默认清理浏览器上下文，但salt属于WebKit引擎层面的持久化配置文件，不在Playwright的上下文清理范围内。WebKit的设计逻辑是把它作为跨会话的持久化标识，默认保留的话，后续同环境的测试可以复用这个盐值，维持存储环境的一致性。

三、怎么调整生成规则（或避免生成在根目录） #

1. 指定自定义临时目录存储salt（推荐） #

通过Playwright的contextOptions配置，把WebKit的用户数据目录指向一个临时文件夹，这样salt就会生成在指定路径，测试结束后可以统一清理：

// playwright.config.js
module.exports = {
  use: {
    ...devices['Desktop Safari'],
    contextOptions: {
      userDataDir: './.webkit-temp-data' // 自定义临时目录，可任意命名
    }
  }
};

然后在全局钩子globalTeardown里自动删除这个临时目录：

// global-teardown.js
const fs = require('fs').promises;
const path = require('path');

module.exports = async () => {
  await fs.rm(path.join(__dirname, './.webkit-temp-data'), { recursive: true, force: true });
};

最后在配置文件中引入这个钩子：

module.exports = {
  globalTeardown: './global-teardown.js',
  // 其他原有配置...
};

2. 禁用持久化存储（谨慎使用） #

如果你的测试完全不需要本地存储功能，可以在上下文配置中禁用所有相关存储选项，WebKit大概率不会生成salt文件：

contextOptions: {
  storageState: null, // 清空存储状态
  serviceWorkers: 'block', // 阻止Service Worker创建
  permissions: [], // 移除所有存储相关权限
  extraHTTPHeaders: { 'Cache-Control': 'no-cache' } // 禁止缓存
}

注意：这种方案会影响依赖本地存储的测试场景，只有确认测试不需要相关功能时再用。

内容的提问来源于stack exchange，提问作者Владислав Козенок