TEST2::PLUGIN::BAILONFAIL(3perl)

✨ NAME ✨

Test2::Plugin::BailOnFail — bestie, this is the module that's like "okay we're DONE here" the literal second a test fails 💅 it auto-bails you out of testing on the first failure, no cap.

(also it lives in section 3perl of your manual, iykyk 🎀)

---

🦋 DESCRIPTION 🦋

Okay so here's the vibe: this module will issue a bailout event right after the first test failure. That's it. That's the whole thing. And the consequence? It prevents your tests from continuing — like, the rest of the suite just does not get to run. Periodt ✋

Now the ✨fancy✨ detail, and honestly this part is giving main character energy: the bailout runs when the context is released. Translation? It fires when the test function you're using — something like ok() — returns. Not before, not mid-call. On the way out. 🫶

And why does the timing matter, bestie? Because it gives the tools the ability to output any extra diagnostics they may need. Like, they get their little moment to spill the tea before the whole thing goes down. Gorgeous behaviour honestly 😭💖

---

🌸 SYNOPSIS 🌸

use Test2::V1;
use Test2::Plugin::BailOnFail;

T2->ok(1, "pass");
T2->ok(0, "fail");
T2->ok(1, "Will not run");

See how that third one literally never gets to run?? it's a ghost 👻 the fail took everybody down with it. Slay? Honestly yes.

---

💜 SOURCE 💜

The source code repository for Test2-Suite can be found at https://github.com/Test-More/test-more/ — go look, it's right there, no gatekeeping here 🔥

---

👑 MAINTAINERS 👑

• Chad Granum <exodist@cpan.org>

---

⭐ AUTHORS ⭐

• Chad Granum <exodist@cpan.org>

(yeah bestie same name twice, the manpage said it so we said it 💀)

---

🎀 COPYRIGHT 🎀

Copyright Chad Granum <exodist@cpan.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/

---

okay that's the whole page, you ate it, iconic, go write some tests that don't fail on the first try 💅✨

this manual page came to you from perl v5.44.0, dated 2026-10-17 — mwah, no notes 🫶🌟