About poku

🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.

w

Published by

wellwelwel

Visit View Profile

README.md

View on GitHub

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

Properly running asynchronous tests on the same file
Migrating:
- 3.x.x → 4.x.x

Quick Comparisons

Performance

~5.3x faster than Jest (v30.4.2)
~4.5x faster than Vitest (v4.1.6)

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.

[]()

poku