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 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 ✨

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

npx poku

bun poku

deno run npm:poku

Features

Essentials

Helpers

Common Options

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 (FAQ)

• Avoiding conflicts in environments with multiple platforms installed.
• Properly running asynchronous tests on the same file.
• Using Poku without installing it on Deno.
• Migrating:
  • From version 3.x.x to version 4.x.x.
  • From version 2.x.x to version 3.x.x.
  • From version 1.x.x to version 2.x.x.

Quick Comparisons

Performance

Poku is continuously tested to ensure the following average expectations for basic usage:

• ~4.6x faster than Jest (v30.2.0)
• ~3.5x faster than Vitest (v4.0.8)
• ~1.4x faster than Mocha (v11.7.5) — even with test file isolation 🚀

• You can see how the tests are run and compared in the benchmark directory.
• Comparing Poku and native test runners (discussion).

Installation Size

• ~206x lighter than Vitest
• ~165x lighter than Jest
• ~52x lighter than Mocha

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.

Also for the private ones, who don't appear here 🕵

License

Poku is under the MIT License. Copyright © 2024-present Weslley Araújo and Poku contributors.