@@ -44,12 +44,12 @@ matches the harness class to instances of the component in the DOM. Beyond that,
44
44
given harness is specific to its corresponding component; refer to the component's documentation to
45
45
learn how to use a specific harness.
46
46
47
- #### Using ` TestbedHarnessEnvironment ` and ` ProtractorHarnessEnvironment `
47
+ #### Using ` TestbedHarnessEnvironment ` and ` SeleniumWebDriverHarnessEnvironment `
48
48
49
49
These classes correspond to different implementations of the component harness system with bindings
50
50
for specific test environments. Any given test must only import _ one_ of these classes. Karma-based
51
- unit tests should use the ` TestbedHarnessEnvironment ` , while Protractor -based end-to-end tests
52
- should use the ` ProtractorHarnessEnvironment ` . Additional environments require custom bindings; see
51
+ unit tests should use the ` TestbedHarnessEnvironment ` , while Selenium WebDriver -based end-to-end tests
52
+ should use the ` SeleniumWebDriverHarnessEnvironment ` . Additional environments require custom bindings; see
53
53
[ API for harness environment authors] ( #api-for-harness-environment-authors ) for more information on
54
54
alternate test environments.
55
55
@@ -107,13 +107,13 @@ it('loads harnesses', async () => {
107
107
});
108
108
```
109
109
110
- ` ProtractorHarnessEnvironment ` has an API that offers a single static method:
110
+ ` SeleniumWebDriverHarnessEnvironment ` has an API that offers a single static method:
111
111
112
112
| Method | Description |
113
113
| ------ | ----------- |
114
114
| ` loader(): HarnessLoader ` | Gets a ` HarnessLoader ` instance for the current HTML document, rooted at the document's root element. |
115
115
116
- Since Protractor does not deal with fixtures, the API in this environment is simpler. The
116
+ Since Selenium WebDriver does not deal with fixtures, the API in this environment is simpler. The
117
117
` HarnessLoader ` returned by the ` loader() ` method should be sufficient for loading all necessary
118
118
` ComponentHarness ` instances.
119
119
@@ -304,7 +304,7 @@ The functions created with the locator methods described above all return `TestE
304
304
| ` dispatchEvent(name: string, data?: Record<string, EventData>): Promise<void>; ` | Dispatches an event with a particular name. |
305
305
306
306
` TestElement ` is an abstraction designed to work across different test environments (Karma,
307
- Protractor , etc). When using harnesses, you should perform all DOM interaction via this interface.
307
+ Selenium WebDriver , etc). When using harnesses, you should perform all DOM interaction via this interface.
308
308
Other means of accessing DOM elements (e.g. ` document.querySelector ` ) will not work in all test
309
309
environments.
310
310
@@ -574,7 +574,7 @@ may need to explicitly wait for tasks outside `NgZone`, as this does not happen
574
574
575
575
Harness environment authors are developers who want to add support for using component harnesses in
576
576
additional testing environments. Out-of-the-box, Angular CDK's component harnesses can be used in
577
- Protractor E2E tests and Karma unit tests. Developers can support additional environments by
577
+ Selenium WebDriver E2E tests and Karma unit tests. Developers can support additional environments by
578
578
creating custom implementations of ` TestElement ` and ` HarnessEnvironment ` .
579
579
580
580
#### Creating a ` TestElement ` implementation for the environment
@@ -583,7 +583,7 @@ The first step in adding support for a new testing environment is to create a `T
583
583
implementation. The ` TestElement ` interface serves as an environment-agnostic representation of a
584
584
DOM element; it lets harnesses interact with DOM elements regardless of the underlying environment.
585
585
Because some environments don't support interacting with DOM elements synchronously
586
- (e.g. webdriver ), all of the ` TestElement ` methods are asynchronous, returning a ` Promise ` with the
586
+ (e.g. WebDriver ), all of the ` TestElement ` methods are asynchronous, returning a ` Promise ` with the
587
587
result of the operation.
588
588
589
589
| Method | Description |
@@ -616,7 +616,7 @@ maintain a mapping from `TestKey` codes to the codes used in the particular test
616
616
The
617
617
[ ` UnitTestElement ` ] ( https://github.com/angular/components/blob/master/src/cdk/testing/testbed/unit-test-element.ts#L57 )
618
618
and
619
- [ ` ProtractorElement ` ] ( https://github.com/angular/components/blob/master/src/cdk/testing/protractor/protractor- element.ts#L67 )
619
+ [ ` SeleniumWebDriverElement ` ] ( https://github.com/angular/components/blob/master/src/cdk/testing/selenium-webdriver/selenium-web-driver- element.ts#L22 )
620
620
implementations in Angular CDK serve as good examples of implementations of this interface.
621
621
622
622
#### Creating a ` HarnessEnvironemnt ` implementation for the environment
@@ -654,7 +654,7 @@ require arguments to be passed. (e.g. the `loader` method on `TestbedHarnessEnvi
654
654
The
655
655
[ ` TestbedHarnessEnvironment ` ] ( https://github.com/angular/components/blob/master/src/cdk/testing/testbed/testbed-harness-environment.ts#L20 )
656
656
and
657
- [ ` ProtractorHarnessEnvironment ` ] ( https://github.com/angular/components/blob/master/src/cdk/testing/protractor/protractor- harness-environment.ts#L16 )
657
+ [ ` SeleniumWebDriverHarnessEnvironment ` ] ( https://github.com/angular/components/blob/master/src/cdk/testing/selenium-webdriver/selenium-web-driver- harness-environment.ts#L71 )
658
658
implementations in Angular CDK serve as good examples of implementations of this interface.
659
659
660
660
#### Handling auto change detection status
0 commit comments