Test JS

About Test JS

This is a test class for JavaScript with simple use. You insert the clsTest.js files into your html file, where you want to run the tests.

<script src="https://mo-hi.github.io/testJS/clsTest.js"></script>

Create a new instance of the clsTest class and call the Init() function to initialize the test cases. All your test cases are automatically identified in your project by their function name prefix. So make sure to use a unique prefix for your test cases to avoid conflicts.

The default prefix is testCases_ but you can change it to any other prefix you want. The test cases can be anywhere in your project but must be defined at a global scope. Best practice is to have them in a separate JavaScript file typically named testCases_*.js.

let myTests = new clsTest()
myTests = clsTest.Init({prefix: 'testCase_'})
// or shorter
let myTests = clsTest.Init({prefix: 'testCase_'})

//check if it worked
console.log(myTests.testFunctions);

Run() the tests.

myTests.Run()

//check the results
console.log(myTests.testResults)

ShowTestResult() to show the results in the console or in a separate popup window. The default is 'console' but you can also use 'popup' to show the results in a popup window.

myTests.ShowTestResult() 

// or show the results in a popup window
myTests.ShowTestResult('popup')

Special Feature for ShowTestResult('popup'):
You can add your custom css,html and script to the popup window by setting the customCSS, customHTML_BeforeTable, customHTML_AfterTable, and customScript properties of the clsTest.popup instance.

myTests.popup.customCSS = 'body { background-color: lightblue; }'
myTests.popup.customHTML_BeforeTable = '<h1>My Test Results</h1>'
myTests.popup.customHTML_AfterTable = '<p>This is a custom message after the table.</p>'
myTests.popup.customScript = 'console.log("This is a custom script in the popup window");'

DownloadTestResult() to save the results to a file with a different file name.

myTests.DownloadTestResult() 

// or specify a different file name
myTests.DownloadTestResult('my-test-results.json')

Unit Tests

Unit tests are a way to test individual functions or methods in your code. Unit test are for functions that:

don't require any external dependencies and can be run in isolation.
don't require or simulate any user interaction.
They are usually small and focused on a single piece of functionality.

For example for the followingfunctions:

you can create the following unit tests. The reuqimrents must be met:

the test case name has to start with your defined prefix (here 'testCase_')
the test case function must take the test instance as its only parameter (here: 'myTest')
test methods must be called with the following parameters:

actual value: you can directly pass here the function incl. parameters you want to test
expected value: what the expected result should be
function name: the name of the function being tested
test case name: the name of the test or a comment for the test. This is different from the test case name, which is the name of the whole test function (here 'testCase_addition')