allow users to specify location of button click

Author: mmalerba

src/material-experimental/mdc-button/testing/button-harness.ts

@@ -37,9 +37,18 @@ export class MatButtonHarness extends ComponentHarness {
             (harness, text) => HarnessPredicate.stringMatches(harness.getText(), text));
   }
 
+  /**
+   * Clicks the button at the given position relative to its top-left.
+   * @param relativeX The relative x position of the click.
+   * @param relativeY The relative y position of the click.
+   */
+  click(relativeX: number, relativeY: number): Promise<void>;
+  /** Clicks the button at its center. */
+  click(location: 'center'): Promise<void>;
   /** Clicks the button. */
-  async click(): Promise<void> {
-    return (await this.host()).click();
+  click(): Promise<void>;
+  async click(...args: ['center'] | [number, number]): Promise<void> {
+    return (await this.host()).click(...(args as [any]));
   }
 
   /** Gets a boolean promise indicating if the button is disabled. */

src/material/button/testing/button-harness.ts

@@ -37,9 +37,18 @@ export class MatButtonHarness extends ComponentHarness {
             (harness, text) => HarnessPredicate.stringMatches(harness.getText(), text));
   }
 
+  /**
+   * Clicks the button at the given position relative to its top-left.
+   * @param relativeX The relative x position of the click.
+   * @param relativeY The relative y position of the click.
+   */
+  click(relativeX: number, relativeY: number): Promise<void>;
+  /** Clicks the button at its center. */
+  click(location: 'center'): Promise<void>;
   /** Clicks the button. */
-  async click(): Promise<void> {
-    return (await this.host()).click();
+  click(): Promise<void>;
+  async click(...args: ['center'] | [number, number]): Promise<void> {
+    return (await this.host()).click(...(args as [any]));
   }
 
   /** Whether the button is disabled. */

tools/public_api_guard/material/button/testing.d.ts

@@ -4,6 +4,8 @@ export interface ButtonHarnessFilters extends BaseHarnessFilters {
 
 export declare class MatButtonHarness extends ComponentHarness {
     blur(): Promise<void>;
+    click(relativeX: number, relativeY: number): Promise<void>;
+    click(location: 'center'): Promise<void>;
     click(): Promise<void>;
     focus(): Promise<void>;
     getText(): Promise<string>;