@olton/latte
Version:
Simple test framework for JavaScript and TypeScript with DOM supports
188 lines (138 loc) • 4.6 kB
Markdown
<div align="center">
# 🥛 Latte
[](https://www.npmjs.com/package/@olton/latte)
[](https://opensource.org/licenses/MIT)
[](https://standardjs.com)
Latte (an abbreviation from `laconic testing`) is a testing framework designed for testing applications written in JavaScript and TypeScript.
</div>
---
<div align="center">
### **It is designed to be straightforward to use, with a focus on speed, performance, and user information.**
</div>
---
Latte is an alternative to other testing frameworks like Jest, Mocha, and Jasmine with the following **core features:**
- Config free.
- Functions for creating test cases `it`, `test`, `describe`, `suite` or `expect`.
- Setup and Teardown functions `beforeEach`, `afterEach`, `beforeAll`, `afterAll`.
- React Components testing (`jsx` syntax supported).
- HTML Components testing (DOM built-in).
- Headless browser in scope `B` for test web pages and remote saites.
- Asynchronous code testing with `async/await`.
- Mock functions.
- Big set (100+) of built-in matchers.
- TypeScript testing out of the box. You can use both `js` and `ts` test files in the same project.
- Simple extend `Expect` class for adding your matchers.
- A lot of expects in one test case.
- Built-in coverage tool.
- `Verbose`, `Watching` and `Debug` mode.
- Different Reporters: `lcov`, `console`, `html`, and `junit`.
- Open source and MIT license.
---
<div align="center">
Documentation: https://latte.org.ua/
</div>
---
<div align="center">
</div>
<div align="center">
## Quick Reference
</div>
### Installation
```bash
npm install @olton/latte -D
```
### Usage
#### IntelliJ plugin
You can use Latte with IntelliJ IDEA, WebStorm, PhpStorm, and other JetBrains IDEs. The plugin is available in the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/27190-latte-test-runner).
#### Command line
Create a test file with `*.test.js` or `*.test.ts` extension (for example).
You can use both of them in the same project.
```js
function hello() {
return "Hello"
}
describe(`Common tests suite`, () => {
it(`says hello`, () => {
return expect(hello()).toBe("Hello")
})
})
test(`Bad test 2 !== 1`, () => {
return expect(2).toBe(1)
})
```
Update `package.json` to run tests with `latte` command.
```json
{
"scripts": {
"test": "latte"
}
}
```
#### Run tests
Now you can run tests with the following command:
```bash
npm test
```
or with `npx`:
```bash
npx latte
```
### Functions
- `describe` – create a test suite
- `it` - create a test case in suite
- `test` - create standalone test
- `expect` - create assertion
- `beforeEach` - run before each test case
- `afterEach` - run after each test case
- `beforeAll` - run before all test cases
- `afterAll` - run after all test cases
- `mock` - create mock function
### Matchers
Latte contains a big set of built-in matchers:
- A simple comparison
- A strong comparison
- Type checking
- Number checking
- String checking
- Array checking
- Object checking
- Color checking
- IP, Email, Url checking
- JSON, XML checking
- Date, RegExp, Symbol checking
- Function checking
- HTML element checking
- and more...
### TypeScript
To use `Latte` with TypeScript you need to install `tsx` package.
```bash
npm install -D tsx cross-env
```
and then
```json
{
"scripts": {
"test": "cross-env NODE_OPTIONS=\"--import tsx\" latte"
}
}
```
## License
Latte licensed under MIT license.
## Contributing
### Bug Reports & Feature Requests
Use issue tracker to report bugs or request new features.
---
### Code Standards
[](https://github.com/standard/standard)
---
## Support
If you like this project, please consider supporting it by:
+ Star this repository on GitHub
+ Sponsor this project on GitHub Sponsors
+ **PayPal** to `serhii@pimenov.com.ua`.
+ [**Patreon**](https://www.patreon.com/metroui)
+ [**Buy me a coffee**](https://buymeacoffee.com/pimenov)
---
Copyright (c) 2025 by [Serhii Pimenov](https://pimenov.com.ua)