如何为Playwright添加全局配置，让手动下载文件保留默认文件名？

你可以通过监听浏览器上下文的download事件，在文件完成下载后自动将其重命名为服务器返回的suggested_filename，实现全局覆盖效果。以下是基于官方示例修改的代码：

JavaScript/TypeScript 示例 #

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch({ headless: false });
  // 创建浏览器上下文，指定下载目录（可自定义路径）
  const context = await browser.newContext({
    downloadsPath: './downloads'
  });

  // 全局监听所有下载事件
  context.on('download', async (download) => {
    await download.waitForCompletion();
    // 获取服务器建议的文件名
    const suggestedName = download.suggestedFilename();
    // 构建目标保存路径
    const targetPath = `${context.options.downloadsPath}/${suggestedName}`;
    
    // 将临时GUID命名的文件重命名为建议文件名
    await download.saveAs(targetPath);
    console.log(`文件已保存为: ${targetPath}`);
  });

  const page = await context.newPage();
  await page.goto('你的目标页面URL');

  // 在此处手动操作页面触发下载即可，文件会自动按建议名保存
  // ... 手动交互逻辑 ...

  // 按需关闭浏览器
  // await browser.close();
})();

Python 示例 #

from playwright.sync_api import sync_playwright
import os

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False)
    # 创建上下文并指定下载目录
    context = browser.new_context(downloads_path="./downloads")

    # 全局处理下载事件
    def handle_download(download):
        download.wait_for_completion()
        suggested_name = download.suggested_filename
        target_path = os.path.join(context.options["downloads_path"], suggested_name)
        # 保存为建议文件名
        download.save_as(target_path)
        print(f"文件已保存为: {target_path}")

    context.on("download", handle_download)

    page = context.new_page()
    page.goto("你的目标页面URL")

    # 手动操作页面触发下载即可
    # ... 手动交互 ...

    # 按需关闭浏览器
    # browser.close()

核心说明 #

• 先通过downloadsPath（JS）或downloads_path（Python）指定固定下载目录，避免文件散存。
• 监听上下文级别的download事件，无论脚本触发还是手动触发的下载，都会触发该事件，实现全局生效。
• 利用download.suggestedFilename()获取服务器返回的默认文件名，通过saveAs方法替换掉Playwright自动生成的GUID命名文件。

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