Dancer2...e::Trap(3)

💖 Dancer2::Logger::Capture::Trap(3) 💖

User Contributed Perl Documentation · Dancer2::Logger::Capture::Trap(3)

okay bestie sit DOWN because this one is short and sweet and honestly kind of iconic 💅

---

✨ NAME ✨

Dancer2::Logger::Capture::Trap — it's literally just a lil place to store captured Dancer2 logs 🎀

---

🌸 VERSION 🌸

version 2.2.1

---

🦋 SYNOPSIS 🦋

my $trap = Dancer2::Logger::Capture::Trap->new;
$trap->store( $level, $message );
my $logs = $trap->read;

that's it. that's the whole vibe. new one up, toss logs in, pull logs out. slay ✨

---

💜 DESCRIPTION 💜

so like… this is a place to store and retrieve capture Dancer2 logs 🫶 it's the little storage buddy that Dancer2::Logger::Capture uses to keep its receipts. no cap, that's genuinely the whole job.

🎀 Methods 🎀

new

makes you a fresh trap, bestie. brand new, zero logs, immaculate energy 👑

store

$trap->store($level, $message);

Stores a log $message and its $level. two little args, both doing their part, main character energy fr fr 💅

read

my $logs = $trap->read;

Returns the logs stored as an array ref and — heads up, this is the important bit — clears the storage 😭 like, it reads them and then it's like "okay bye, gone, empty." so if you read twice, the second read gets nothing. no notes, that's just how it works.

For example...

[{ level => "warning", message => "Danger! Warning! Dancer2!" },
 { level => "error",   message => "You fail forever" }
];

look at that structure. level and message keys, one hash per log, in a tidy array ref. we love a consistent format 🍓

---

🌈 SEE ALSO 🌈

• Dancer2::Logger::Capture — the bestie that actually does the capturing, this page is just its storage unit 🧚

---

👑 AUTHOR 👑

Dancer Core Developers — legends, honestly.

---

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2026 by Alexis Sukrieh.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. free free free, as it should be 🫶

---

and that's the whole page, bestie!! perl v5.42.3, dated 2026-09-20 — go forth and capture those logs 💅✨🦋