使用NgNeat Spectator测试独立Pipe报错的解决方法咨询

将原本正常运行的NgNeat测试，在给TimeAgoPipe标记为独立组件（添加standalone: true）后失效，报错信息如下：

Error: Unexpected "TimeAgoPipe" found in the "declarations" array of the "DynamicTestModule" NgModule, "TimeAgoPipe" is marked as standalone and can't be declared in any NgModule - did you intend to import it instead (by adding it to the "imports" array)?

修改后的Pipe代码：

@Pipe({
  name: 'timeAgo',
  standalone: true  // 新增配置
})
export class TimeAgoPipe implements PipeTransform {
  // 管道实现代码...
}

测试代码片段：

describe('TimeAgoPipe', () => {
  let spectator: SpectatorPipe<TimeAgoPipe>;
  
  const createPipe = createPipeFactory({
    pipe: TimeAgoPipe,
    providers: [ 
       // 依赖提供者
    ],
  });

  // 其他测试用例..
}

已知createComponentFactory有declareComponent: false配置可解决独立组件的类似测试问题，但查阅NgNeat官方文档未找到独立Pipe的相关测试说明，需了解Pipe对应的等效配置及报错解决方法。

针对独立管道的测试，NgNeat Spectator的createPipeFactory提供了和declareComponent: false等效的declarePipe: false配置，结合imports数组导入独立管道即可解决报错，具体修改如下：

describe('TimeAgoPipe', () => {
  let spectator: SpectatorPipe<TimeAgoPipe>;
  
  const createPipe = createPipeFactory({
    pipe: TimeAgoPipe,
    declarePipe: false, // 阻止Spectator自动将管道加入模块的declarations数组
    imports: [TimeAgoPipe], // 将独立管道作为依赖导入
    providers: [ 
       // 依赖提供者
    ],
  });

  // 其他测试用例..
}

原理说明 #

• 默认情况下，createPipeFactory会自动将指定的pipe加入测试模块的declarations数组，但独立组件/管道不允许被声明在NgModule中，只能通过imports导入。
• declarePipe: false会关闭自动声明管道的行为，避免触发独立管道不能被声明的错误。
• 将TimeAgoPipe加入imports数组，符合Angular对独立管道的使用规范，测试模块就能正确识别并使用该管道。

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