/** * @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.dev/license */ import {ComponentHarnessConstructor, HarnessPredicate} from '@angular/cdk/testing'; import {MatListHarnessBase} from './list-harness-base'; import {NavListHarnessFilters, NavListItemHarnessFilters} from './list-harness-filters'; import {getListItemPredicate, MatListItemHarnessBase} from './list-item-harness-base'; /** Harness for interacting with a mat-nav-list in tests. */ export class MatNavListHarness extends MatListHarnessBase< typeof MatNavListItemHarness, MatNavListItemHarness, NavListItemHarnessFilters > { /** The selector for the host element of a `MatNavList` instance. */ static hostSelector = '.mat-mdc-nav-list'; /** * Gets a `HarnessPredicate` that can be used to search for a nav list with specific * attributes. * @param options Options for filtering which nav list instances are considered a match. * @return a `HarnessPredicate` configured with the given options. */ static with( this: ComponentHarnessConstructor, options: NavListHarnessFilters = {}, ): HarnessPredicate { return new HarnessPredicate(this, options); } override _itemHarness = MatNavListItemHarness; } /** Harness for interacting with a nav-list item. */ export class MatNavListItemHarness extends MatListItemHarnessBase { /** The selector for the host element of a `MatListItem` instance. */ static hostSelector = `${MatNavListHarness.hostSelector} .mat-mdc-list-item`; /** * Gets a `HarnessPredicate` that can be used to search for a nav list item with specific * attributes. * @param options Options for filtering which nav list item instances are considered a match. * @return a `HarnessPredicate` configured with the given options. */ static with( this: ComponentHarnessConstructor, options: NavListItemHarnessFilters = {}, ): HarnessPredicate { return getListItemPredicate(this, options) .addOption('href', options.href, async (harness, href) => HarnessPredicate.stringMatches(harness.getHref(), href), ) .addOption( 'activated', options.activated, async (harness, activated) => (await harness.isActivated()) === activated, ); } /** Gets the href for this nav list item. */ async getHref(): Promise { return (await this.host()).getAttribute('href'); } /** Clicks on the nav list item. */ async click(): Promise { return (await this.host()).click(); } /** Focuses the nav list item. */ async focus(): Promise { return (await this.host()).focus(); } /** Blurs the nav list item. */ async blur(): Promise { return (await this.host()).blur(); } /** Whether the nav list item is focused. */ async isFocused(): Promise { return (await this.host()).isFocused(); } /** Whether the list item is activated. Should only be used for nav list items. */ async isActivated(): Promise { return (await this.host()).hasClass('mdc-list-item--activated'); } }