nonebot2/website/versioned_docs/version-2.0.0-beta.3/api/params.md

---
sidebar_position: 4
description: nonebot.params 模块
---

# nonebot.params

本模块定义了依赖注入的各类参数。

## _def_ `Arg(key=None)` {#Arg}

- **说明**

  `got` 的 Arg 参数消息

- **参数**

  - `key` (str | None)

- **返回**

  - Any

## _def_ `State()` {#State}

- **说明**

  **Deprecated**: 事件处理状态参数，请直接使用 [T_State](./typing.md#T_State)

- **返回**

  - dict[Any, Any]

## _def_ `ArgStr(key=None)` {#ArgStr}

- **说明**

  `got` 的 Arg 参数消息文本

- **参数**

  - `key` (str | None)

- **返回**

  - str

## _def_ `Depends(dependency=None, *, use_cache=True)` {#Depends}

- **说明**

  子依赖装饰器

- **参数**

  - `dependency` ((\*Any, \*\*Any) -> Any | None): 依赖函数。默认为参数的类型注释。

  - `use_cache` (bool): 是否使用缓存。默认为 `True`。

- **返回**

  - Any

- **用法**

  ```python
  def depend_func() -> Any:
      return ...

  def depend_gen_func():
      try:
          yield ...
      finally:
          ...

  async def handler(param_name: Any = Depends(depend_func), gen: Any = Depends(depend_gen_func)):
      ...
  ```

## _class_ `ArgParam(default=PydanticUndefined, **kwargs)` {#ArgParam}

- **说明**

  `got` 的 Arg 参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _class_ `BotParam(default=PydanticUndefined, **kwargs)` {#BotParam}

- **说明**

  [Bot](./adapters/index.md#Bot) 参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _class_ `EventParam(default=PydanticUndefined, **kwargs)` {#EventParam}

- **说明**

  [Event](./adapters/index.md#Event) 参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _class_ `StateParam(default=PydanticUndefined, **kwargs)` {#StateParam}

- **说明**

  事件处理状态参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _class_ `DependParam(default=PydanticUndefined, **kwargs)` {#DependParam}

- **说明**

  子依赖参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _def_ `ArgPlainText(key=None)` {#ArgPlainText}

- **说明**

  `got` 的 Arg 参数消息纯文本

- **参数**

  - `key` (str | None)

- **返回**

  - str

## _class_ `DefaultParam(default=PydanticUndefined, **kwargs)` {#DefaultParam}

- **说明**

  默认值参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _class_ `MatcherParam(default=PydanticUndefined, **kwargs)` {#MatcherParam}

- **说明**

  事件响应器实例参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _class_ `ExceptionParam(default=PydanticUndefined, **kwargs)` {#ExceptionParam}

- **说明**

  `run_postprocessor` 的异常参数

- **参数**

  - `default` (Any)

  - `**kwargs` (Any)

## _def_ `EventType()` {#EventType}

- **说明**

  [Event](./adapters/index.md#Event) 类型参数

- **返回**

  - str

## _def_ `EventMessage()` {#EventMessage}

- **说明**

  [Event](./adapters/index.md#Event) 消息参数

- **返回**

  - Any

## _def_ `EventPlainText()` {#EventPlainText}

- **说明**

  [Event](./adapters/index.md#Event) 纯文本消息参数

- **返回**

  - str

## _def_ `EventToMe()` {#EventToMe}

- **说明**

  [Event](./adapters/index.md#Event) `to_me` 参数

- **返回**

  - bool

## _def_ `Command()` {#Command}

- **说明**

  消息命令元组

- **返回**

  - tuple[str, ...]

## _def_ `RawCommand()` {#RawCommand}

- **说明**

  消息命令文本

- **返回**

  - str

## _def_ `CommandArg()` {#CommandArg}

- **说明**

  消息命令参数

- **返回**

  - Any

## _def_ `CommandStart()` {#CommandStart}

- **说明**

  消息命令开头

- **返回**

  - str

## _def_ `ShellCommandArgs()` {#ShellCommandArgs}

- **说明**

  shell 命令解析后的参数字典

- **返回**

  - Unknown

## _def_ `ShellCommandArgv()` {#ShellCommandArgv}

- **说明**

  shell 命令原始参数列表

- **返回**

  - Any

## _def_ `RegexMatched()` {#RegexMatched}

- **说明**

  正则匹配结果

- **返回**

  - str

## _def_ `RegexGroup()` {#RegexGroup}

- **说明**

  正则匹配结果 group 元组

- **返回**

  - tuple[Any, ...]

## _def_ `RegexDict()` {#RegexDict}

- **说明**

  正则匹配结果 group 字典

- **返回**

  - dict[str, Any]

## _def_ `Received(id=None, default=None)` {#Received}

- **说明**

  `receive` 事件参数

- **参数**

  - `id` (str | None)

  - `default` (Any)

- **返回**

  - Any

## _def_ `LastReceived(default=None)` {#LastReceived}

- **说明**

  `last_receive` 事件参数

- **参数**

  - `default` (Any)

- **返回**

  - Any