Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/singleware/testing
Test automation package.
https://github.com/singleware/testing
async browser javascript nodejs test-automation testing typescript unittest
Last synced: about 2 months ago
JSON representation
Test automation package.
- Host: GitHub
- URL: https://github.com/singleware/testing
- Owner: Singleware
- License: mit
- Created: 2019-02-15T21:16:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-04-13T17:10:03.000Z (over 5 years ago)
- Last Synced: 2024-04-24T19:04:21.361Z (9 months ago)
- Topics: async, browser, javascript, nodejs, test-automation, testing, typescript, unittest
- Language: JavaScript
- Size: 34.2 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Testing
This package provides a simple way to automate your test scripts.
## How to use
First you need to create your test case, all test cases must extends the library test case, see below
```ts
import * as Class from '@singleware/class';
import * as Testing from '@singleware/testing';
@Class.Describe()
export class MyTestCase extends Testing.Case {
@Class.Public()
@Testing.Method()
public testMethod(): void {
// Assertions here...
}
}
```
After you need to create the suite runner, the suite runner script can be similar the code below
```ts
import * as Testing from '@singleware/testing';
import { MyTestCase } from './mytestcase.spec';
const suite = new Testing.Suite();
suite.addCase(MyTestCase);
suite.perform().then((report: Testing.Report.Suite) => {
const logger = new Testing.Loggers.Tap();
logger.print(report);
process.exitCode = report.errors > 0 ? 1 : 0;
});
```
> For browser compatibility, remove the line `process.exitCode`
Now you are ready to add assertions in your test case, you can add as many assertions as you want, after that you just need to build and run the suite script like any JavaScript file.
## Assertions
The package provides a collection of assertion methods to help you to test expected values and put its results in the report object. Any assertion method can be accessed by the test case instance using the keyword `this`.
| Name | Description |
| -------------------- | -------------------------------------------------------------------------------- |
| isTrue | Determines whether the specified condition is true. |
| isFalse | Determines whether the specified condition is false. |
| isNaN | Determines whether the specified value is NaN. |
| isNull | Determines whether the specified value is null. |
| isInfinite | Determines whether the specified value is infinite. |
| isUndefined | Determines whether the specified value is undefined. |
| isEmpty | Determines whether the specified value is empty. |
| isBoolean | Determines whether the specified value is a boolean type. |
| isString | Determines whether the specified value is a string type. |
| isNumber | Determines whether the specified value is a number type. |
| isArray | Determines whether the specified value is an array type. |
| isInstanceOf | Determines whether the specified value is an instance of the expected type. |
| isGreaterThan | Determines whether the actual is greater than the expected value. |
| isGreaterThanOrEqual | Determines whether the actual value is greater than or equal the expected value. |
| isLessThan | Determines whether the actual value is less than the expected value. |
| isLessThanOrEqual | Determines whether the actual value is less than or equal the expected value. |
| areEquals | Determines whether the specified values are equals. |
| areNotEquals | Determines whether the specified values are not equals. |
| areSame | Determines whether the specified values and types are the same. |
| areNotSame | Determines whether the specified values and types are not the same. |
| hasIndex | Determines whether the specified array has the expected index. |
| hasProperty | Determines whether the specified object has the expected property. |
| hasMethod | Determines whether the specified object has the expected method. |
| hasValue | Determines whether the specified array contains the given value. |
| hasOnly | Determines whether the specified array contains only the expected value. |
| hasException | Determines whether the specified callback throws an expected exception. |
## Report
After performing all test cases, the library will generates a report object that can be converted to multiple output formats, you can check the `Loggers` namespace to see which output formats are available for your current version.
## Install
Using npm:
```sh
npm i @singleware/testing
```
## License
[MIT © Silas B. Domingos](https://balmante.eti.br)