diff options
-rw-r--r-- | docs/nav.ts | 3 | ||||
-rw-r--r-- | docs/test/hot.md | 15 |
2 files changed, 18 insertions, 0 deletions
diff --git a/docs/nav.ts b/docs/nav.ts index 22640be2e..8ddced819 100644 --- a/docs/nav.ts +++ b/docs/nav.ts @@ -184,6 +184,9 @@ export default { page("test/extending", "Extending the test runner", { description: "Add lifecycle hooks to your tests that run before/after each test, or before/after all tests.", }), + page("test/hot", "Watch mode", { + description: "Reload your tests automatically on change.", + }), divider("Package runner"), page("cli/bunx", "`bunx`", { diff --git a/docs/test/hot.md b/docs/test/hot.md new file mode 100644 index 000000000..a7604f3e5 --- /dev/null +++ b/docs/test/hot.md @@ -0,0 +1,15 @@ +To automatically re-run tests when files change, use the `--watch` flag: + +```sh +$ bun test --watch +``` + +Bun will watch for changes to any files imported in a test file, and re-run tests when a change is detected. + +It's fast. + +{% raw %} + +<blockquote class="twitter-tweet"><p lang="en" dir="ltr">"bun test --watch url" in a large folder with multiple files that start with "url" <a href="https://t.co/aZV9BP4eFu">pic.twitter.com/aZV9BP4eFu</a></p>— Jarred Sumner (@jarredsumner) <a href="https://twitter.com/jarredsumner/status/1640890850535436288?ref_src=twsrc%5Etfw">March 29, 2023</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script> + +{% /raw %} |