activitypub-testing

此技能為 WordPress ActivityPub 外掛提供了一套標準化的測試框架，重點在於透過 PHPUnit 進行後端單元測試，以及使用 Playwright 進行前端端對端測試。它專為開發聯合社交網路功能的工程師設計，特別是那些實作 ActivityPub 協定、轉換器與處理器的開發者。透過使用此技能，您可以確保測試套件的一致性、縮短除錯時間，並為複雜的網路依賴功能維持高程式碼覆蓋率。

• 整合 WordPress 的 PHPUnit 測試結構，包含 WP_UnitTestCase 的設定、清除與功能測試。

• 提供 Playwright 樣板，用於端對端測試 ActivityPub 設定頁面與 WebFinger 發現工作流程。

• 包含使用 @group activitypub 與 @group federation 等註解進行測試分組的標準化文件。

• 提供如何利用測試資料工廠在 WordPress 環境內建立模擬使用者、文章與評論的指引。

• 透過針對單元測試、端對端測試與 JS 專屬測試套件的自訂指令，促進高效的測試執行。

• 請務必參考儲存庫中提供的測試參考路徑 (../../../tests/README.md) 來初始化測試環境。

• 使用提供的除錯模式，例如結合 var_dump 或 error_log 與 --verbose 和 --debug 旗標，以有效隔離失敗的測試。

• 在執行 npm run env-test 時，使用 --filter 或 --stop-on-failure 參數來隔離大型測試套件中的特定邏輯。

• 優先考慮使用建議的測試工具來模擬外部 HTTP 要求，以保持測試的確定性與效能。

• 請務必確認您的本機環境設定（特別是 Playwright），因為基於瀏覽器的測試需要一個正在執行的 WordPress 實例與正確的資料庫設定。