https://github.com/hazae41/phobos
Modern and minimalist testing library for the web
https://github.com/hazae41/phobos
asynchronous browser concurrency deno esmodules fast javascript minimalist parallel-computing testing typescript unit-testing web
Last synced: 17 days ago
JSON representation
Modern and minimalist testing library for the web
- Host: GitHub
- URL: https://github.com/hazae41/phobos
- Owner: hazae41
- License: mit
- Created: 2022-12-11T12:55:02.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-10-25T10:49:33.000Z (7 months ago)
- Last Synced: 2025-10-28T20:51:36.423Z (7 months ago)
- Topics: asynchronous, browser, concurrency, deno, esmodules, fast, javascript, minimalist, parallel-computing, testing, typescript, unit-testing, web
- Language: TypeScript
- Homepage:
- Size: 254 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
Modern and minimalist testing library
```bash
npm install @hazae41/phobos
```
```bash
deno install jsr:@hazae41/phobos
```
[**📦 NPM**](https://www.npmjs.com/package/@hazae41/phobos) • [**📦 JSR**](https://jsr.io/@hazae41/phobos)
## Philosophy 🧠
Phobos aims to be minimalist and to always work no matter the:
- runtime (Node, Deno, browser)
- module resolution (ESM, CommonJS)
- language (TypeScript, JavaScript)
- bundler (Rollup, Vite)
It's just a library you can import everywhere! That's it, no CLI, no configuration file, just JavaScript.
## Features 🔥
### Current features
- 100% TypeScript and ESM
- No external dependency
- Unit tested (by itself)
- Runnable in the browser
- Minimalist assertion helpers
- Asynchronous fork-join parallelism
- Function calls spying
## Usage 🚀
```typescript
import { assert, test } from "@hazae41/phobos"
test("it should work", () => {
assert(false, "oh no")
})
```
### Concurrent tests
Test blocks are always executed concurrently, unless you `await` them
```typescript
import { assert, test } from "@hazae41/phobos"
test("it should work", async ({ test }) => {
// run in sequence
await test("first test", async () => {
assert(true, "should be true")
})
// or in parallel
test("second test", async () => {
assert(true, "should be true")
})
})
```
You can also use `await Promise.all(...)` to forcefully join
```typescript
import { assert, test } from "@hazae41/phobos"
test("it should work", async ({ test }) => {
const tests = []
tests.push(test("first test", async () => {
assert(true, "should be true")
}))
tests.push(test("second test", async () => {
assert(true, "should be true")
}))
// wait first and second tests
await Promise.all(tests)
tests.push(test("third test", async () => {
assert(true, "should be true")
}))
// wait last test
await Promise.all(tests)
})
```
### Spying function calls
You can spy on function calls using `spy(function)`
You can then `.call()` it and get a list of all its `.calls`
```typescript
import { assert, test, spy } from "@hazae41/phobos"
test("it should work", async () => {
const f = spy((param: boolean) => !param)
const result = f.call(true)
assert(result === false, `result should be false`)
assert(f.calls.length === 1, `should have been called 1 time`)
assert(f.calls[0].params[0] === true, `should have been called with true`)
assert(f.calls[0].result === false, `should have resulted in false`)
})
```
## Running 🏎️
#### Node
```bash
node --test --test-concurrency=1 ./out/**/*.test.js
```
#### Deno
```bash
deno test ./src/**/*.test.ts
```
#### Other
```typescript
await import("./mymodule.test.ts")
```