aboutsummaryrefslogtreecommitdiffstats
path: root/tests/README.txt
diff options
context:
space:
mode:
authorSawyer Bergeron <sbergeron@iol.unh.edu>2019-07-17 18:46:32 +0000
committerGerrit Code Review <gerrit@opnfv.org>2019-07-17 18:46:32 +0000
commitf98db8c551f6f626e2220d62ba6170920eba5ef7 (patch)
tree05a7e3d235a2692fefa53b994f5e36699d242486 /tests/README.txt
parentdd57fb4f248e2832c7e05e9a20002bfa2a402412 (diff)
parent0aba5286824d653f95a6454de0fbf91d4a5410b8 (diff)
Merge "LAAS-44: Unit Test Javascript"
Diffstat (limited to 'tests/README.txt')
-rw-r--r--tests/README.txt32
1 files changed, 32 insertions, 0 deletions
diff --git a/tests/README.txt b/tests/README.txt
new file mode 100644
index 0000000..4085be7
--- /dev/null
+++ b/tests/README.txt
@@ -0,0 +1,32 @@
+This folder contains the tools needed to unit test the frontend
+JavaScript files using Karma, Mocha, and Chai.
+
+
+Getting started:
+Install NPM if you haven't:
+https://nodejs.org/en/download/package-manager/
+
+Run 'npm install' to install all required dependencies in this
+folder.
+
+Run 'npm test' to run current unit tests.
+
+
+Adding tests:
+Tests are located in the tests/ folder, you can simply edit the
+existing ones or create a new one by making a file with the .js
+file extension.
+
+Karma is used for launching different browsers to run JavaScript.
+See Karma documentation at https://karma-runner.github.io/
+to add more browsers, files to test, or frameworks.
+
+Mocha is used for the structure of the JavaScript testing itself.
+See Mocha documentation at https://mochajs.org/ to see the syntax
+required to create/modify tests. Currently, the tests use the
+'TDD' interface from Mocha.
+
+Chai is used for the actual testing, with it being an assertion
+library. See Chai documentation at https://www.chaijs.com/ to see
+the available usages for assertion. The tests use the 'assert' API
+along with Mocha's TDD interface.