feat(material/list): add test harnesses for list components.

Author: mmalerba

src/cdk/testing/component-harness.ts

@@ -406,16 +406,23 @@ export class HarnessPredicate<T extends ComponentHarness> {
   }
 
   /**
-   * Checks if a string matches the given pattern.
-   * @param s The string to check, or a Promise for the string to check.
-   * @param pattern The pattern the string is expected to match. If `pattern` is a string, `s` is
-   *   expected to match exactly. If `pattern` is a regex, a partial match is allowed.
-   * @return A Promise that resolves to whether the string matches the pattern.
+   * Checks if the specified nullable string value matches the given pattern.
+   * @param value The nullable string value to check, or a Promise resolving to the
+   *   nullable string value.
+   * @param pattern The pattern the value is expected to match. If `pattern` is a string,
+   *   `value` is expected to match exactly. If `pattern` is a regex, a partial match is
+   *   allowed. If `pattern` is `null`, the value is expected to be `null`.
+   * @return A Promise that resolves to whether the value matches the pattern.
    */
-  static async stringMatches(s: string | Promise<string>, pattern: string | RegExp):
-      Promise<boolean> {
-    s = await s;
-    return typeof pattern === 'string' ? s === pattern : pattern.test(s);
+  static async stringMatches(value: string | null | Promise<string | null>,
+                             pattern: string | RegExp | null): Promise<boolean> {
+    value = await value;
+    if (pattern === null) {
+      return value === null;
+    } else if (value === null) {
+      return false;
+    }
+    return typeof pattern === 'string' ? value === pattern : pattern.test(value);
   }
 
   /**

src/material/config.bzl

@@ -15,12 +15,14 @@ entryPoints = [
     "dialog",
     "dialog/testing",
     "divider",
+    "divider/testing",
     "expansion",
     "form-field",
     "grid-list",
     "icon",
     "input",
     "list",
+    "list/testing",
     "menu",
     "menu/testing",
     "paginator",

src/material/divider/testing/BUILD.bazel

@@ -0,0 +1,20 @@
+package(default_visibility = ["//visibility:public"])
+
+load("//tools:defaults.bzl", "ng_test_library", "ng_web_test_suite", "ts_library")
+
+ts_library(
+    name = "testing",
+    srcs = glob(
+        ["**/*.ts"],
+        exclude = ["**/*.spec.ts"],
+    ),
+    module_name = "@angular/material/divider/testing",
+    deps = [
+        "//src/cdk/testing",
+    ],
+)
+
+filegroup(
+    name = "source-files",
+    srcs = glob(["**/*.ts"]),
+)

src/material/divider/testing/divider-harness-filters.ts

@@ -0,0 +1,12 @@
+/**
+ * @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 {BaseHarnessFilters} from '@angular/cdk/testing';
+
+export interface DividerHarnessFilters extends BaseHarnessFilters {
+}

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

@@ -0,0 +1,31 @@
+/**
+ * @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 {ComponentHarness, HarnessPredicate} from '@angular/cdk/testing';
+import {DividerHarnessFilters} from './divider-harness-filters';
+
+/**
+ * Harness for interacting with a `mat-divider`.
+ * @dynamic
+ */
+export class MatDividerHarness extends ComponentHarness {
+  static hostSelector = 'mat-divider';
+
+  static with(options: DividerHarnessFilters = {}) {
+    return new HarnessPredicate(MatDividerHarness, options);
+  }
+
+  async getOrientation(): Promise<'horizontal' | 'vertical'> {
+    return (await this.host()).getAttribute('aria-orientation') as
+        Promise<'horizontal' | 'vertical'>;
+  }
+
+  async isInset(): Promise<boolean> {
+    return (await this.host()).hasClass('mat-divider-inset');
+  }
+}

src/material/divider/testing/index.ts

@@ -0,0 +1,9 @@
+/**
+ * @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
+ */
+
+export * from './public-api';

