Skip to content

Upgrading @angular/platform-browser-dynamic 16 to 17

Breaking16.2.12 → 17.3.12Breaking23Platform7Deprecated9New75Changed26Fixed321Other3

Full comparisonBack to @angular/platform-browser-dynamic
BreakingUpgrade verdict

19 breaking changes and 6 platform requirement changes.

In plain terms
  • The mutate method is gone; use update with immutable changes instead.
  • Two old compiler options that were already deprecated are gone.
  • The mutate function is no longer part of the public signals API.
  • The withNoDomReuse function has been removed from the API.
Must act Top 5 of 33 that need code or config changes

Node.js requirement changed in 17.0.0-rc.2: ^16.14.0 || >=18.10.0 → ^18.13.0 || >=20.9.0.

What you must change

Breaking19
Removes the mutate method from the WritableSignal interface and public API.
WritableSignalmutateupdate
17.0.0GitHub ReleaseSummarizedView source
Removes deprecated CompilerOptions.useJit and CompilerOptions.missingTranslation.
CompilerOptions.useJitCompilerOptions.missingTranslation
17.0.0GitHub ReleaseSummarizedView source
Drops the mutate function from the signals public API.
mutate
17.0.0GitHub ReleaseSummarizedView source
Removes the withNoDomReuse function.
withNoDomReuse
17.0.0GitHub ReleaseSummarizedView source
Removes urlHandlingStrategy from public Router properties.
RouterurlHandlingStrategy
17.0.0GitHub ReleaseSummarizedView source
Removes deprecated Router properties.
Router
17.0.0GitHub ReleaseSummarizedView source
Removes the deprecated setupTestingRouter function.
setupTestingRouter
17.0.0GitHub ReleaseSummarizedView source
Removes malformedUriErrorHandler from ExtraOptions.
ExtraOptionsmalformedUriErrorHandler
17.0.0GitHub ReleaseSummarizedView source
NgSwitch now defaults to the === equality operator instead of ==.
NgSwitch
17.0.0GitHub ReleaseSummarizedView source
REMOVE_STYLES_ON_COMPONENT_DESTROY now defaults to true, removing component CSS from the DOM on destroy.
REMOVE_STYLES_ON_COMPONENT_DESTROY
17.0.0GitHub ReleaseSummarizedView source
Removes the withNoDomReuse() function from the public API.
withNoDomReuse()provideClientHydration()ngSkipHydration
17.0.0GitHub ReleaseSummarizedView source
Absolute redirects no longer prevent further redirects, so route configs may need adjustment to avoid infinite redirects.
17.0.0GitHub ReleaseSummarizedView source
Routes with loadComponent no longer cause child routes to inherit parent data by default.
loadComponentparamsInheritanceStrategy
17.0.0GitHub ReleaseSummarizedView source
Removes urlHandlingStrategy from the Router public API; configure it via provideRouter or RouterModule.forRoot.
urlHandlingStrategyprovideRouterRouterModule.forRoot
17.0.0GitHub ReleaseSummarizedView source
Removes canceledNavigationResolution, paramsInheritanceStrategy, titleStrategy, urlUpdateStrategy and malformedUriErrorHandler from the Router public API.
canceledNavigationResolutionparamsInheritanceStrategytitleStrategyurlUpdateStrategymalformedUriErrorHandlerprovideRouterRouterModule.forRoot
17.0.0GitHub ReleaseSummarizedView source
malformedUriErrorHandler is no longer available in RouterModule.forRoot options; handle URL parse errors in UrlSerializer.parse.
malformedUriErrorHandlerRouterModule.forRootUrlSerializer.parse
17.0.0GitHub ReleaseSummarizedView source
Dynamically created OnPush components now refresh host bindings and run ngDoCheck only when dirty.
OnPushngDoCheckComponentRefmarkForCheckdetectChangesChangeDetectorRef
17.0.0GitHub ReleaseSummarizedView source
Removes the setupTestingRouter function; use RouterModule.forRoot or provideRouter to set up the Router for tests.
setupTestingRouterRouterModule.forRootprovideRouterRouter
17.0.0GitHub ReleaseSummarizedView source
Disallows deep and legacy zone.js dist/ imports; zone-testing-bundle and zone-testing-node-bundle are removed from the package.
zone.jszone.js/testingzone-testing-bundlezone-testing-node-bundle
17.0.0GitHub ReleaseSummarizedView source
Platform6
Adds support for TypeScript 5.4.
17.3.0GitHub ReleaseSummarizedView source
Removes support for Node.js v16.
17.0.0GitHub ReleaseSummarizedView source
Drops support for older TypeScript versions.
TypeScript
17.0.0GitHub ReleaseSummarizedView source
Supports TypeScript 5.2.
17.0.0GitHub ReleaseSummarizedView source
Removes Node.js v16 support and bumps the minimum to 18.13.0.
17.0.0GitHub ReleaseSummarizedView source
Versions of TypeScript older than 5.2 are no longer supported.
TypeScript
17.0.0GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated8
Deprecates AnimationDriver.NOOP.
AnimationDriver.NOOP
17.0.0GitHub ReleaseSummarizedView source
Deprecates swapping out the context object for EmbeddedViewRef and warns on the deprecated NgProbeToken.
EmbeddedViewRefObject.assignProxyNgTemplateOutletNgProbeToken
17.0.0GitHub ReleaseSummarizedView source
Deprecates ChangeDetectorRef.checkNoChanges.
ChangeDetectorRef.checkNoChanges
17.0.0GitHub ReleaseSummarizedView source
Deprecates allowing the full context object to be replaced in EmbeddedViewRef.
EmbeddedViewRef
17.0.0GitHub ReleaseSummarizedView source
Deprecates NgProbeToken.
NgProbeToken
17.0.0GitHub ReleaseSummarizedView source
Deprecates the AnimationDriver.NOOP symbol in favor of NoopAnimationDriver.
AnimationDriver.NOOPNoopAnimationDriver
17.0.0GitHub ReleaseSummarizedView source
Deprecates ChangeDetectorRef.checkNoChanges; tests should use ComponentFixture instead.
ChangeDetectorRef.checkNoChangesComponentFixtureChangeDetectorRef
17.0.0GitHub ReleaseSummarizedView source
Deprecates ChangeDetectorRef.checkNoChanges.
ChangeDetectorRef.checkNoChanges
17.0.0-rc.2GitHub ReleaseSummarizedView source