@angular/cdk/testing

LocatorFactory

인터페이스

엘리먼트와 컴포넌트 하네스를 찾는 비동기 로케이터 함수를 생성하는 인터페이스입니다. ComponentHarness 작성자는 이 인터페이스를 사용해 자신의 ComponentHarness 하위 클래스에 필요한 로케이터 함수를 만듭니다.

API

    
      interface LocatorFactory {}

documentRootLocatorFactory

LocatorFactory

문서 루트를 기준으로 하는 로케이터 팩토리를 가져옵니다.

@returnsLocatorFactory

rootElement

TestElement

TestElement로 표현한 이 LocatorFactory의 루트 엘리먼트입니다.

locatorFor

() => Promise<LocatorFnResult<T>>

이 LocatorFactory의 루트 엘리먼트 아래에서 ComponentHarness 인스턴스나 엘리먼트를 찾는 데 사용할 비동기 로케이터 함수를 생성합니다.

예를 들어 다음 DOM이 있고 DivHarness.hostSelector가 'div'라고 가정하면:

<div id="d1"></div><div id="d2"></div>

다음과 같은 결과가 나옵니다:

await lf.locatorFor(DivHarness, 'div')() // Gets a `DivHarness` instance for #d1
await lf.locatorFor('div', DivHarness)() // Gets a `TestElement` instance for #d1
await lf.locatorFor('span')()            // Throws because the `Promise` rejects

@paramqueriesT

검색할 하네스와 엘리먼트를 지정하는 쿼리 목록입니다:

string은 문자열로 지정한 CSS 선택자와 일치하는 엘리먼트를 검색합니다.
ComponentHarness 생성자는 주어진 클래스와 일치하는 ComponentHarness 인스턴스를 검색합니다.
HarnessPredicate는 주어진 조건자와 일치하는 ComponentHarness 인스턴스를 검색합니다.

@returns() => Promise<LocatorFnResult<T>>

locatorForOptional

() => Promise<LocatorFnResult<T> | null>

이 LocatorFactory의 루트 엘리먼트 아래에서 ComponentHarness 인스턴스나 엘리먼트를 찾는 데 사용할 비동기 로케이터 함수를 생성합니다.

예를 들어 다음 DOM이 있고 DivHarness.hostSelector가 'div'라고 가정하면:

<div id="d1"></div><div id="d2"></div>

다음과 같은 결과가 나옵니다:

await lf.locatorForOptional(DivHarness, 'div')() // Gets a `DivHarness` instance for #d1
await lf.locatorForOptional('div', DivHarness)() // Gets a `TestElement` instance for #d1
await lf.locatorForOptional('span')()            // Gets `null`

@paramqueriesT

검색할 하네스와 엘리먼트를 지정하는 쿼리 목록입니다:

string은 문자열로 지정한 CSS 선택자와 일치하는 엘리먼트를 검색합니다.
ComponentHarness 생성자는 주어진 클래스와 일치하는 ComponentHarness 인스턴스를 검색합니다.
HarnessPredicate는 주어진 조건자와 일치하는 ComponentHarness 인스턴스를 검색합니다.

@returns() => Promise<LocatorFnResult<T> | null>

locatorForAll

() => Promise<LocatorFnResult<T>[]>

이 LocatorFactory의 루트 엘리먼트 아래에서 ComponentHarness 인스턴스들이나 엘리먼트들을 찾는 데 사용할 비동기 로케이터 함수를 생성합니다.

예를 들어 다음 DOM이 있고 DivHarness.hostSelector가 'div'이며 IdIsD1Harness.hostSelector가 '#d1'라고 가정하면:

<div id="d1"></div><div id="d2"></div>

다음과 같은 결과가 나옵니다:

// Gets [DivHarness for #d1, TestElement for #d1, DivHarness for #d2, TestElement for #d2]
await lf.locatorForAll(DivHarness, 'div')()
// Gets [TestElement for #d1, TestElement for #d2]
await lf.locatorForAll('div', '#d1')()
// Gets [DivHarness for #d1, IdIsD1Harness for #d1, DivHarness for #d2]
await lf.locatorForAll(DivHarness, IdIsD1Harness)()
// Gets []
await lf.locatorForAll('span')()