在 WordPress 项目的开发和维护过程中，对生成的 HTML 代码进行测试至关重要。然而，由于 WordPress 的动态特性，生成的 HTML 经常包含一些时间敏感或者环境依赖的值，例如 nonce、URL 等。这些值在不同的运行环境中可能不同，导致传统的快照测试经常失败，即使代码逻辑本身没有问题。为了解决这个问题，lucatume/wp-snapshot-assertions 提供了一套专门针对 WordPress 的快照测试工具。
lucatume/wp-snapshot-assertions 基于 Spatie 的 phpunit-snapshot-assertions 包，专门为 WordPress 环境定制，它提供了一个 WPHtmlOutputDriver，可以帮助我们忽略 HTML 中那些时间敏感或者环境依赖的差异，从而使得快照测试更加稳定可靠。
安装
使用 Composer 安装非常简单：
composer require lucatume/wp-snaphot-assertions --dev
使用方法
以下是一个使用 WPHtmlOutputDriver 的例子：
use Spatie\Snapshots\MatchesSnapshots;
use tad\WP\Snapshots\WPHtmlOutputDriver;
class MySnapshotTest extends \Codeception\TestCase\WPTestCase {
use MatchesSnapshots;
/**
* Test snapshot for render
*/
public function test_snapshot_render() {
// from some environment variable
$currentWpUrl = getenv('WP_URL');
$snapshotUrl = 'http://wp.localhost';
$driver = new WPHtmlOutputDriver($currentWpUrl, $snapshotUrl);
$sut = new MyPluginHTMLRenderingClass();
// create a random post and return its post ID
$postId= $this->factory->post->create();
$renderedHtml = $sut->renderHtmlFor($postId);
$driver->setTolerableDifferences([$postId]);
$driver->setTolerableDifferencesPrefixes(['post_', 'post-']);
$driver->setTolerableDifferencesPostfixes(['-single', '-another-postfix']);
$this->assertMatchesSnapshot($renderedHtml, $driver);
}
}在这个例子中，我们首先创建了一个 WPHtmlOutputDriver 实例，并指定了当前 WordPress 的 URL 和快照 URL。然后，我们创建了一个随机的 post，并使用 MyPluginHTMLRenderingClass 渲染了 HTML。
为了忽略 post ID 带来的差异，我们使用了 setTolerableDifferences 方法，将 post ID 添加到可容忍的差异列表中。此外，我们还使用了 setTolerableDifferencesPrefixes 和 setTolerableDifferencesPostfixes 方法，指定了 post ID 的前缀和后缀，以便忽略更多由 post ID 引起的差异。
主要功能
-
时间敏感字段处理： 默认情况下，
WPHtmlOutputDriver会查找一些时间敏感的字段，例如_wpnonce，并忽略它们带来的差异。你可以使用setTimeDependentKeys方法自定义这些字段。 -
URL 替换：
WPHtmlOutputDriver会自动将快照 URL 替换为当前 WordPress 的 URL。你可以使用setUrlAttributes方法自定义需要替换的属性。 -
可容忍差异： 使用
setTolerableDifferences方法可以指定哪些值不应该触发快照测试失败。 -
可容忍差异前缀和后缀： 使用
setTolerableDifferencesPrefixes和setTolerableDifferencesPostfixes方法可以指定可容忍差异的前缀和后缀。 -
属性排除： 使用
setTimeDependentAttributes方法可以完全排除某些属性的比较。
优势
-
提高测试稳定性： 通过忽略时间敏感和环境依赖的差异，
lucatume/wp-snapshot-assertions可以提高 WordPress 代码的快照测试的稳定性。 -
简化测试代码：
WPHtmlOutputDriver提供了许多方便的方法，可以简化快照测试的代码。 -
易于集成：
lucatume/wp-snapshot-assertions可以轻松地集成到现有的 WordPress 项目中。
实际应用
lucatume/wp-snapshot-assertions 非常适合以下场景：
- 测试 WordPress 主题和插件生成的 HTML 输出。
- 测试 WordPress REST API 的响应。
- 测试 WordPress 管理界面的渲染。
通过使用 lucatume/wp-snapshot-assertions，我们可以更加自信地进行 WordPress 代码的修改和重构，因为我们可以通过快照测试来确保代码的输出没有发生意外的变化。
