Mojo::IOLoop::EventEmitter

NAME
SYNOPSIS
DESCRIPTION
METHODS
DEBUGGING
SEE ALSO

NAME

Mojo::IOLoop::EventEmitter - IOLoop Event Emitter

SYNOPSIS

  use Mojo::IOLoop::EventEmitter;
     
  # Create new event emitter
  my $e = Mojo::IOLoop::EventEmitter->new;
     
  # Subscribe to events
  $e->on(error => sub {
    my ($self, $error) = @_;
    warn "Catched: $error";
  });
  $e->on(test => sub {
    my ($self, $message) = @_;
    die "test: $message";
  });
     
  # Emit events
  $e->emit(test => 'Hello!');

DESCRIPTION

Mojo::IOLoop::EventEmitter is the event emitter used by Mojo::IOLoop. Note that this module is EXPERIMENTAL and might change without warning!

METHODS

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

emit

  $e->emit('foo');
  $e->emit('foo', 123);

Emit event.

on

  my $cb = $e->on(foo => sub {...});

Subscribe to event.

once

  my $cb = $e->once(foo => sub {...});

Subscribe to event and unsubscribe again after it has been emitted once.

subscribers

  my $subscribers = $e->subscribers('foo');

All subscribers for event.

unsubscribe

  $e->unsubscribe(foo => $cb);

Unsubscribe from event.

DEBUGGING

You can set the MOJO_EVENTEMITTER_DEBUG environment variable to get some advanced diagnostics information printed to STDERR.

  MOJO_EVENTEMITTER_DEBUG=1