🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.
Poku
Enjoying Poku? Give him a star to show your support 🌟
🐷 Website • 📘 Documentation • 🧪 Examples • 🧑🏻🎓 Tutorials
Why does Poku exist?
💡 Poku is a cross-platform test runner that brings the JavaScript essence back to testing.
High isolation level per file
Performant and lightweight
Support for ESM, CJS, and TypeScript
Plugin ecosystem for custom and official plugins
Run the same test suite for Node.js, Bun, and Deno
Easily handle servers, processes, ports, and containers ✨
Quickstart
Install
🐢 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
import { assert } from 'poku';
assert(true, 'Poku will describe it 🐷');
Run
Node.js (and TypeScript)
npx poku
Bun
bun --bun poku
Deno
deno run npm:poku
Features
Essentials
| poku | 🧪 Test runner |
| assert • strict | 🔬 Test assertion (Node.js familiar API) |
Common Helpers and Options
| test • describe • it | 🤹🏻♀️ Organize, group, and isolate tests |
| envFile | ⚙️ Process an environment file |
| beforeEach • afterEach | 🃏 Hooks for test setup and teardown |
| startScript • startService | 🌐 Run scripts and files in background |
| docker | 🐳 Build, start, compose, stop, and remove 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 |
| config | ⚙️ Customize your Poku |
| watch | 🍿 Watch for changes and re-run related test files |
| debug | 🕵🏻 Shows all logs |
- and much more 🔥
FAQ
Quick Comparisons
Performance
- You can see how the tests are run and compared in the benchmark directory.
Installation Size
Poku size ensures cost-saving CI for services that charge for storage and usage.
Security Policy
Please check the SECURITY.md.
Contributing
See the Contributing Guide and please follow our Code of Conduct 🚀
Acknowledgements
Contributors
My thanks to everyone who has dedicated their time and effort to improving Poku.
Sponsors
Really thanks to everyone who has supported and keeps supporting my work.
License
Poku is under the MIT License.
Copyright © 2024-present Weslley Araújo and contributors.