feat: deprecate detectChanges in favor of detectChangesOnRender (#340)

Author: timdeschryver

projects/testing-library/src/lib/models.ts

@@ -78,8 +78,25 @@ export interface RenderComponentOptions<ComponentType, Q extends Queries = typeo
    * const component = await render(AppComponent, {
    *  detectChanges: false
    * })
+   *
+   * @deprecated
+   * Use `detectChangesOnRender` instead
    */
   detectChanges?: boolean;
+  /**
+   * @description
+   * Invokes `detectChanges` after the component is rendered
+   *
+   * @default
+   * true
+   *
+   * @example
+   * const component = await render(AppComponent, {
+   *  detectChangesOnRender: false
+   * })
+   */
+  detectChangesOnRender?: boolean;
+
   /**
    * @description
    * A collection of components, directives and pipes needed to render the component, for example, nested components of the component.

projects/testing-library/src/lib/testing-library.ts

@@ -46,7 +46,8 @@ export async function render<SutType, WrapperType = SutType>(
 ): Promise<RenderResult<SutType>> {
   const { dom: domConfig, ...globalConfig } = getConfig();
   const {
-    detectChanges: detectChangesOnRender = true,
+    detectChanges: detectChangesDeprecated = true,
+    detectChangesOnRender: detectChangesOnRenderInput,
     declarations = [],
     imports = [],
     providers = [],
@@ -63,6 +64,8 @@ export async function render<SutType, WrapperType = SutType>(
     defaultImports = [],
   } = { ...globalConfig, ...renderOptions };
 
+  const detectChangesOnRender =
+    detectChangesOnRenderInput === undefined ? detectChangesDeprecated : detectChangesOnRenderInput;
   dtlConfigure({
     eventWrapper: (cb) => {
       const result = cb();