nonebot2/website/versioned_docs/version-2.4.1/api/message.md

mdx	sidebar_position	description
format md	2	nonebot.message 模块

nonebot.message

本模块定义了事件处理主要流程。

NoneBot 内部处理并按优先级分发事件给所有事件响应器，提供了多个插槽以进行事件的预处理等。

def event_preprocessor(func)

• 说明

  事件预处理。

  装饰一个函数，使它在每次接收到事件并分发给各响应器之前执行。

• 参数

  • func (T_EventPreProcessor)

• 返回

  • T_EventPreProcessor

def event_postprocessor(func)

• 说明

  事件后处理。

  装饰一个函数，使它在每次接收到事件并分发给各响应器之后执行。

• 参数

  • func (T_EventPostProcessor)

• 返回

  • T_EventPostProcessor

def run_preprocessor(func)

• 说明

  运行预处理。

  装饰一个函数，使它在每次事件响应器运行前执行。

• 参数

  • func (T_RunPreProcessor)

• 返回

  • T_RunPreProcessor

def run_postprocessor(func)

• 说明

  运行后处理。

  装饰一个函数，使它在每次事件响应器运行后执行。

• 参数

  • func (T_RunPostProcessor)

• 返回

  • T_RunPostProcessor

async def check_and_run_matcher(Matcher, bot, event, state, stack=None, dependency_cache=None)

• 说明: 检查并运行事件响应器。

• 参数

  • Matcher (type[Matcher]): 事件响应器

  • bot (Bot): Bot 对象

  • event (Event): Event 对象

  • state (T_State): 会话状态

  • stack (AsyncExitStack | None): 异步上下文栈

  • dependency_cache (T_DependencyCache | None): 依赖缓存

• 返回

  • None

async def handle_event(bot, event)

• 说明: 处理一个事件。调用该函数以实现分发事件。

• 参数

  • bot (Bot): Bot 对象

  • event (Event): Event 对象

• 返回

  • None

• 用法

  driver.task_group.start_soon(handle_event, bot, event)