仅安装Playwright无配置文件，能否在测试外使用toHaveScreenshot等方法？

不行，toHaveScreenshot() 和 toMatchSnapshot() 是Playwright测试断言库的专属方法，必须在测试框架提供的测试上下文（比如Playwright Test、Jest等的测试函数内部）中调用，这和是否使用配置文件、仅通过npm install playwright安装依赖无关。

报错原因 #

你直接在普通Node.js脚本中调用page.toHaveScreenshot()，但该方法依赖测试框架注入的断言上下文来处理快照存储、对比逻辑和结果上报，脱离测试上下文调用就会触发报错：

toHaveScreenshot() must be called during the test

替代方案：在普通脚本中实现快照对比 #

如果不想依赖测试框架，你可以用Playwright原生的page.screenshot()方法获取截图，再结合第三方图片对比库（比如pixelmatch）手动实现快照对比，示例如下：

1. 先安装必要依赖：

npm install pixelmatch pngjs

2. 修改代码：

const { chromium } = require("playwright");
const fs = require("fs");
const { PNG } = require("pngjs");
const pixelmatch = require("pixelmatch");

const example = async () => {
  const browser = await chromium.launch({ headless: false });
  const page = await browser.newPage();
  await page.goto("https://zversal.com/");

  // 获取当前页面截图
  const currentScreenshot = await page.screenshot({
    fullPage: false
  });

  // 读取已有的快照文件
  const snapshotBuffer = fs.readFileSync("zeversal.png");

  // 解析PNG图片数据
  const currentImg = PNG.sync.read(currentScreenshot);
  const snapshotImg = PNG.sync.read(snapshotBuffer);

  // 先校验图片尺寸是否一致
  if (currentImg.width !== snapshotImg.width || currentImg.height !== snapshotImg.height) {
    console.error("错误：当前截图与快照尺寸不匹配");
    await browser.close();
    return;
  }

  // 计算像素差异
  const diffImg = new PNG({ width: currentImg.width, height: currentImg.height });
  const mismatchedPixelCount = pixelmatch(
    currentImg.data,
    snapshotImg.data,
    diffImg.data,
    currentImg.width,
    currentImg.height,
    { threshold: 0.24 } // 对应原代码的maxDiffPixelRatio参数
  );

  // 输出对比结果
  if (mismatchedPixelCount > 0) {
    console.log(`检测到${mismatchedPixelCount}个差异像素`);
    // 可选：保存差异可视化图片
    fs.writeFileSync("diff.png", PNG.sync.write(diffImg));
  } else {
    console.log("当前截图与快照完全一致");
  }

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

这个方案完全脱离测试上下文，仅依赖Playwright核心库和第三方图片处理工具，就能实现和toHaveScreenshot()类似的快照对比效果。

内容的提问来源于stack exchange，提问作者Dinesh Kumar Giri