codeceptjs 3.5.12-beta.2 → 3.5.12-beta.3

package/docs/wiki/Upgrading-to-CodeceptJS-3.md

@@ -1,153 +0,0 @@
-🚀 CodeceptJS 3 is out now. Install it:
-
-```
-npm i codeceptjs
-```
-
-* [COMPLETE CHANGELOG](https://github.com/Codeception/CodeceptJS/blob/codeceptjs-v3.0/CHANGELOG.md#300-beta)
-* [Documentation](https://github.com/Codeception/CodeceptJS/tree/codeceptjs-v3.0/docs)
-
-After installing a new version, run `codecept3-upgrade` which is described below:
-
----
-
-CodeceptJS 3.0 is a new version of CodeceptJS with some breaking changes included. 
-You should update your project following this guide to ensure that everything works correctly. 
-
-### 1️⃣ Syntax Change
-
-CodeceptJS 3.0 introduced a new syntax for declaring tests, instead of:
-
-```js
-Scenario('title', (I, loginPage) => {})
-```
-we use a new way of passing arguments into a test, via destruction:
-
-```js
-Scenario('title', ({ I, loginPage }) => {})
-```
-
-This works similarly to `inject()` command. This change was done to unify accessing [dependency injection container](https://codecept.io/pageobjects/#dependency-injection), and to provide better TypeScript support. 
-
-> If you use BDD-style project with Gherkin, no changes needed for this step. 
-
-To upgrade your project, you don't need to change manually all your tests. 
-
-💪 **Use [codecept3-upgrade tool](https://www.npmjs.com/package/codecept3-upgrade) to perform the migration**. Use it carefully, as it updates your current code.
-
-To upgrade your codebase, commit all your changes, and switch to a new branch.
-Run upgrade script (even without installing) for a directory where you have your tests:
-
-```
-npx codecept3-upgrade tests
-```
-Review the changes in Git Diff and try to execute tests using CodeceptJS 3.0
-
-
-### 2️⃣ Grabbers signature change
-
-There were confusion and inconsistency across grab* methods. What they will return if multiple elements are found? A single element or an array? This was the problem as the format was dependent on a page content. 
-
-In 3.0 we decided to make all current grab* methods to return a single value only. While we add new methods grab**FromAll that return an array.
-
-For instance, `grabTextFrom` will always return a single text value, while `grabTextFromAll` will return an array of values:
-
-```js
-await I.grabTextFrom('.username'); => 'john'
-await I.grabTextFromAll('.username'); => ['john', 'claudia', 'bill']
-```
-
-Please update parts in your project where you rely on grab* methods to return an array.
-
-
-| Single Value | Multiple Values |
-| -- | -- |
-| ✋`grabTextFrom` | 🙌 `grabTextFromAll`  |
-| ✋`grabValueFrom` | 🙌 `grabValueFromAll`  |
-| ✋ `grabAttributeFrom` | 🙌`grabAttributeFromAll`  |
-| ✋ `grabHTMLFrom` | 🙌 `grabHTMLFromAll`  |
-| ✋ `grabCssPropertyFrom` | 🙌 `grabCssPropertyFromAll` |
-
-> Single-value `grab*From` will throw error when no data was matched, while `grab*FromAll` will return array.
-
-### 3️⃣ Bootstrap / Teardown Changed
-
-`async/await` paradigm changed the way we write asynchronous code in NodeJS. 
-However, bootstrap functions were created to use old-style methods of passing `done` callback inside.
-
-In 3.0 we decided to completely change the way async bootstrap is performed and replace all it with async/await functions:
-
-```js
-// before
-bootstrap: (done) => {
-  server.start().then(done);
-},
-
-// after
-bootstrap: async () => {
-  await server.start();
-}
-```
-Passing a string as bootstrap function (to require a function from external file) is also not supported:
-
-```js
-// before
-bootstrap: './server_start.js',
-
-// after
-bootstrap: require('./server_start.js'),
-```
-
-The same rules are applied to teardown, bootstrapAll, teardownAll.
-
-### 4️⃣ Locator Detection Heuristic Change
-
-In 3.0 we added a new rule to auto-detect CSS locator. If a locator starts with `[` parser will use it as a CSS locator, without trying to match value by text.
-
-* Previous behavior: I.click('[user]') - will try to search for a link with `[user]` text, if no found - take `[user]` as CSS locator
-* Current behavior: I.click('[user]') - will check only for CSS locator `[user]`
-
-### 5️⃣ Improved Parallel Execution with Workers
-
-CodeceptJS has two parallel execution modes:
-
-* classical `run-multiple` which spawns independent CodeceptJS processes on system level.
-* threaded `run-workers` which uses NodeJS workers instead of subprocesses.
-
-Workers are faster, they can communicate with parent thread. Unfortunately, `run-workers` was not as efficient as `run-multiple` because there was no way of declaring sophisticated configs for parallel execution. For instance, running tests in 4 threads in 2 browsers could not be set.
-
-We updated workers API to make them as flexible as possible. You don't even need to put complex logic into config! You can create your own parallel runner and customize it to match your expectations:
-
-```js
-// don't initialize workers in constructor
-const workers = new Workers(null, workerConfig);
-// split tests by suites in 2 groups
-const testGroups = workers.createGroupsOfSuites(2);
-
-const browsers = ['firefox', 'chrome'];
-
-const configs = browsers.map(browser => {
-  return helpers: {
-    WebDriver: { browser }
-  }
-});
-
-for (const config of configs) {
-  for (group of groupOfTests) {
-    const worker = workers.spawn();
-    worker.addTests(group);
-    worker.addConfig(config);
-  }
-}
-
-workers.run();
-```
-[Learn more about how you can create a parallel runner](https://github.com/Codeception/CodeceptJS/blob/codeceptjs-v3.0/docs/parallel.md#custom-parallel-execution).
-
-`run-multiple` will still work but it is considered deprecated and won't be supported.
-
-### WebDriverIO helper removed
-
-WebDriverIO helper supported webdriverio v4 library, which is not maintained anymore. It should be easy to switch to WebDriver helper which supports webdriverio v6.
-
- 

package/docs/wiki/Videos.md

@@ -1,19 +0,0 @@
-[![](http://i3.ytimg.com/vi/BRMWstiOTks/maxresdefault.jpg)](https://www.youtube.com/watch?v=BRMWstiOTks)
-
-## [An Introduction, Getting started and working with CodeceptJS & Puppeteer (EAWeekend)](https://www.youtube.com/watch?v=BRMWstiOTks)
-
-## [CodeceptJS Official YouTube Channel](https://www.youtube.com/channel/UCEs4030bmtonyDhTHEXa_2g)
-
-## [Introductory Videos](https://www.youtube.com/watch?v=FPFG1rBNJ64&list=PLcFXthgti9Lt4SjSvL1ALDg6dOeTC0TvT)
-
-Free educational videos provided by our community member **[@ontytoom](http://github.com/ontytoom)**.
-
-1. [Installation](https://www.youtube.com/watch?v=FPFG1rBNJ64)
-1. [Creating a Test](https://www.youtube.com/watch?v=mdQZjL3h9d0)
-1. [Using Page Objects](https://www.youtube.com/watch?v=s677_6VctjQ)
-
-## [Practical E2E Testing with CodeceptJS](https://www.udemy.com/practical-e2e-testing-with-codeceptjs/)
-
-Udemy course by Luke Beilharz
-
-

package/lib/css2xpath/js/css_to_xpath.js

@@ -1,20 +0,0 @@
-(function() {
-    var self = this;
-    var parser, xpathBuilder, Expression, parse, convertToXpath;
-    parser = require("bo-selector").parser;
-    xpathBuilder = require("xpath-builder").dsl();
-    Expression = require("./expression");
-    parser.yy.create = function(data) {
-        var self = this;
-        return new Expression(data);
-    };
-    parse = function(selector) {
-        return parser.parse(selector).render(xpathBuilder, "descendant");
-    };
-    convertToXpath = function(selector) {
-        return parse(selector).toXPath();
-    };
-    convertToXpath.parse = parse;
-    convertToXpath.xPathBuilder = xpathBuilder;
-    module.exports = convertToXpath;
-}).call(this);

package/lib/css2xpath/js/expression.js

@@ -1,23 +0,0 @@
-(function() {
-    var self = this;
-    var Renderer, Expression, extend;
-    Renderer = require("./renderer");
-    Expression = function(data) {
-        extend(this, data);
-        return this;
-    };
-    Expression.prototype.render = function(xpath, combinator) {
-        var self = this;
-        return new Renderer().render(self, xpath, combinator);
-    };
-    extend = function(o, d) {
-        var k;
-        for (k in d) {
-            (function(k) {
-                o[k] = d[k];
-            })(k);
-        }
-        return void 0;
-    };
-    module.exports = Expression;
-}).call(this);

package/lib/css2xpath/js/renderer.js

@@ -1,239 +0,0 @@
-(function() {
-    var self = this;
-    var xpathBuilder, Renderer;
-    xpathBuilder = require("xpath-builder").dsl();
-    Renderer = function() {
-        return this;
-    };
-    Renderer.prototype = {
-        render: function(node, xpath, combinator) {
-            var self = this;
-            var fn;
-            fn = self[node.type];
-            if (!fn) {
-                throw new Error("No renderer for '" + node.type + "'");
-            }
-            return fn.call(self, node, xpath, combinator);
-        },
-        selector_list: function(node, xpath, combinator) {
-            var self = this;
-            var x, i;
-            x = self.render(node.selectors[0], xpath, combinator);
-            for (i = 1; i < node.selectors.length; ++i) {
-                x = x.union(self.render(node.selectors[i], xpath, combinator));
-            }
-            return x;
-        },
-        constraint_list: function(node, xpath, combinator) {
-            var self = this;
-            return self.element(node, xpath, combinator);
-        },
-        element: function(node, xpath, combinator) {
-            var self = this;
-            return self.applyConstraints(node, xpath[combinator].call(xpath, node.name || "*"));
-        },
-        combinator_selector: function(node, xpath, combinator) {
-            var self = this;
-            var left;
-            left = self.render(node.left, xpath, combinator);
-            return self.render(node.right, left, node.combinator);
-        },
-        immediate_child: function(node, xpath) {
-            var self = this;
-            return self.render(node.child, xpath, "child");
-        },
-        pseudo_func: function(node, xpath) {
-            var self = this;
-            var fn;
-            fn = self[node.func.name.replace(/-/g, "_")];
-            if (fn) {
-                return fn.call(self, node, xpath);
-            } else {
-                throw new Error("Unsupported pseudo function :" + node.func.name + "()");
-            }
-        },
-        pseudo_class: function(node, xpath) {
-            var self = this;
-            var fn;
-            fn = self[node.name.replace(/-/g, "_")];
-            if (fn) {
-                return fn.call(self, node, xpath);
-            } else {
-                throw new Error("Unsupported pseudo class :" + node.name);
-            }
-        },
-        has: function(node, xpath) {
-            var self = this;
-            return self.render(node.func.args, xpathBuilder, "descendant");
-        },
-        not: function(node, xpath) {
-            var self = this;
-            var firstChild, childType;
-            firstChild = node.func.args.selectors[0];
-            childType = firstChild.type;
-            if (childType === "constraint_list") {
-                return self.combineConstraints(firstChild, xpath).inverse();
-            } else {
-                return self.matchesSelectorList(node.func.args, xpath).inverse();
-            }
-        },
-        nth_child: function(node, xpath) {
-            var self = this;
-            return xpath.nthChild(Number(node.func.args));
-        },
-        first_child: function(node, xpath) {
-            var self = this;
-            return xpath.firstChild();
-        },
-        last_child: function(node, xpath) {
-            var self = this;
-            return xpath.lastChild();
-        },
-        nth_last_child: function(node, xpath) {
-            var self = this;
-            return xpath.nthLastChild(Number(node.func.args));
-        },
-        only_child: function(node, xpath) {
-            var self = this;
-            return xpath.onlyChild();
-        },
-        only_of_type: function(node, xpath) {
-            var self = this;
-            return xpath.onlyOfType();
-        },
-        nth_of_type: function(node, xpath) {
-            var self = this;
-            var type;
-            type = node.func.args.type;
-            if (type === "odd") {
-                return xpath.nthOfTypeOdd();
-            } else if (type === "even") {
-                return xpath.nthOfTypeEven();
-            } else if (type === "an") {
-                return xpath.nthOfTypeMod(Number(node.func.args.a));
-            } else if (type === "n_plus_b") {
-                return xpath.nthOfTypeMod(1, Number(node.func.args.b));
-            } else if (type === "an_plus_b") {
-                return xpath.nthOfTypeMod(Number(node.func.args.a), Number(node.func.args.b));
-            } else {
-                return xpath.nthOfType(Number(node.func.args));
-            }
-        },
-        nth_last_of_type: function(node, xpath) {
-            var self = this;
-            var type;
-            type = node.func.args.type;
-            if (type === "odd") {
-                return xpath.nthLastOfTypeOdd();
-            } else if (type === "even") {
-                return xpath.nthLastOfTypeEven();
-            } else if (type === "an") {
-                return xpath.nthLastOfTypeMod(Number(node.func.args.a));
-            } else if (type === "n_plus_b") {
-                return xpath.nthLastOfTypeMod(1, Number(node.func.args.b));
-            } else if (type === "an_plus_b") {
-                return xpath.nthLastOfTypeMod(Number(node.func.args.a), Number(node.func.args.b));
-            } else {
-                return xpath.nthLastOfType(Number(node.func.args));
-            }
-        },
-        last_of_type: function(node, xpath) {
-            var self = this;
-            return xpath.lastOfType();
-        },
-        empty: function(node, xpath) {
-            var self = this;
-            return xpath.empty();
-        },
-        has_attribute: function(node, xpath) {
-            var self = this;
-            return xpathBuilder.attr(node.name);
-        },
-        attribute_equals: function(node, xpath) {
-            var self = this;
-            return xpathBuilder.attr(node.name).equals(node.value);
-        },
-        attribute_contains: function(node, xpath) {
-            var self = this;
-            return xpathBuilder.attr(node.name).contains(node.value);
-        },
-        attribute_contains_word: function(node, xpath) {
-            var self = this;
-            return xpath.concat(" ", xpathBuilder.attr(node.name).normalize(), " ").contains(" " + node.value + " ");
-        },
-        attribute_contains_prefix: function(node) {
-            var self = this;
-            return xpathBuilder.attr(node.name).startsWith(node.value).or(xpathBuilder.attr(node.name).startsWith(node.value + "-"));
-        },
-        attribute_starts_with: function(node, xpath) {
-            var self = this;
-            return xpathBuilder.attr(node.name).startsWith(node.value);
-        },
-        attribute_ends_with: function(node) {
-            var self = this;
-            return xpathBuilder.attr(node.name).endsWith(node.value);
-        },
-        "class": function(node) {
-            var self = this;
-            return self.attribute_contains_word({
-                name: "class",
-                value: node.name
-            }, xpathBuilder);
-        },
-        id: function(node) {
-            var self = this;
-            return xpathBuilder.attr("id").equals(node.name);
-        },
-        previous_sibling: function(node, xpath, combinator) {
-            var self = this;
-            var left;
-            left = self.render(node.left, xpath, combinator);
-            return self.applyConstraints(node.right, left.axis("following-sibling", node.right.name));
-        },
-        adjacent_sibling: function(node, xpath, combinator) {
-            var self = this;
-            var left;
-            left = self.render(node.left, xpath, combinator);
-            return self.applyConstraints(node.right, left.axis("following-sibling::*[1]/self", node.right.name));
-        },
-        first_of_type: function(node, xpath) {
-            var self = this;
-            return xpath.firstOfType();
-        },
-        matchesSelectorList: function(node, xpath) {
-            var self = this;
-            var condition, i;
-            if (node.selectors.length > 0) {
-                condition = self.matchesSelector(node.selectors[0], xpathBuilder);
-                for (i = 1; i < node.selectors.length; ++i) {
-                    condition = condition.or(self.matchesSelector(node.selectors[i], xpathBuilder));
-                }
-                return condition;
-            } else {
-                return xpath;
-            }
-        },
-        matchesSelector: function(node, xpath) {
-            var self = this;
-            return xpath.name().equals(node.name);
-        },
-        combineConstraints: function(node, xpath) {
-            var self = this;
-            var condition, i;
-            condition = self.render(node.constraints[0], xpath);
-            for (i = 1; i < node.constraints.length; ++i) {
-                condition = condition.and(self.render(node.constraints[i], condition));
-            }
-            return condition;
-        },
-        applyConstraints: function(node, xpath) {
-            var self = this;
-            if (node.constraints.length > 0) {
-                return xpath.where(self.combineConstraints(node, xpath));
-            } else {
-                return xpath;
-            }
-        }
-    };
-    module.exports = Renderer;
-}).call(this);