Poku
🐷 Poku brings human-friendly testing and assertion to Node.js, Bun & Deno at the same time.
Notifications
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
Run CommonJS files directly with Deno
Auto detect ESM, CJS, and TypeScript files
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
deno add npm:poku
Test
test/file.test.mjs |
|
Run
Node.js (and TypeScript) | Bun | Deno |
|
|
|
Features
Essentials
| poku | 🧪 Test runner. |
| assert | 🔍 Test assertion (Node.js familiar API). |
| strict | 🔬 Strict test assertion (Node.js familiar API). |
Helpers
| 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 | 🌐 Run package.json scripts in background. |
| startService | 🌐 Run 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. |
| getPIDs | 🕵🏻 Debug processes IDs using ports and port ranges. |
Common Options
| watch | 🍿 Watch for changes and re-run related test files. |
| parallel | 🏃🏻♀️ Run tests in parallel. |
| debug | 🕵🏻 Shows all logs. |
| config | ⚙️ Customize your Poku options in a config file. |
and much more 👇🏻
Documentation and Examples
To see the detailed documentation, please visit the Documentation and Examples sections in the Poku's website.
Tutorials
Poku offers mini-lessons for different users needs in the Quick Tutorials section.
Common Issues
- Avoiding conflicts in environments with multiple platforms installed.
- Properly running asynchronous tests on the same file.
- Migrating from version 1.x to version 2.x.
- Using Poku without installing on Deno and alternatives to JSR.
Quick Comparisons
Performance
Poku is continuously tested to ensure the following expectations for basic usage:
- >=4x faster than Jest (v29.7.0)
- >=3x faster than Vitest (v1.6.0)
- >=1x faster than Mocha (v10.4.0) + Chai (v5.1.1)
You can see how the tests are run and compared in the benchmark directory.
Installation Size
Poku size is highly significant in development to ensure cost-saving CI that require servers 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
License
Poku is under the MIT License.
Copyright © 2024-present Weslley Araújo and Poku contributors.