Spectacular 15.0.0

[LayZeeDK]

15.0.0 (2023-08-08)

Features

• SpectacularAppComponent is a standalone Angular component (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• Passing InjectOptions to SpectacularApplicationHarness#inject is supported (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• Passing InjectOptions to SpectacularFeatureHarness#inject is supported (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• Passing InjectOptions to SpectacularPipeHarnes#inject is supported (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• provideSpectacularFeatureTest requires a routes option and optionally accepts the withInitialFeatureNavigation feature and Angular Router features (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)
• provideSpectacularFeatureTest returns (EnvironmentProviders | Provider)[] (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)
• provideSpectacularFeatureTest is marked as deprecated and a copy is renamed to provideSpectacularFeatureTesting (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)
• Add withInitialFeatureNavigation for use with provideSpectacularFeatureTest and provideSpectacularFeatureTesting (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)
• SpectacularFeatureTestingModule is deprecated (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)

BREAKING CHANGES

• Require Angular 15.0
• SpectacularAppComponent is a standalone Angular component. Your tests might need to take this into account depending on your setup. Most tests shouldn't need to change. (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• A routes option must be passed to provideSpectacularFeatureTest. (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)
• provideSpectacularFeatureTest returns (EnvironmentProviders | Provider)[] (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)

Migration

Feature test using Angular Testing Library

Before:

await render(SpectacularAppComponent, {
  excludeComponentDeclaration: true,
  imports: [
    SpectacularFeatureTestingModule.withFeature({
      featurePath: crisisCenterPath,
      routes: [
        { path: crisisCenterPath, loadChildren: () => CrisisCenterModule },
      ],
    }),
  ],
});

After:

await render(SpectacularAppComponent, {
  providers: [
    provideSpectacularFeatureTesting({
      featurePath: crisisCenterPath,
      routes: [
        { path: crisisCenterPath, loadChildren: () => CrisisCenterModule },
      ],
    }),
  ],
});

DEPRECATIONS

• Passing InjectFlags to SpectacularApplicationHarness#inject is deprecated in favor of passing InjectOptions (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• Passing InjectFlags to SpectacularFeatureHarness#inject is deprecated in favor of passing InjectOptions (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• Passing InjectFlags to SpectacularPipeHarnes#inject is deprecated in favor of passing InjectOptions (feat(spectacular)!: release 15.0.0-alpha.0 #68)
• provideSpectacularFeatureTest is to be removed in Spectacular version 16. Migrate to provideSpectacularFeatureTesting. (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)
• SpectacularFeatureTestingModule is to be removed in Spectacular version 16. Migrate to provideSpectacularFeatureTesting. (feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest #76)

Migration

InjectFlags to InjectOptions

Before:

const ngZone = harness.inject(NgZone, InjectFlags.Optional);

After:

const ngZone = harness.inject(NgZone, {
  optional: true,
});

---

This discussion was created from the release Spectacular 15.0.0.

[LayZeeDK]

As part of version 15.0, the Feature testing API documentation has received an overhaul. The feature testing guide has been improved, simplified, and a Recipes section has been added with recipes for using either the Spectacular feature harness or Angular Testing Library.

[LayZeeDK]

The Pipe testing API got support for standalone pipes in Spectacular 14.1. However, an internal change in Angular meant that while standalone pipe testing worked with Spectacular 14.1 and Angular 15.0, you need Spectacular 15.0 with Angular 15.1-15.2. Always match your major version of Spectacular with your major version of Angular if possible.