Observer

Observer is used for filtering and handling different events. That is part of internal API with some public methods and is recommended to don’t use methods is not listed here.

In aiogram framework is available two variants of observer:

• EventObserver

• TelegramEventObserver

EventObserver

class aiogram.dispatcher.event.event.EventObserver

Simple events observer

Is used for managing events is not related with Telegram (For example startup/shutdown processes)

Handlers can be registered via decorator or method

<observer>.register(my_handler)

@<observer>()
async def my_handler(*args, **kwargs): ...

register(callback: Callable[[...], Any]) → None

Register callback with filters

async trigger(*args: Any, **kwargs: Any) → None

Propagate event to handlers. Handler will be called when all its filters is pass.

__call__() → Callable[[Callable[[...], Any]], Callable[[...], Any]]

Decorator for registering event handlers

TelegramEventObserver

class aiogram.dispatcher.event.telegram.TelegramEventObserver(router: Router, event_name: str)

Event observer for Telegram events

Here you can register handler with filter. This observer will stop event propagation when first handler is pass.

register(callback: Callable[[...], Any], *filters: Callable[[...], Any], flags: Optional[Dict[str, Any]] = None, **kwargs: Any) → Callable[[...], Any]

Register event handler

async trigger(event: TelegramObject, **kwargs: Any) → Any

Propagate event to handlers and stops propagation on first match. Handler will be called when all its filters is pass.

__call__(*filters: Callable[[...], Any], flags: Optional[Dict[str, Any]] = None, **kwargs: Any) → Callable[[Callable[[...], Any]], Callable[[...], Any]]

Decorator for registering event handlers