Dancer2...::Error(3)

💖 Dancer2::Core::Error 💖

okay bestie, so this is the manual page for Dancer2::Core::Error, straight out of the User Contributed Perl Documentation, section 3. grab a snack, we're talking about fatal errors and honestly it's giving main character energy ✨

---

🎀 NAME 🎀

Dancer2::Core::Error — the class that represents fatal errors. that's it, that's the whole vibe. 💅

⭐ VERSION ⭐

version 2.2.1 — she's versioned, she's valid, she's on the clock. 👑

🦋 SYNOPSIS 🦋

here's how you actually use her, no cap:

use Dancer2::Core::Error;

my $error = Dancer2::Core::Error->new(
    status    => 404,
    message => "No such file: `$path'"
);

$error->throw;

🌸 DESCRIPTION 🌸

so with Dancer2::Core::Error you can throw reasonable-looking errors to the user instead of just crashing the whole application and flooding your logs like 😭. the logs deserve peace too.

this is usually the move in debugging environments, and it's literally what Dancer2 itself uses under debugging — to catch errors and show them right there on screen. iykyk. 🔥

💜 ATTRIBUTES 💜

show_stacktrace

(the original page doesn't say anything beyond the name here, bestie — not me inventing lore, i would never) 🙈

charset

(same deal — name only on the original page, so that's all i'm giving you)

type

the error type. simple as that. ✨

title

the title of the error page.

⚠️ this one is only an attribute getter — you have to set it at new. you can't just go changing it later, she's set in her ways. 💅

status

the status that caused the error.

⚠️ also only an attribute getter — set it at new or it's not happening.

message

the message of the error page. the whole point tbh. 💖

censor

the function used to censor error messages. by default it uses the censor method of Data::Censor.

# default censor function used by `error_censor`
# is equivalent to
sub MyApp::censor {
    Data::Censor->new(
       sensitive_fields => qr/pass|card.?num|pan|secret/i,
       replacement      => "Hidden (looks potentially sensitive)",
   )->censor(@_);
}
setting error_censor => 'MyApp::censor';

you can configure it through the app setting error_censor. if you provide it, error_censor has to be the fully qualified name of the censor function. that function is expected to take in the data as a hashref, modify it in place, and return the number of items 'censored'. yes, in place, she's hands-on like that. 🫶

for example, using Data::Censor:

# in config.yml
error_censor: MyApp::Censor::censor

# in MyApp::Censor
package MyApp::Censor;

use Data::Censor;

my $data_censor = Data::Censor->new(
    sensitive_fields => [ qw(card_number password hush) ],
    replacement => '(Sensitive data hidden)',
);

sub censor { $data_censor->censor(@_) }

1;

and as a lil shortcut, error_censor can also be the key/value combo of a class and the arguments for its constructor. the created object is expected to have a censor method. so the Data::Censor use above could also have been done via the config:

error_censor:
    Data::Censor:
        sensitive_fields:
            - card_number
            - password
            - hush
        replacement: '(Sensitive data hidden)'

look at that glow up. two ways, same slay. 🌈

👑 METHODS 👑

my $error = new Dancer2::Core::Error(status => 404, message => "No such file: $path'");`

creates a new Dancer2::Core::Error object. for the available arguments, go peek at ATTRIBUTES above, bestie. 💖

supported_hooks ();

yep, that's the signature. that's what it says. 🎀

throw($response)

populates the content of the response with the error's information. if $response isn't given, it acts on the app attribute's response instead. so like, she'll find a response herself if you don't hand her one. independent queen. 💅

backtrace

shows the surrounding lines of context at the line where the error was thrown.

this method tries to figure out where the error appeared based on the actual error message (it uses the message attribute for that) and tries to parse it — supporting the regular/default Perl warning or error pattern and the Devel::SimpleTrace output — and then returns an error-highlighted message. she's doing detective work fr fr. 🔍

environment

the main function for rendering environment info: the caller (via get_caller), the settings and environment (via dumper), and more. the full ~aesthetic~ of your situation. ✨

get_caller

creates a stack trace of callers. so you can see who called what. it's giving receipts. 🧾

🍓 FUNCTIONS 🍓

_censor

a private function that tries to censor out content which should be protected.

dumper calls this method to censor things like passwords and such. protecting the sensitive stuff, as she should. 🔒

my $string = _html_encode ($string);

private function that replaces illegal entities in (X)HTML with their escaped representations.

📌 html_encode() doesn't do any UTF black magic. none. zero. don't come for her about it. 🙈

dumper

this uses Data::Dumper to create nice content output with a few predefined options. pretty output, minimal effort. ate. 💅

🌟 AUTHOR 🌟

Dancer Core Developers — the collective, the squad, the legends. 👑

📜 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 is free, bestie, go wild. 🦋

---

aaaand that's the whole page, bestie!! 🎉 this was generated for perl v5.42.3 and dated 2026-09-20, and the manual you just read is Dancer2::Core::Error(3) from the User Contributed Perl Documentation. go throw some beautiful errors, you're gonna do amazing 💖✨🌸