Webship-js is an Automated Functional Acceptance Testing tool. Helps to ease and speed the work with the End-to-end testing features in web apps or projects. Utilizing Nightwatch.js and Cucumber-js. Having custom and advanced general step definitions.
Home Page: https://webship.co
Webship-js is an Automated Functional Acceptance Testing tool. Helps to ease and speed the work with the End-to-end testing features in web apps or projects. Utilizing Nightwatch.js and Cucumber-js. Having custom and advanced general step definitions.
All you need to know is at webship-js Docs.
yarn add webship-js
bash <(wget -O - https://raw.githubusercontent.com/webship/wbash/v1/webship-js/v1/template.sh)
yarn test
We have 3 different callings (config file, src folders):
1. Out of the project, package default commands, which call the main webship.conf.js, and 'test/step-definitions' folder both exist in the package root.
2. Inside the project, package default commands, which call the main webship.conf.js, and 'test/step-definitions' folder both exist in './node_modules/webship-js/'.
3. Command arguments, which call files and directories depending on the arguments' full path.
Merge webship-js-dl and webship-js-di files in one file called "steplist", and using it as the main command.
Example:
node ./bin/steplist --format="stdout-space"
Example: When I go to the homepage
Example: And I go to "/"
Option tags added to the command line:
(--config)
To get the project config file that has main paths for step definitions.
Example:
--config="path/to/file/nightwatch.conf.js"
(--src_folders)
To get the additional files in additional folders for step definitions.
Example:
--src_folders="path/to/folder/folder1 path/to/folder/folder2"
(--format)
To set step definitions list display format.
Example:
--format="stdout-dashes" // To display dashes between list lines
Separate -d argument into two arguments:
-l : to show step definitions in the list without information
-i : to show step definitions in the list with extra information
Example:
node ./bin/steplist -i
Given I go to "([^"]*)?"
Navigate to a url.
Exmaple:
- Given I go to "https://webship.co"
Then I should( not)* see "([^"]*)?"
Asserting a text in the page.
Exmaple:
- Then I should see "Welcome"
- Then I should not see "Access denied"
And --help will changed:
node ./bin/steplist -h
usage: steplist.js [-h] [-v] [-l] [-i] [-c CONFIG] [-s SRC_FOLDERS] [-f FORMAT]
Argparse example
optional arguments:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-l, --list Display step definitions list without information.
-i, --information Display step definitions list with information.
-c CONFIG, --config CONFIG
Add your nightwatch config file, Example: -c="config.js" OR
-c=config.js OR -c config.js
-s SRC_FOLDERS, --src_folders SRC_FOLDERS
Add your step definitions folder/s path, Example: -s="path/to/folder1"
OR -s="path/to/folder1 path/to/folder2", You can add as much as you
want of folder paths
-f FORMAT, --format FORMAT
Choose step definitions list format style, just add a number. (1)
stdout-space. (2) stdout-dashes. Example: -f=1 OR -f 2
"devDependencies" : { "chromedriver": "*" },
"devDependencies" : { "chromedriver": "*", "geckodriver": "*" }
Some errors must be fixed:
Example: When I reload the page
Example: And I reload the page
package.jsonFirst we need to add 2 files to the main root of the project:
1- .eslintrc.json file that contains rules of js code check
2- .eslintignore file that contains the path of files and folders out of check
Then in package.json add "eslint" libraries to install when yarn install
"eslint": "~8.0",d
"eslint-config-airbnb-base": "^15.0.0",
"eslint-plugin-import": "^2.25.4"
And in package.json add "lint:js" script
"lint:js": "node ./node_modules/eslint/bin/eslint.js --config=.eslintrc.json ." to lint js files
"lint:js-dl": "node ./node_modules/eslint/bin/eslint.js --config=.eslintrc.json bin/webship-js-dl", to lint webship-js-dl file which has no extension
"lint:js-di": "node ./node_modules/eslint/bin/eslint.js --config=.eslintrc.json bin/webship-js-di" to lint webship-js-di file which has no extension
Finally, check it on the terminal screen:
yarn lint:js
And
yarn lint:js --fix to fix basic errors
CLI arguments parser for node.js is different from the original (python) in some points:
1. JS has no keyword arguments support.
- Pass options instead: new ArgumentParser({ description: 'example', add_help: true }).
2. JS has no python's types int, float, ...
- Use string-typed names: .add_argument('-b', { type: 'int', help: 'help' }).
3. %r format specifier uses require('util').inspect().
https://github.com/nodeca/argparse
Example:
-h or --help will provide valuable help messages:
node ./bin/steplist --help
usage: steplist [-h] [-v] [-d DISPLAY_LIST_INFORMATION] [-c CONFIG] [-s SRC_FOLDERS] [-f FORMAT]
Argparse example
optional arguments:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-d DISPLAY_LIST_INFORMATION, --display-list-information DISPLAY_LIST_INFORMATION
Chose step definitions list to display with or without information. l: for normal
list, i: with information list. Example: -d="i" OR -d=i OR -d i
-c CONFIG, --config CONFIG
Add your nightwatch config file, Example: -c="config.js" OR -c=config.js OR -c
config.js
-s SRC_FOLDERS, --src_folders SRC_FOLDERS
Add your step definitions folder/s path, Example: -s="path/to/folder1" OR
-s="path/to/folder1 path/to/folder2", You can add as much as you want of folder
paths
-f FORMAT, --format FORMAT
Choose step definitions list format style, just add a number. (1) stdout-space.
(2) stdout-dashes. Example: -f=1 OR -f 2
Example for using arguments:
node ./bin/steplist -d l
Given I go to "([^"]*)?"
Then I should( not)* see "([^"]*)?"
node ./bin/steplist -d i
Given I go to "([^"]*)?"
Navigate to a url.
Exmaple:
- Given I go to "https://webship.co"
Then I should( not)* see "([^"]*)?"
Asserting a text in the page.
Exmaple:
- Then I should see "Welcome"
- Then I should not see "Access denied"
Some files were missing when installing "webship-js" as a package, which happened after adding the "bin" folder to collect
js commands files.
So this an experience to delete the "bin" directory, after changing multi commands into one keyword command and one file "steplist.js", and put it into package root.
Example: And I am on "https://webship.co"
Example: When I go to "https://webship.co"
Example: Given I am on "about-us.html"
This command returns the default step-definitions list.
$ node ./bin/webship-js-dl
$ node ./bin/webship-js-di // To return step-definitions list with information
And if you want to return your step-definitions list, just add your folder path to the command line.
$ node ./bin/webship-js-dl your/folder/path1 your/folder/path2
Example: Given I am on "/"
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.