From 0aba5286824d653f95a6454de0fbf91d4a5410b8 Mon Sep 17 00:00:00 2001 From: Brandon Lo Date: Thu, 11 Jul 2019 09:49:11 -0400 Subject: LAAS-44: Unit Test Javascript Add Karma, Mocha, and Chai NPM packages to allow for browser based front-end JavaScript testing. Not all functions are tested, but a lot of the required behavior is. This allows for new JS unit tests in future patches. Change-Id: I2ac2a865ed3a458d8f5ebdeb7c2b4defda24fd41 Signed-off-by: Brandon Lo --- tests/README.txt | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 tests/README.txt (limited to 'tests/README.txt') 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. -- cgit 1.2.3-korg