如何在Cucumber报告中嵌入Base64格式的测试截图？

现有写法的问题 #

• 第二种写法的媒体类型参数错误：image/png:base64是Cucumber 4.x及更早版本的旧用法，6.9.1版本已废弃该格式，媒体类型只需填image/png即可
• 6.9.1版本配合net.masterthought cucumber-reporting 5.6.1时，直接传Base64字符串存在概率性不兼容问题，优先使用字节数组传参更稳定

正确实现代码 #

方案1：字节数组传参（推荐，兼容性最好） #

import io.cucumber.java.Scenario;
import org.openqa.selenium.OutputType;
import org.openqa.selenium.TakesScreenshot;
import org.openqa.selenium.WebDriver;

// 以下代码放在@After钩子中执行
final byte[] screenshotBytes = ((TakesScreenshot) driver).getScreenshotAs(OutputType.BYTES);
// 三个参数分别是：截图内容、媒体类型、截图展示名称
scenario.attach(screenshotBytes, "image/png", "测试执行截图");

方案2：Base64字符串传参 #

final String base64Screenshot = ((TakesScreenshot) driver).getScreenshotAs(OutputType.BASE64);
// 无需手动添加data:image/png;base64前缀，Cucumber会自动处理编码
scenario.attach(base64Screenshot, "image/png", "测试执行截图");

额外注意事项 #

• 需确保scenario是io.cucumber.java.Scenario类型的实例，通过@Before/@After钩子的入参注入，不能用静态变量跨场景复用
• 截图名称不要包含/:*?"<>|等特殊字符，避免报告渲染异常
• 不需要额外修改cucumber-reporting的生成配置，5.6.1版本原生支持上述两种写法的截图渲染

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