ProjectHentai/nonebot2
6
0
Fork 0
mirror of https://github.com/nonebot/nonebot2.git synced 2025-11-04 00:46:43 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

📝 Docs: 添加钩子函数 IgnoredException 用法 (#2912)

Browse Source 
Co-authored-by: Ju4tCode <42488585+yanyongyu@users.noreply.github.com>
This commit is contained in:
paro
2024-08-21 23:23:56 +08:00
committed by GitHub
parent d1904ba156
commit 4b837343ff
4 changed files with 32 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
website/versioned_docs/version-2.3.2/advanced/runtime-hook.md
View File

@@ -82,14 +82,16 @@ async def do_something(bot: Bot):
### 事件预处理
这个钩子函数会在 NoneBot 接收到新的事件时运行。支持依赖注入，可以注入 `Bot` 对象、事件、会话状态。
这个钩子函数会在 NoneBot 接收到新的事件时运行。支持依赖注入，可以注入 `Bot` 对象、事件、会话状态。在这个钩子函数内抛出 `nonebot.exception.IgnoredException` 会使 NoneBot 忽略该事件。
```python
from nonebot.exception import IgnoredException
from nonebot.message import event_preprocessor
@event_preprocessor
async def do_something(event: Event):
pass
if not event.is_tome():
raise IgnoredException("some reason")
```
### 事件后处理
@@ -106,14 +108,16 @@ async def do_something(event: Event):
### 运行预处理
这个钩子函数会在 NoneBot 运行事件响应器前运行。支持依赖注入，可以注入 `Bot` 对象、事件、事件响应器、会话状态。
这个钩子函数会在 NoneBot 运行事件响应器前运行。支持依赖注入，可以注入 `Bot` 对象、事件、事件响应器、会话状态。在这个钩子函数内抛出 `nonebot.exception.IgnoredException` 也会使 NoneBot 忽略本次运行。
```python
from nonebot.message import run_preprocessor
from nonebot.exception import IgnoredException
@run_preprocessor
async def do_something(event: Event, matcher: Matcher):
pass
if not event.is_tome():
raise IgnoredException("some reason")
```
### 运行后处理