src/material/divider/testing/public-api.ts

@@ -0,0 +1,10 @@
+/**
+ * @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
+ */
+
+export * from './divider-harness';
+export * from './divider-harness-filters';

src/material/list/testing/BUILD.bazel

@@ -0,0 +1,54 @@
+package(default_visibility = ["//visibility:public"])
+
+load("//tools:defaults.bzl", "ng_test_library", "ng_web_test_suite", "ts_library")
+
+ts_library(
+    name = "testing",
+    srcs = glob(
+        ["**/*.ts"],
+        exclude = ["**/*.spec.ts"],
+    ),
+    module_name = "@angular/material/list/testing",
+    deps = [
+        "//src/cdk/coercion",
+        "//src/cdk/testing",
+        "//src/material/divider/testing",
+    ],
+)
+
+filegroup(
+    name = "source-files",
+    srcs = glob(["**/*.ts"]),
+)
+
+ng_test_library(
+    name = "harness_tests_lib",
+    srcs = ["shared.spec.ts"],
+    deps = [
+        ":testing",
+        "//src/cdk/testing",
+        "//src/cdk/testing/testbed",
+        "//src/material/divider/testing",
+        "//src/material/list",
+        "@npm//@angular/platform-browser",
+    ],
+)
+
+ng_test_library(
+    name = "unit_tests_lib",
+    srcs = glob(
+        ["**/*.spec.ts"],
+        exclude = ["shared.spec.ts"],
+    ),
+    deps = [
+        ":harness_tests_lib",
+        ":testing",
+        "//src/material/divider/testing",
+        "//src/material/list",
+    ],
+)
+
+ng_web_test_suite(
+    name = "unit_tests",
+    deps = [":unit_tests_lib"],
+)

src/material/list/testing/index.ts

@@ -0,0 +1,9 @@
+/**
+ * @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
+ */
+
+export * from './public-api';

src/material/list/testing/list-harness-filters.ts

@@ -0,0 +1,37 @@
+/**
+ * @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 {BaseHarnessFilters} from '@angular/cdk/testing';
+
+export interface ListHarnessFilters extends BaseHarnessFilters {}
+
+export interface ActionListHarnessFilters extends BaseHarnessFilters {}
+
+export interface NavListHarnessFilters extends BaseHarnessFilters {}
+
+export interface SelectionListHarnessFilters extends BaseHarnessFilters {}
+
+export interface BaseListItemHarnessFilters extends BaseHarnessFilters {
+  text?: string | RegExp;
+}
+
+export interface ListItemHarnessFilters extends BaseListItemHarnessFilters {}
+
+export interface ActionListItemHarnessFilters extends BaseListItemHarnessFilters {}
+
+export interface NavListItemHarnessFilters extends BaseListItemHarnessFilters {
+  href?: string | RegExp | null;
+}
+
+export interface ListOptionHarnessFilters extends BaseListItemHarnessFilters {
+  selected?: boolean;
+}
+
+export interface SubheaderHarnessFilters extends BaseHarnessFilters {
+  text?: string | RegExp;
+}

src/material/list/testing/list-harness.spec.ts

@@ -0,0 +1,16 @@
+import {MatDividerHarness} from '@angular/material/divider/testing';
+import {MatListModule} from '@angular/material/list';
+import {
+  MatActionListHarness,
+  MatListHarness,
+  MatNavListHarness,
+  MatSelectionListHarness
+} from './list-harness';
+import {MatListItemHarnessBase, MatSubheaderHarness} from './list-item-harness';
+import {runHarnessTests} from './shared.spec';
+
+describe('Non-MDC-based list harnesses', () => {
+  runHarnessTests(
+      MatListModule, MatListHarness, MatActionListHarness, MatNavListHarness,
+      MatSelectionListHarness, MatListItemHarnessBase, MatSubheaderHarness, MatDividerHarness);
+});