2.3 release (#1849)

* fixed event.step.comment to use consts

* fixes to docs

* updated accessibility id search, docs

* updates to docs and changelogs

* preparing release

Author: DavertMik

CHANGELOG.md

@@ -1,7 +1,41 @@
+## 2.3.0
+
+* [GraphQL][GraphQLDataFactory] **Helpers for data management over GraphQL** APIs added. By @radhey1851.
+  * Learn how to [use GraphQL helper](https://codecept.io/data#graphql) to access GarphQL API
+  * And how to combine it with [GraphQLDataFactory](https://codecept.io/data#graphql-data-factory) to generate and persist test data.
+* **Updated to use Mocha 6**. See #1802 by @elukoyanov
+* **Parallel testing by workers introduced** by @VikalpP and @davertmik. Use `run-workers` command as faster and simpler alternative to `run-multiple`. Requires NodeJS v12
+
+```
+# run all tests in parallel using 3 workers
+npx codeceptjs run-workers 3
+```
+
+* Added `dry-run` command to print steps of test scenarios without running them. Fails to execute scenarios with `grab*` methods or custom code. See #1825 for more details.
+
+```
+npx codeceptjs dry-run
+```
+
+* [Appium] Optimization when clicking, searching for fields by accessibility id. See #1777 by @gagandeepsingh26
+* [TestCafe] Fixed `switchTo` by @KadoBOT
+* [WebDrover] Added geolocation actions by @PeterNgTr
+    * `grabGeoLocation()`
+    * `setGeoLocation()`
+* [Polly] Check typeof arguments for mock requests by @VikalpP. Fixes #1815
+* CLI improvements by @jamesgeorge007
+  * `codeceptjs` command prints list of all available commands
+  * added `codeceptjs -V` flag to print version information
+  * warns on unknown command
+* Added TypeScript files support to `run-multiple` by @z4o4z
+* Fixed element position bug in locator builder. See #1829 by @AnotherAnkor
+* Various TypeScript typings updates by @elukoyanov and @Vorobeyko
+* Added `event.step.comment` event for all comment steps like `I.say` or gherking steps.
+
 ## 2.2.1
 
 * [WebDriver] A [dedicated guide](https://codecept.io/webdriver) written.
-* [TestCade] A [dedicated guide](https://codecept.io/testcafe) written.
+* [TestCafe] A [dedicated guide](https://codecept.io/testcafe) written.
 * [Puppeteer] A [chapter on mocking](https://codecept.io/puppeteer#mocking-requests) written
 * [Puppeteer][Nightmare][TestCafe] Window mode is enabled by default on `codeceptjs init`.
 * [TestCafe] Actions implemented by @hubidu

bin/codecept.js

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
 const program = require('commander');
-const path = require('path');
-const Config = require('../lib/config');
 const Codecept = require('../lib/codecept');
 const { print, error } = require('../lib/output');
 
@@ -157,7 +155,7 @@ program.command('run-multiple [suites...]')
   .action(require('../lib/command/run-multiple'));
 
 program.command('dry-run [test]')
-  .description('Executes tests multiple')
+  .description('Prints step-by-step scenario for a test without actually running it')
   .option('-p, --plugins <k=v,k2=v2,...>', 'enable plugins, comma-separated')
   .option('--bootstrap', 'enable bootstrap script for dry-run')
   .option('-c, --config [file]', 'configuration file to be used')

docs/changelog.md

@@ -3,11 +3,27 @@ id: changelog
 title: Releases
 ---
 
+## 2.3.0
+
+* [GraphQL][GraphQLDataFactory] Helpers introduced for **data management over GraphQL** APIs. By **[radhey1851](https://github.com/radhey1851)**.
+  * Learn how to [use GraphQL helper docs](https://codecept.io/data#graphql)
+  * And how to combine it with **[GraphQLDataFactory]** * **Updated to use Mocha 6**. See [#1802](https://github.com/Codeception/CodeceptJS/issues/1802) by **[elukoyanov](https://github.com/elukoyanov)**
+* **[Appium]** Optimization when clicking, searching for fields by accessibility id. See [#1777](https://github.com/Codeception/CodeceptJS/issues/1777) by **[gagandeepsingh26](https://github.com/gagandeepsingh26)**
+* **[TestCafe]** Fixed `switchTo` by **[KadoBOT](https://github.com/KadoBOT)**
+* **[WebDrover]** Added geolocation actions by **[PeterNgTr](https://github.com/PeterNgTr)**
+    * `grabGeoLocation()`
+    * `setGeoLocation()`
+* **[Polly]** Check typeof arguments for mock requests by **[VikalpP](https://github.com/VikalpP)**. Fixes [#1815](https://github.com/Codeception/CodeceptJS/issues/1815)
+* CLI improvements by **[jamesgeorge007](https://github.com/jamesgeorge007)**
+  * `codeceptjs` command prints list of all available commands
+  * added `codeceptjs -V` flag to print version information
+  * warns on unknown command
+
 ## 2.2.1
 
 * **[WebDriver]** A [dedicated guide](https://codecept.io/webdriver) written.
 * **[TestCafe]** A [dedicated guide](https://codecept.io/testcafe) written.
-* **[Puppeteer]** A [chapter on mocking](https://codecept.io/puppeteer#mocking) written
+* **[Puppeteer]** A [chapter on mocking](https://codecept.io/puppeteer#mocking-requests) written
 * [Puppeteer][Nightmare][TestCafe] Window mode is enabled by default on `codeceptjs init`.
 * **[TestCafe]** Actions implemented by **[hubidu](https://github.com/hubidu)**
   * `grabPageScrollPosition`
@@ -31,7 +47,6 @@ title: Releases
   * Fix `--path` option on `gherkin:snippets` command by **[asselin](https://github.com/asselin)**. See [#1790](https://github.com/Codeception/CodeceptJS/issues/1790)
   * Added `--feature` option to `gherkin:snippets` to enable creating snippets for a subset of .feature files. See [#1803](https://github.com/Codeception/CodeceptJS/issues/1803) by **[asselin](https://github.com/asselin)**.
 * Fixed: dynamic configs not reset after test. Fixes [#1776](https://github.com/Codeception/CodeceptJS/issues/1776) by **[cviejo](https://github.com/cviejo)**.
-* allurePlugin - fixed displaying ANSI chars in reports by **[Vorobeyko](https://github.com/Vorobeyko)**
 
 ## 2.2.0
 

docs/helpers/Appium.md

@@ -44,7 +44,7 @@ This helper should be configured in codecept.json or codecept.conf.js
     -   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
     -   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
 
-Example:
+Example Android App:
 
 ```js
 {
@@ -62,6 +62,47 @@ Example:
 }
 ```
 
+Example iOS Mobile Web with local Appium:
+
+```js
+{
+helpers: {
+  Appium: {
+    platform: "iOS",
+    url: "https://the-internet.herokuapp.com/",
+    desiredCapabilities: {
+      deviceName: "iPhone X",
+      platformVersion: "12.0",
+      browserName: "safari"
+    }
+  }
+}
+}
+```
+
+Example iOS Mobile Web on BrowserStack:
+
+```js
+{
+helpers: {
+  Appium: {
+    host: "hub-cloud.browserstack.com",
+    port: 4444,
+    user: process.env.BROWSERSTACK_USER,
+    key: process.env.BROWSERSTACK_KEY,
+    platform: "iOS",
+    url: "https://the-internet.herokuapp.com/",
+    desiredCapabilities: {
+      realMobile: "true",
+      device: "iPhone 8",
+      os_version: "12",
+      browserName: "safari"
+    }
+  }
+}
+}
+```
+
 Additional configuration params can be used from [https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md][3]
 
 ## Access From Helpers