Python Playwright等待download事件超时如何延长等待时长

expect_download() 方法原生支持自定义超时参数，无需修改全局配置，即可单独为该次下载等待设置更长的超时时间，参数单位为毫秒，默认值30000ms（即30秒）。

具体修改方式 #

直接在调用page.expect_download()时传入timeout参数，参数值按实际业务的大文件处理最大耗时设置即可，示例设置为120000ms（2分钟）：

# timeout值可根据实际服务端处理耗时自行调整
with page.expect_download(timeout=120000) as download_info:
    # 如果Download按钮需要等服务端处理完成才会变为可点击状态，可给click操作也单独加超时
    page.locator("text=Download").click(timeout=120000)
download = download_info.value
path = download.path()
suggested_filename = file_out
download.save_as(suggested_filename)

补充说明 #

• 该配置仅对当前这一次下载等待逻辑生效，不会影响其他用例/场景的默认超时判断，避免正常场景出错时无意义的长时间等待。
• 如果服务端处理完成前Download按钮一直处于禁用/不存在状态，必须给click()方法也加上对应时长的超时配置，否则会在点击元素阶段就触发30秒默认超时报错，无法走到等待下载事件的逻辑。

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