angular · CrispusDH · Nov 6, 2018 · Nov 7, 2018 · Nov 8, 2018 · Nov 8, 2018
diff --git a/.jshintignore b/.jshintignore
diff --git a/.jshintrc b/.jshintrc
diff --git a/.travis.yml b/.travis.yml
@@ -1,8 +1,8 @@
 language: node_js
 sudo: false
 node_js:
-  - "6"
-  - "8"
+  - "9"
+  - "10"
 
 env:
   global:
@@ -24,9 +24,9 @@ matrix:
     - env: "JOB=bstack"
   exclude:
     - env: JOB=smoke
-      node_js: "7"
+      node_js: "9"
     - env: JOB=bstack
-      node_js: "7"
+      node_js: "9"
 
 addons:
   apt:
@@ -36,17 +36,18 @@ addons:
       - g++-4.8
 
 before_install:
-  - g++-4.8 --version
+  - travis_wait g++-4.8 --version
 
 before_script:
   - npm run install_testapp
   - npm run pretest
   - mkdir -p $LOGS_DIR
-  - ./scripts/travis_setup.sh
+  - travis_wait ./scripts/travis_setup.sh
+
 
 script:
   - ./scripts/testserver.sh
   - ./scripts/test_on_travis.sh
 
 after_script:
-  - ./scripts/print_logs.sh
+  - ./scripts/print_logs.sh
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,153 @@
+# 6.0.0-beta
+
+Selenium 4 removes the control flow and most of these changes are based on those changes. To see the full list of changes, please refer to selenium-webdriver's [CHANGELOG](https://github.com/SeleniumHQ/selenium/blob/master/javascript/node/selenium-webdriver/CHANGES.md)
+
+## Breaking changes
+
+- Control flow is removed and you should use async await to run your tests.
+- Other control flow related items:
+  - debugger, explore and element explorer have been removed
+  - jasminewd is no longer a dependency
+- ignoreSynchronization has been deprecated and you should use `waitForAngularEnabled`
+- Types for selenium-webdriver are currently in the types/ directory and are not complete. We are still missing some type definitions for selenium 4.
+- Actions API in selenium-webdriver have changed and they will break your test. Also we have not exported it yet since the type definitions are not complete.
+
+## Features
+
+- ([8420cfa](https://github.com/angular/protractor/commit/8420cfa10fa5e32b037db933d40e84726a895f3c))
+  chore(debugprint): convert debugprint to TypeScript (#5074)
+
+- ([1e12445](https://github.com/angular/protractor/commit/1e124454d2926a9d2328c1a4516186f533b42b71))
+  chore(browser): remove timing issues with restart and fork (#5085)
+
+  - remove .ready since forking should automatically return a browser
+  - getNewDriver should return a promised WebDriver that can be awaited
+  - fix interaction tests and local driver tests
+  - update unit tests for async await due to getNewDriver fix
+   closes #5031
+- ([d6bbf09](https://github.com/angular/protractor/commit/d6bbf09af0220f683ac7db51ade5cada45876776))
+  chore(elementexplorer): remove explorer bin file (#5094)
+
+  closes #5092
+
+- ([0c325c5](https://github.com/angular/protractor/commit/0c325c56f0aef3b0016890b074938db875ae7a62))
+  chore(ignoreSynchornization): clean up to use waitForAngularEnabled (#5071)
+
+
+- ([591653d](https://github.com/angular/protractor/commit/591653d46b390d5b16087b5fb5b65cc680090fed))
+  chore(debugger): remove debugger and explore methods (#5070)
+
+- ([0541775](https://github.com/angular/protractor/commit/0541775980f0314fc36590eae1791f478588b619))
+  chore(promises): remove q promises and webdriver promises (#5052)
+
+  - remove q promises and webdriver promises from the runner, launcher, plugins, and taskRunner
+  - add deprecated message to element explorer.
+  - add unhandledRejection
+  - update browser versions used in travis tests
+
+- ([7ca7df2](https://github.com/angular/protractor/commit/7ca7df2708b847b9d002bef6d1ed0fe075154aeb))
+  chore(promises): clean up driver providers and browser control flow (#5034)
+
+  Driver providers and tests:
+
+  - Use native promises over q promises in driver providers
+  - Remove driverProviderUseExistingWebDriver since the generation of the selenium server is already
+  accomplished when providing a selenium address in driverProvider.ts. Also clean up docs and tests.
+
+  - Enabled the driverProviderLocal tests
+  - Clean up JSDocs for q.promise
+   Basic lib spec:
+
+  - Remove auto unwrap test for a WebElement. Reference PR #3471
+   Browser:
+
+  - Remove control flow from waitForAngularEnabled, waitForAngular, and angularAppRoot in the
+  Browser class.
+
+## Dependencies
+
+- ([93930ff](https://github.com/angular/protractor/commit/93930fff33e94942c8ff6c6c8089dcd70acd6b7b))
+  deps(jasmine): upgrade jasmine 3.3 (#5102)
+
+- ([373ba02](https://github.com/angular/protractor/commit/373ba029420a5f3f0c05bbb8f739f9fd96ac598b))
+   deps(selenium): upgrade to selenium 4 (#5095)
+
+  - elements workaround for WebElement.equals
+  - added a better unhandled rejection warning message in the launcher
+ control flow)bal function wrappers for mocha (these wrappers went away with
+  - fix the attach to session driver provider
+   Typing exported from Protractor:
+
+  - removed ActionSequence and EventEmitter (actions is currently missing)
+  - removed promise.Promise
+ fulfilled, filter, whener, delayed, createFlow, controlFlow, all,
+   Typings exported from WebDriver:
+
+  - removed attachToSession
+  - removed WebDriver instance methods: touchActions, call
+  - removed WebElement getSize and getLocation for getRect
+  - removed redefined global vars for testing
+  - In the typings, we are missing Options.setScriptTimeout method. This should not impact users
+  unless they are using the driver.manage() method.
+   Tests:
+
+  - fix element equals test
+  - add missing 'await' in colorList test that is causing unhandled promise rejections.
+  - remove control flow related tests
+  - disable the install test. Installing from "file:../../" is not working.
+  - fix the attach to session driver provider test to exit with a 1 if errors are encountered
+
+- ([736bbf7](https://github.com/angular/protractor/commit/736bbf7df04b36d1d0fcc7383be2022aa14234b0))
+  deps(latest): upgrade to the gulp and typescript (#5089)
+
+  * deps(latest): upgrade to the gulp and typescript
+
+  - add in @types/loglevel and @types/yargs for webdriver-manager
+  - upgrade tslint clean up for tslint
+ supported by gulpp 4 and remove run sequence since this feature is
+  - remove compile to es5
+
+- ([658a1fb](https://github.com/angular/protractor/commit/658a1fb3020ce6a2316113cbbb6f84e513158c82))
+  deps(webdriver-manager): use replacement (#5088)
+
+ publish a beta release of use webdriver-manager-replacement until we
+  webdriver-manager
+   closes #5087
+
+
+# 5.4.2
+
+## Features
+
+- ([db1b638](https://github.com/angular/protractor/commit/db1b6381d463c7cecf11dece2bf9412fecbd6f4d))
+  feat(saucelabs): add sauceRegion support for eu datacenters (#5083)
+
+  This change allows user to define the backend region from sauce via the `sauceRegion` property,
+  e.g.
+
+  ```js
+     sauceUser: process.env.SAUCE_USERNAME,
+     sauceKey: process.env.SAUCE_ACCESS_KEY,
+     sauceRegion: 'eu',
+  ```
+   Will run the test against `https://ondemand.eu-central-1.saucelabs.com:443/wd/hub/.`
+
+  ```js
+     sauceUser: process.env.SAUCE_USERNAME,
+     sauceKey: process.env.SAUCE_ACCESS_KEY,
+     sauceRegion: 'us',
+
+     // the default
+     sauceUser: process.env.SAUCE_USERNAME,
+     sauceKey: process.env.SAUCE_ACCESS_KEY,
+  ```
+   Will run the test against https://ondemand.saucelabs.com:443/wd/hub/
+
+##  Fixes
+
+- ([f5dbe13](https://github.com/angular/protractor/commit/f5dbe13ad6755ae812627d8056527e351db8b34c))
+  fix(deps): @types/node is now a dev dependency
+
 # 5.4.1
 
 ## Features

diff --git a/bin/elementexplorer.js b/bin/elementexplorer.js
diff --git a/bin/webdriver-manager b/bin/webdriver-manager
@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-require('webdriver-manager');
+require('webdriver-manager/dist/lib/cli');
diff --git a/circle.yml b/circle.yml
@@ -2,7 +2,7 @@ version: 2
 jobs:
   build:
     docker:
-      - image: circleci/node:6.14-browsers
+      - image: circleci/node:8.11-browsers
         environment:
           # Fix issue with selenium-server in containers.
           # See http://github.com/SeleniumHQ/docker-selenium/issues/87
@@ -32,6 +32,8 @@ jobs:
       - restore_cache:
           key: node_modules-{{ .Branch }}-{{ checksum "package-lock.json" }}
 
+      - run: google-chrome --version
+
       - run:
           name: NPM Install
           command: |

diff --git a/docs/server-setup.md b/docs/server-setup.md
@@ -108,37 +108,3 @@ Protractor can test directly against Chrome and Firefox without using a Selenium
  - `directConnect: true` -  Your test script communicates directly Chrome Driver or Firefox Driver, bypassing any Selenium Server. If this is true, settings for `seleniumAddress` and `seleniumServerJar` will be ignored. If you attempt to use a browser other than Chrome or Firefox an error will be thrown.
 
 The advantage of directly connecting to browser drivers is that your test scripts may start up and run faster.
-
-Re-using an Existing WebDriver
-------------------------------
-
-The use case for re-using an existing WebDriver is when you have existing
-`selenium-webdriver` code and are already in control of how the WebDriver is
-created, but would also like Protractor to use the same browser, so you can
-use protractor's element locators and the rest of its API. This could be
-done with the `attachSession` driver provider, but the `attachSession` API is
-being removed in `selenium-webdriver` 4.0.0.
-
-Instead of a protractor config file, you create a config object in your test
-setup code, and add your already-created WebDriver object and base URL.
-
-```javascript
-const ProtractorConfigParser = require('protractor/built/configParser').ConfigParser;
-const ProtractorRunner = require('protractor/built/runner').Runner;
-
-const ptorConfig = new ProtractorConfigParser().config_;
-ptorConfig.baseUrl = myExistingBaseUrl;
-ptorConfig.seleniumWebDriver = myExistingWebDriver;
-ptorConfig.noGlobals = true; // local preference
-
-// looks similar to protractor/built/runner.js run()
-const ptorRunner = new ProtractorRunner(ptorConfig);
-ptorRunner.driverProvider_.setupEnv();
-const browser = ptorRunner.createBrowser();
-ptorRunner.setupGlobals_(browser); // now you can access protractor.$, etc.
-```
-
-Note that this driver provider leaves you in control of quitting the driver,
-but that also means Protractor API calls that expect the driver to properly
-quit and/or restart the browser, e.g. `restart`, `restartSync`, and
-`forkNewDriverInstance`, will not behave as documented.