Skip to content

Commit 4c144cf

Browse files
authored
deprecated Protractor helper (#3756)
1 parent 3cfcc16 commit 4c144cf

22 files changed

+40
-1885
lines changed

.github/CONTRIBUTING.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ DEBUG=codeceptjs:* npx codeceptjs run
3939

4040
## Helpers
4141

42-
Please keep in mind that CodeceptJS have **unified API** for Playwright, WebDriverIO, Appium, Protractor, Nightmare, Puppeteer, TestCafe. Tests written using those helpers should be compatible at syntax level. However, some of helpers may contain unique methods. That happens. If, for instance, WebDriverIO has method XXX and Nightmare doesn't, you can implement XXX inside Nightmare using the same method signature.
42+
Please keep in mind that CodeceptJS have **unified API** for Playwright, WebDriverIO, Appium, Nightmare, Puppeteer, TestCafe. Tests written using those helpers should be compatible at syntax level. However, some of helpers may contain unique methods. That happens. If, for instance, WebDriverIO has method XXX and Nightmare doesn't, you can implement XXX inside Nightmare using the same method signature.
4343

4444
### Updating Playwright | Puppeteer | WebDriver | Nightmare
4545

@@ -187,8 +187,7 @@ docker-compose run --rm test-helpers test/rest
187187

188188
#### Run acceptance tests
189189

190-
To that we provide three separate services respectively for WebDriver, Nightmare, Puppeteer and
191-
Protractor tests:
190+
To that we provide three separate services respectively for WebDriver, Nightmare and Puppeteer tests:
192191

193192
```sh
194193
docker-compose run --rm test-acceptance.webdriverio

.github/PULL_REQUEST_TEMPLATE.md

-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,6 @@ Applicable helpers:
1010
- [ ] REST
1111
- [ ] FileHelper
1212
- [ ] Appium
13-
- [ ] Protractor
1413
- [ ] TestCafe
1514
- [ ] Playwright
1615

README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ CodeceptJS tests are:
3636

3737
* **Synchronous**. You don't need to care about callbacks or promises or test scenarios which are linear. But, your tests should be linear.
3838
* Written from **user's perspective**. Every action is a method of `I`. That makes test easy to read, write and maintain even for non-tech persons.
39-
* Backend **API agnostic**. We don't know which WebDriver implementation is running this test. We can easily switch from WebDriverIO to Protractor or PhantomJS.
39+
* Backend **API agnostic**. We don't know which WebDriver implementation is running this test.
4040

4141
CodeceptJS uses **Helper** modules to provide actions to `I` object. Currently, CodeceptJS has these helpers:
4242

@@ -54,7 +54,7 @@ And more to come...
5454

5555
CodeceptJS is a successor of [Codeception](http://codeception.com), a popular full-stack testing framework for PHP.
5656
With CodeceptJS your scenario-driven functional and acceptance tests will be as simple and clean as they can be.
57-
You don't need to worry about asynchronous nature of NodeJS or about various APIs of Selenium, Puppeteer, Protractor, TestCafe, etc. as CodeceptJS unifies them and makes them work as they are synchronous.
57+
You don't need to worry about asynchronous nature of NodeJS or about various APIs of Selenium, Puppeteer, TestCafe, etc. as CodeceptJS unifies them and makes them work as they are synchronous.
5858

5959

6060
## Features

docs/custom-helpers.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ This way, if your tests are written with TypeScript, your IDE will be able to le
102102

103103
## Accessing Elements
104104

105-
WebDriver, Puppeteer, Playwright, and Protractor drivers provide API for web elements.
105+
WebDriver, Puppeteer and Playwright drivers provide API for web elements.
106106
However, CodeceptJS do not expose them to tests by design, keeping test to be action focused.
107107
If you need to get access to web elements, it is recommended to implement operations for web elements in a custom helper.
108108

@@ -154,7 +154,7 @@ You can also pass additional config options to your helper from a config - **(pl
154154
```js
155155
helpers: {
156156
// here goes standard helpers:
157-
// WebDriver, Protractor, Nightmare, etc...
157+
// WebDriver, Nightmare, etc...
158158
// and their configuration
159159
MyHelper: {
160160
require: "./my_helper.js", // path to module

docs/data.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ API is supposed to be a stable interface and it can be used by acceptance tests.
2323
## REST
2424

2525
[REST helper](https://codecept.io/helpers/REST/) allows sending raw HTTP requests to application.
26-
This is a tool to make shortcuts and create your data pragmatically via API. However, it doesn't provide tools for testing APIs, so it should be paired with WebDriver, Nightmare or Protractor helpers for browser testing.
26+
This is a tool to make shortcuts and create your data pragmatically via API. However, it doesn't provide tools for testing APIs, so it should be paired with WebDriver helper for browser testing.
2727

2828
Enable REST helper in the config. It is recommended to set `endpoint`, a base URL for all API requests. If you need some authorization you can optionally set default headers too.
2929

@@ -92,7 +92,7 @@ I.sendPostRequest('/update-status', {}, { http_x_requested_with: 'xmlhttprequest
9292
## GraphQL
9393

9494
[GraphQL helper](https://codecept.io/helpers/GraphQL/) allows sending GraphQL queries and mutations to application, over Http.
95-
This is a tool to make shortcuts and create your data pragmatically via GraphQL endpoint. However, it doesn't provide tools for testing the endpoint, so it should be paired with WebDriver, Nightmare or Protractor helpers for browser testing.
95+
This is a tool to make shortcuts and create your data pragmatically via GraphQL endpoint. However, it doesn't provide tools for testing the endpoint, so it should be paired with WebDriver helpers for browser testing.
9696

9797
Enable GraphQL helper in the config. It is recommended to set `endpoint`, the URL to which the requests go to. If you need some authorization you can optionally set default headers too.
9898

docs/docker.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ services:
5656
5757
### Linking Containers
5858
59-
If using the Protractor or WebDriver drivers, link the container with a Selenium Standalone docker container with an alias of `selenium`. Additionally, make sure your `codeceptjs.conf.js` contains the following to allow CodeceptJS to identify where Selenium is running.
59+
If using the WebDriver driver, link the container with a Selenium Standalone docker container with an alias of `selenium`. Additionally, make sure your `codeceptjs.conf.js` contains the following to allow CodeceptJS to identify where Selenium is running.
6060

6161
```javascript
6262
...

docs/installation.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ For WebDriver installation Selenium Server is required 👇
5959

6060
## WebDriver
6161

62-
WebDriver based helpers like WebDriver, Protractor, Selenium WebDriver will require [Selenium Server](https://codecept.io/helpers/WebDriver/#selenium-installation) installed. They will also require ChromeDriver or GeckoDriver to run corresponding browsers.
62+
WebDriver based helpers like WebDriver will require [Selenium Server](https://codecept.io/helpers/WebDriver/#selenium-installation) installed. They will also require ChromeDriver or GeckoDriver to run corresponding browsers.
6363

6464
We recommend to install them manually or use NPM packages:
6565

docs/mobile.md

-1
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,6 @@ Select [Appium helper](https://codecept.io/helpers/Appium/) when asked.
123123
```sh
124124
? What helpers do you want to use?
125125
◯ WebDriver
126-
◯ Protractor
127126
◯ Puppeteer
128127
◯ Nightmare
129128
❯◉ Appium

docs/plugins.md

-2
Original file line numberDiff line numberDiff line change
@@ -1152,8 +1152,6 @@ plugins: {
11521152
}
11531153
```
11541154
1155-
Please note, this service can be used with Protractor helper as well!
1156-
11571155
#### Sauce Service
11581156
11591157
Install `@wdio/sauce-service` package, as [described here][19].

docs/quickstart.md

-1
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,6 @@ TestCafe provides cross-browser support without Selenium. TestCafe tests are fas
3131
---
3232

3333
* [Mobile Testing with Appium »](/mobile)
34-
* [Testing with Protractor »](/angular)
3534

3635
:::
3736

docs/webdriver.md

-2
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,6 @@ Let's clarify the terms:
2121

2222
We use [webdriverio](https://webdriver.io) library to run tests over WebDriver.
2323

24-
> Popular tool [Protractor](/angular) also uses WebDriver for running end 2 end tests.
25-
2624
To proceed you need to have [CodeceptJS installed](/quickstart#using-selenium-webdriver) and `WebDriver` helper selected.
2725

2826
Selenium WebDriver may be complicated from start, as it requires following tools to be installed and started.

0 commit comments

Comments
 (0)