feat(cdk/testing): add optional excludes to TestElement text method

src/cdk/testing/dom-helpers.ts

@@ -0,0 +1,9 @@
+export function getTextWithExcludedElements(element: Element, excludeSelector: string) {
+  const clone = element.cloneNode(true) as Element;
+  const exclusions = clone.querySelectorAll(excludeSelector);
+  for (let i = 0; i < exclusions.length; i++) {
+    let child = exclusions[i];
+    child.parentNode?.removeChild(child);
+  }
+  return (clone.textContent || '').trim();
+}

src/cdk/testing/protractor/protractor-element.ts

@@ -6,8 +6,14 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import {ElementDimensions, ModifierKeys, TestElement, TestKey} from '@angular/cdk/testing';
+import {
+  ElementDimensions,
+  ModifierKeys,
+  TestElement,
+  TestKey
+} from '@angular/cdk/testing';
 import {browser, ElementFinder, Key} from 'protractor';
+import {getTextWithExcludedElements} from '@angular/cdk/testing/dom-helpers';
 
 /** Maps the `TestKey` constants to Protractor's `Key` constants. */
 const keyMap = {
@@ -129,7 +135,10 @@ export class ProtractorElement implements TestElement {
     return this.element.sendKeys(...keys);
   }
 
-  async text(): Promise<string> {
+  async text(options?: {exclude?: string}): Promise<string> {
+    if (options?.exclude) {
+      return browser.executeScript(getTextWithExcludedElements, this.element, options.exclude);
+    }
     return this.element.getText();
   }
 

src/cdk/testing/test-element.ts

@@ -101,8 +101,12 @@ export interface TestElement {
    */
   sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
 
-  /** Gets the text from the element. */
-  text(): Promise<string>;
+  /**
+   * Gets the text from the element.
+   * @param options Options that affect what text is included
+   *   exclude: A selector for elements whose text should be excluded from the result.
+   */
+  text(options?: {exclude?: string}): Promise<string>;
 
   /** Gets the value for the given attribute from the element. */
   getAttribute(name: string): Promise<string | null>;

src/cdk/testing/testbed/unit-test-element.ts

@@ -7,7 +7,12 @@
  */
 
 import * as keyCodes from '@angular/cdk/keycodes';
-import {ElementDimensions, ModifierKeys, TestElement, TestKey} from '@angular/cdk/testing';
+import {
+  ElementDimensions,
+  ModifierKeys,
+  TestElement,
+  TestKey
+} from '@angular/cdk/testing';
 import {
   clearElement,
   dispatchMouseEvent,
@@ -17,6 +22,7 @@ import {
   triggerFocus,
   typeInElement,
 } from './fake-events';
+import {getTextWithExcludedElements} from '@angular/cdk/testing/dom-helpers';
 
 /** Maps `TestKey` constants to the `keyCode` and `key` values used by native browser events. */
 const keyMap = {
@@ -126,8 +132,11 @@ export class UnitTestElement implements TestElement {
     await this._stabilize();
   }
 
-  async text(): Promise<string> {
+  async text(options?: {exclude?: string}): Promise<string> {
     await this._stabilize();
+    if (options?.exclude) {
+      return getTextWithExcludedElements(this.element, options.exclude);
+    }
     return (this.element.textContent || '').trim();
   }
 

src/cdk/testing/tests/cross-environment.spec.ts

@@ -412,6 +412,15 @@ export function crossEnvironmentSpecs(
       expect(await button.matchesSelector('button:disabled')).toBe(false);
     });
 
+
+    it('should get correct text excluding certain selectors', async () => {
+      const results = await harness.subcomponentAndSpecialHarnesses();
+      const subHarnessHost = await results[0].host();
+
+      expect(await subHarnessHost.text({exclude: 'h2'})).toBe('ProtractorTestBedOther');
+      expect(await subHarnessHost.text({exclude: 'li'})).toBe('List of test tools');
+    });
+
     it('should get TestElements and ComponentHarnesses', async () => {
       const results = await harness.subcomponentHarnessesAndElements();
       expect(results.length).toBe(5);

src/cdk/testing/tests/protractor.e2e.spec.ts

@@ -44,6 +44,14 @@ describe('ProtractorHarnessEnvironment', () => {
         const globalEl = await harness.globalEl();
         expect(await globalEl.text()).toBe('I am a sibling!');
       });
+
+      it('should get correct text excluding certain selectors', async () => {
+        const results = await harness.subcomponentAndSpecialHarnesses();
+        const subHarnessHost = await results[0].host();
+
+        expect(await subHarnessHost.text({exclude: 'h2'})).toBe('ProtractorTestBedOther');
+        expect(await subHarnessHost.text({exclude: 'li'})).toBe('List of test tools');
+      });
     });
 
     describe('shadow DOM interaction', () => {

tools/public_api_guard/cdk/testing.d.ts

@@ -40,6 +40,8 @@ export interface ElementDimensions {
     width: number;
 }
 
+export declare function getTextWithExcludedElements(element: Element, excludeSelector: string): string;
+
 export declare abstract class HarnessEnvironment<E> implements HarnessLoader, LocatorFactory {
     protected rawRootElement: E;
     rootElement: TestElement;
@@ -131,7 +133,9 @@ export interface TestElement {
     sendKeys(...keys: (string | TestKey)[]): Promise<void>;
     sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
     setInputValue?(value: string): Promise<void>;
-    text(): Promise<string>;
+    text(options?: {
+        exclude?: string;
+    }): Promise<string>;
 }
 
 export declare enum TestKey {

tools/public_api_guard/cdk/testing/protractor.d.ts

@@ -17,7 +17,9 @@ export declare class ProtractorElement implements TestElement {
     sendKeys(...keys: (string | TestKey)[]): Promise<void>;
     sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
     setInputValue(value: string): Promise<void>;
-    text(): Promise<string>;
+    text(options?: {
+        exclude?: string;
+    }): Promise<string>;
 }
 
 export declare class ProtractorHarnessEnvironment extends HarnessEnvironment<ElementFinder> {

tools/public_api_guard/cdk/testing/testbed.d.ts

@@ -34,5 +34,7 @@ export declare class UnitTestElement implements TestElement {
     sendKeys(...keys: (string | TestKey)[]): Promise<void>;
     sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
     setInputValue(value: string): Promise<void>;
-    text(): Promise<string>;
+    text(options?: {
+        exclude?: string;
+    }): Promise<string>;
 }