@fedify/testing

中文文档
2.1.32发布于 2026/11/17MITTypeScriptESM + CJS构建来源已验证近 30 天下载 1.5万

Testing utilities for Fedify applications

原始使用文档
文档目录6 节
  1. Installation
  2. Usage
  3. MockFederation
  4. MockContext
  5. Helper functions
  6. Features

@fedify/testing

Testing utilities for Fedify applications.

This package provides mock implementations of the Federation and Context interfaces to facilitate unit testing of federated applications built with Fedify.

Installation

deno add @fedify/testing
npm install @fedify/testing
pnpm add @fedify/testing
yarn add @fedify/testing

Usage

MockFederation

The MockFederation class provides a mock implementation of the Federation interface for unit testing:

import { MockFederation } from "@fedify/testing";
import { Create } from "@fedify/vocab";

// Create a mock federation
const federation = new MockFederation<{ userId: string }>();

// Set up inbox listeners
federation
  .setInboxListeners("/users/{identifier}/inbox")
  .on(Create, async (ctx, activity) => {
    console.log("Received:", activity);
  });

// Simulate receiving an activity
await federation.receiveActivity(createActivity);

// Check sent activities
const sent = federation.sentActivities;
console.log(sent[0].activity);

MockContext

The MockContext class provides a mock implementation of the Context interface:

import { MockContext } from "@fedify/testing";

// Create a mock context
const context = new MockContext({
  url: new URL("https://example.com"),
  data: { userId: "test-user" },
  federation: mockFederation
});

// Send an activity
await context.sendActivity(
  { identifier: "alice" },
  recipient,
  activity
);

// Check sent activities
const sent = context.getSentActivities();
console.log(sent[0].activity);

Helper functions

The package also exports helper functions for creating various context types:

  • createContext(): Creates a basic context
  • createRequestContext(): Creates a request context
  • createInboxContext(): Creates an inbox context

Features

  • Track sent activities with metadata
  • Simulate activity reception
  • Configure custom URI templates
  • Test queue-based activity processing
  • Mock document loaders and context loaders

版本与发布记录

@fedify/testing 共发布 894 个版本,首次发布于 2025/07/26;过去 12 个月发布了 599 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.1.32latest2026/11/17今天
2.0.362026/11/17今天
2.3.16-dev.28452026/11/17今天
2.5.0-dev.28442026/11/17今天
2.0.36-dev.28432026/11/17今天
2.3.16-dev.28412026/11/17今天

其他发布通道:pr-405 → 1.9.0-pr.405.1518,pr-421 → 1.9.0-pr.421.1747,pr-474 → 2.0.0-pr.474.1879,pr-478 → 2.0.0-pr.478.1918,pr-479 → 2.0.0-pr.479.1922,pr-490 → 2.0.0-pr.490.2。

关于 @fedify/testing 的常见问题

@fedify/testing 是什么?

Testing utilities for Fedify applications

如何安装 @fedify/testing?

在项目目录运行 npm install @fedify/testing,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@fedify/fedify(^2.1.32)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@fedify/testing 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fedify/testing 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@fedify/testing 可以商用吗?

@fedify/testing 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fedify/testing 的下载量有多少?

根据 npm 官方下载统计,@fedify/testing 在 2026/10/15 – 2026/11/13 这 30 天内被下载 15,269 次,日均约 509 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fedify/testing 还在维护吗?

最新版本 2.1.32 发布于 2026/11/17(今天);至今共发布 894 个版本,其中过去 12 个月发布了 599 个;首次发布于 2025/07/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。