test(button-harness): add performance tests for buttons using the protractor harness env

* The main thing we are looking at here is not the button's performance. Instead we are looking at
  the performance overhead of using the protractor and testbed harness env.
* We are running tests with & without the ProtractorHarnessEnvironment and with & without the
  TestbedHarnessEnvironment.
* We are benchmarking 5 operations with a varying number of buttons:
  1. Get the first button
  2. Click the first button
  3. Click the middle button
  4. Click the last button
  5. Click every button

Author: wagnermaciel

test/benchmarks/material/button-harness/BUILD.bazel

@@ -0,0 +1,26 @@
+load("@npm_angular_dev_infra_private//benchmark/component_benchmark:component_benchmark.bzl", "component_benchmark")
+load("//tools:defaults.bzl", "ng_e2e_test_library", "ng_test_library", "ng_web_test_suite", "ts_library")
+
+# TODO(wagnermaciel): Update this target to provide indigo-pink in a way that doesn't require having to import it with
+# stylesUrls inside the components once `component_benchmark` supports asset injection.
+
+component_benchmark(
+    name = "benchmark",
+    driver = ":protractor.perf-spec.ts",
+    driver_deps = [
+        "@npm//@angular/dev-infra-private",
+        "@npm//protractor",
+        "@npm//@types/jasmine",
+        "//src/cdk/testing",
+        "//src/material/button/testing",
+        "//src/cdk/testing/protractor",
+    ],
+    ng_deps = [
+        "@npm//@angular/core",
+        "@npm//@angular/platform-browser",
+        "//src/material/button",
+    ],
+    ng_srcs = [":app.module.ts"],
+    prefix = "",
+    styles = ["//src/material/prebuilt-themes:indigo-pink"],
+)

test/benchmarks/material/button-harness/app.module.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {Component, NgModule, ViewEncapsulation} from '@angular/core';
+import {BrowserModule} from '@angular/platform-browser';
+import {MatButtonModule} from '@angular/material/button';
+
+/** component: mat-raised-button-harness-test */
+
+@Component({
+	selector: 'app-root',
+  template: `
+    <button *ngFor="let val of vals" mat-button> {{ val }} </button>
+	`,
+	encapsulation: ViewEncapsulation.None,
+  styleUrls: ['//src/material/core/theming/prebuilt/indigo-pink.css'],
+})
+export class ButtonHarnessTest {
+	vals = Array.from({ length: 100 }, (_, i) => i);
+}
+
+@NgModule({
+  declarations: [ButtonHarnessTest],
+  imports: [
+    BrowserModule,
+    MatButtonModule,
+  ],
+  bootstrap: [ButtonHarnessTest],
+})
+export class AppModule {}

test/benchmarks/material/button-harness/protractor.perf-spec.ts

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {HarnessLoader} from '@angular/cdk/testing';
+import {MatButtonHarness} from '@angular/material/button/testing/button-harness';
+import {runBenchmark} from '@angular/dev-infra-private/benchmark/driver-utilities';
+import {ProtractorHarnessEnvironment} from '@angular/cdk/testing/protractor';
+
+let loader: HarnessLoader;
+
+describe('perf test for basic protractor harness', () => {
+	it('should load the protractor harness environment', async () => {
+		await runBenchmark({
+			id: 'initial-harness-load',
+			url: '',
+			ignoreBrowserSynchronization: true,
+			params: [],
+			work: () => { loader = ProtractorHarnessEnvironment.loader(); },
+		});
+	});
+
+	it('should retrieve all of the buttons', async () => {
+		await runBenchmark({
+			id: 'get-first-button',
+			url: '',
+			ignoreBrowserSynchronization: true,
+			params: [],
+			setup: () => { loader = ProtractorHarnessEnvironment.loader(); },
+			work: async () => await loader.getAllHarnesses(MatButtonHarness),
+		});
+	});
+
+	it('should retrieve the first button', async () => {
+		await runBenchmark({
+			id: 'get-first-button',
+			url: '',
+			ignoreBrowserSynchronization: true,
+			params: [],
+			setup: () => { loader = ProtractorHarnessEnvironment.loader(); },
+			work: async () => await (await loader.getHarness(MatButtonHarness.with({text: '0'}))).click(),
+		});
+	});
+
+	it('should retrieve the middle button', async () => {
+		await runBenchmark({
+			id: 'get-middle-button',
+			url: '',
+			ignoreBrowserSynchronization: true,
+			params: [],
+			setup: () => { loader = ProtractorHarnessEnvironment.loader(); },
+			work: async () => await (await loader.getHarness(MatButtonHarness.with({text: '49'}))).click(),
+		});
+	});
+
+	it('should retrieve the last button', async () => {
+		await runBenchmark({
+			id: 'get-last-button',
+			url: '',
+			ignoreBrowserSynchronization: true,
+			params: [],
+			setup: () => { loader = ProtractorHarnessEnvironment.loader(); },
+			work: async () => await (await loader.getHarness(MatButtonHarness.with({text: '99'}))).click(),
+		});
+	});
+});