feat(core): deprecate integration with the Web Tracing Framework (WTF) (

#30642)

DEPRECATION:

Angular previously has supported an integration with the Web Tracing
Framework (WTF) for performance testing of Angular applications. This
integration has not been maintained and likely does not work for the
majority of Angular applications today. As a result, we are deprecating
the integration in Angular version 8.

This deprecation covers the following public APIs:
* `WtfScopeFn`
* `wtfCreateScope`
* `wtfStartTimeRange`
* `wtfEndTimeRange`
* `wtfLeave`

FW-1338 #resolve

PR Close #30642

aio/content/guide/deprecations.md

@@ -101,6 +101,11 @@ Tip: In the [API reference section](api) of this doc site, deprecated APIs are i
 | [`Renderer`](api/core/Renderer) | [`Renderer2`](api/core/Renderer2) | v4 | none |
 | [`RootRenderer`](api/core/RootRenderer) | [`RendererFactory2`](api/core/RendererFactory2) | v4 | none |
 | [`ViewEncapsulation.Native`](api/core/ViewEncapsulation#Native) | [`ViewEncapsulation.ShadowDom`](api/core/ViewEncapsulation#ShadowDom) | v6 | Use the native encapsulation mechanism of the renderer. See [view.ts](https://github.com/angular/angular/blob/3e992e18ebf51d6036818f26c3d77b52d3ec48eb/packages/core/src/metadata/view.ts#L32).
+| [`WtfScopeFn`](api/core/WtfScopeFn) | none | v8 | See [Web Tracing Framework](#wtf) |
+| [`wtfCreateScope`](api/core/wtfCreateScope) | none | v8 | See [Web Tracing Framework](#wtf) |
+| [`wtfStartTimeRange`](api/core/wtfStartTimeRange) | none | v8 | See [Web Tracing Framework](#wtf) |
+| [`wtfEndTimeRange`](api/core/wtfEndTimeRange) | none | v8 | See [Web Tracing Framework](#wtf) |
+| [`wtfLeave`](api/core/wtfLeave) | none | v8 | See [Web Tracing Framework](#wtf) |
 
 
 {@a forms}
@@ -142,6 +147,12 @@ This section lists all of the currently-deprecated features, which includes temp
 
 
 
+{@a wtf}
+### Web Tracing Framework integration
+
+Angular previously has supported an integration with the Web Tracing Framework (WTF) for performance testing of Angular applications. This integration has not been maintained and likely does not work for the majority of Angular applications today. As a result, we are deprecating the integration in Angular version 8.
+
+
 {@a deep-component-style-selector}
 ### `/deep/`, `>>>` and `:ng-deep` component style selectors
 

packages/core/src/profile/profile.ts

@@ -49,6 +49,7 @@ function noopScope(arg0?: any, arg1?: any): any {
  * an exception is expected during normal execution while profiling.
  *
  * @publicApi
+ * @deprecated the Web Tracing Framework is no longer supported in Angular
  */
 export const wtfCreateScope: (signature: string, flags?: any) => WtfScopeFn =
     wtfEnabled ? createScope : (signature: string, flags?: any) => noopScope;
@@ -61,6 +62,7 @@ export const wtfCreateScope: (signature: string, flags?: any) => WtfScopeFn =
  *
  * Returns the `returnValue for easy chaining.
  * @publicApi
+ * @deprecated the Web Tracing Framework is no longer supported in Angular
  */
 export const wtfLeave: <T>(scope: any, returnValue?: T) => T =
     wtfEnabled ? leave : (s: any, r?: any) => r;
@@ -77,6 +79,7 @@ export const wtfLeave: <T>(scope: any, returnValue?: T) => T =
  *        });
  *     }
  * @publicApi
+ * @deprecated the Web Tracing Framework is no longer supported in Angular
  */
 export const wtfStartTimeRange: (rangeType: string, action: string) => any =
     wtfEnabled ? startTimeRange : (rangeType: string, action: string) => null;
@@ -86,5 +89,6 @@ export const wtfStartTimeRange: (rangeType: string, action: string) => any =
  * [range] is the return value from [wtfStartTimeRange] Async ranges only work if WTF has been
  * enabled.
  * @publicApi
+ * @deprecated the Web Tracing Framework is no longer supported in Angular
  */
 export const wtfEndTimeRange: (range: any) => void = wtfEnabled ? endTimeRange : (r: any) => null;

packages/core/src/profile/wtf_impl.ts

@@ -12,6 +12,7 @@ import {global} from '../util/global';
  * A scope function for the Web Tracing Framework (WTF).
  *
  * @publicApi
+ * @deprecated the Web Tracing Framework is no longer supported in Angular
  */
 export interface WtfScopeFn { (arg0?: any, arg1?: any): any; }
 

tools/public_api_guard/core/core.d.ts

@@ -1440,14 +1440,19 @@ export declare class WrappedValue {
     static wrap(value: any): WrappedValue;
 }
 
+/** @deprecated */
 export declare const wtfCreateScope: (signature: string, flags?: any) => WtfScopeFn;
 
+/** @deprecated */
 export declare const wtfEndTimeRange: (range: any) => void;
 
+/** @deprecated */
 export declare const wtfLeave: <T>(scope: any, returnValue?: T) => T;
 
+/** @deprecated */
 export interface WtfScopeFn {
     (arg0?: any, arg1?: any): any;
 }
 
+/** @deprecated */
 export declare const wtfStartTimeRange: (rangeType: string, action: string) => any;