Enjoying Poku? Give him a star to show your support 🌟
🐷 Website • 📘 Documentation • 🧪 Examples • 🧑🏻🎓 Tutorials
💡 Poku is a cross-platform test runner that brings the JavaScript essence back to testing.
High isolation level per file
Performant and lightweight
Auto detect ESM, CJS, and TypeScript files
Run the same test suite for Node.js, Bun, and Deno
Easily handle servers, processes, ports, and even containers ✨
# Node.js
npm i -D poku |
# TypeScript (Node.js)
npm i -D poku tsx |
# Bun
bun add -d poku |
# Deno (optional)
deno add npm:poku |
test/file.test.mjs |
import { assert } from 'poku';
assert(true, 'Poku will describe it 🐷'); |
Node.js (and TypeScript) |
Bun |
Deno |
npx poku |
bun poku |
deno run npm:poku |
| poku | 🧪 Test runner |
| assert • strict | 🔬 Test assertion (Node.js familiar API) |
| test • describe • it | 🤹🏻♀️ Organize, group, and isolate tests |
| envFile | ⚙️ Process an environment file (out-of-box) |
| beforeEach • afterEach | 🃏 Hooks for test setup and teardown |
| startScript • startService | 🌐 Run package.json scripts and files in background |
| docker | 🐳 Build, start, compose, stop, remove, and test containers |
| kill | 🔌 Terminate ports, port ranges, and PIDs |
| waitForPort | 😴 Wait for specified ports to become active |
| waitForExpectedResult | 🥱 Retry until an expected result or times out |
| skip | ⏭️ Skip tests when necessary |
| only | 🌌 Debug tests by enabling selective runs |
| coverage | ☔️ Enable coverage collection using a coverage plugin |
| config | ⚙️ Customize your Poku options in a config file |
| watch | 🍿 Watch for changes and re-run related test files |
| debug | 🕵🏻 Shows all logs |
and much more 👇🏻
To see the detailed documentation, please visit the Documentation and Examples sections in the Poku's website. Poku also offers mini-lessons for different users needs in the Quick Tutorials section.
- Avoiding conflicts in environments with multiple platforms installed
- Properly running asynchronous tests on the same file
- Using Poku without installing it on Deno
- Migrating:
Poku is continuously tested to ensure the following average expectations for basic usage:
- You can see how the tests are run and compared in the benchmark directory.
- ~145x lighter than Jest
- ~124x lighter than Vitest
- ~83x lighter than AVA
- ~47x lighter than Mocha
- ~2.8x lighter than uvu
Poku size ensures cost-saving CI for services that charge for storage and usage.
Please check the SECURITY.md.
See the Contributing Guide and please follow our Code of Conduct 🚀
My thanks to everyone who has dedicated their time and effort to improving Poku.
Really thanks to everyone who has supported and keeps supporting my work.
Also for the private ones, who don't appear here 🕵
Poku is under the MIT License.
Copyright © 2024-present Weslley Araújo and contributors.