aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/nav.ts3
-rw-r--r--docs/test/hot.md15
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">&quot;bun test --watch url&quot; in a large folder with multiple files that start with &quot;url&quot; <a href="https://t.co/aZV9BP4eFu">pic.twitter.com/aZV9BP4eFu</a></p>&mdash; 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 %}