You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

如何在Playwright安装时排除ffmpeg,仅使用系统预安装的ffmpeg进行测试录屏

如何在Playwright安装时排除ffmpeg,仅使用系统预安装的ffmpeg进行测试录屏

嘿,这个需求我之前刚好折腾过,给你分享几个落地性拉满的方法,完美解决你的问题👇

一、安装Playwright时避免下载自带的ffmpeg

Playwright自带的ffmpeg是和官方浏览器二进制文件绑定分发的,所以要跳过它的下载,主要有两种实用思路:

1. 安装核心包,直接用系统浏览器

这种方式完全绕开Playwright自带的浏览器(以及附带的ffmpeg),全程使用你本地已安装的浏览器:

  • 先安装Playwright核心包(不含浏览器二进制):
# npm 命令
npm install playwright-core

# yarn 命令
yarn add playwright-core

# pnpm 命令
pnpm add playwright-core
  • 代码里指定系统浏览器路径(或留空让Playwright自动检测):
const { chromium } = require('playwright-core');
(async () => {
  // 启动系统中的Chrome,路径替换成你本地的浏览器路径
  const browser = await chromium.launch({
    executablePath: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
    // 也可以直接留空,Playwright会自动扫描系统中的浏览器
  });
  // 后续测试逻辑...
})();

这种方式安装过程完全不碰ffmpeg,完美满足你“排除ffmpeg安装”的要求。

2. 保留官方浏览器,但跳过二进制下载

如果你想继续用Playwright官方维护的浏览器版本,但不想下载自带的ffmpeg,可以通过环境变量跳过浏览器二进制包的下载:

  • 安装前设置环境变量:
# Linux/macOS 终端
export PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
npm install playwright

# Windows PowerShell
$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
npm install playwright

注意:这种方式需要你自行确保系统中有对应版本的浏览器,或者后续手动指定浏览器路径,否则Playwright会报错找不到浏览器。

二、仅当系统预安装ffmpeg时启用录屏

接下来实现“只有PATH里有ffmpeg时才触发录屏”的需求,核心是先检测再动态配置:

1. 先检测系统中的ffmpeg是否可用

用Node.js的child_process做个简单的存在性检测:

const { execSync } = require('child_process');

function isFFmpegAvailable() {
  try {
    // 执行ffmpeg版本命令,无报错则说明PATH中存在
    execSync('ffmpeg -version', { stdio: 'ignore' });
    return true;
  } catch (err) {
    // 执行失败说明ffmpeg不可用
    return false;
  }
}

2. 动态配置录屏选项

在启动浏览器上下文时,根据检测结果动态开启视频录制,同时强制使用系统的ffmpeg:

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

(async () => {
  const canRecordVideo = isFFmpegAvailable();
  
  const browser = await chromium.launch();
  // 只有ffmpeg可用时才添加录屏配置
  const contextOptions = canRecordVideo ? {
    video: {
      mode: 'retain-on-failure', // 按需设置录屏模式:'on' 全程录,'retain-on-failure' 仅失败时保留
      ffmpegPath: 'ffmpeg' // 因为在PATH中,直接写命令名即可
    }
  } : {};

  const context = await browser.newContext(contextOptions);
  // 后续测试逻辑...
  const page = await context.newPage();
  await page.goto('https://example.com');

  await browser.close();
})();

3. 全局配置(针对Playwright Test框架)

如果你用的是@playwright/test,可以在配置文件里全局设置:

const { defineConfig, devices } = require('@playwright/test');
const { execSync } = require('child_process');

function isFFmpegAvailable() {
  try {
    execSync('ffmpeg -version', { stdio: 'ignore' });
    return true;
  } catch (err) {
    return false;
  }
}

module.exports = defineConfig({
  use: {
    // 仅当ffmpeg可用时开启录屏
    ...(isFFmpegAvailable() && {
      video: 'retain-on-failure',
      ffmpegPath: 'ffmpeg'
    })
  },
  // 其他框架配置...
});

额外小提示

  • 如果你怕Playwright偷偷用自带的ffmpeg,可以手动删除它安装目录下的ffmpeg文件(比如node_modules/playwright-core/.local-browsers/chromium-xxx/chrome-linux64/ffmpeg),不过用上面的方法其实完全没必要。
  • 建议系统中的ffmpeg用4.x以上版本,太老的版本可能会出现录屏格式不兼容的问题。

亲测这些方法都能完美解决你的需求,有问题随时问我😉

火山引擎 最新活动