NAME

Mojo::Exception - Exceptions with context

SYNOPSIS

  use Mojo::Exception;

  my $e = Mojo::Exception->new;

Mojo::Exception is a container for exceptions with context information.

Mojo::Exception implements the following attributes.

  my $frames = $e->frames;
  $e         = $e->frames($frames);

Stacktrace.

  my $line = $e->line;
  $e       = $e->line([3, 'foo']);

The line where the exception occured.

  my $lines = $e->lines_after;
  $e        = $e->lines_after([[1, 'bar'], [2, 'baz']]);

Lines after the line where the exception occured.

  my $lines = $e->lines_before;
  $e        = $e->lines_before([[4, 'bar'], [5, 'baz']]);

Lines before the line where the exception occured.

  my $message = $e->message;
  $e          = $e->message('Oops!');

Exception message.

  my $message = $e->raw_message;
  $e          = $e->raw_message('Oops!');

Raw unprocessed exception message.

  my $verbose = $e->verbose;
  $e          = $e->verbose(1);

Activate verbose rendering, defaults to the value of MOJO_EXCEPTION_VERBOSE or 0.

Mojo::Exception inherits all methods from Mojo::Base and implements the following new ones.

  my $e = Mojo::Exception->new('Oops!');
  my $e = Mojo::Exception->new('Oops!', $files, $name);

Construct a new Mojo::Exception object.

  Mojo::Exception->throw('Oops!');
  Mojo::Exception->throw('Oops!', $files, $name);

Throw exception with stacktrace.

  my $string = $e->to_string;
  my $string = "$e";

Render exception with context.

  $e = $e->trace;
  $e = $e->trace(2);

Store stacktrace.