# wx.onApiCategoryChange(function listener)

> 基础库 2.33.0 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：不支持

## 功能描述

监听 API 类别变化事件

## 参数

### function listener

API 类别变化事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "apiCategory",
    "类型": "number",
    "说明": "API 类别",
    "子项": [
      {
        "合法值": "default",
        "说明": "默认类别"
      },
      {
        "合法值": "nativeFunctionalized",
        "说明": "原生功能化，视频号直播商品、商品橱窗等场景打开的小程序"
      },
      {
        "合法值": "browseOnly",
        "说明": "仅浏览，朋友圈快照页等场景打开的小程序"
      },
      {
        "合法值": "embedded",
        "说明": "内嵌，通过打开半屏小程序能力打开的小程序"
      },
      {
        "合法值": "chatTool",
        "说明": "聊天工具打开小程序"
      }
    ]
  }
]
```

## 不同 apiCategory 场景下的 API 限制

`X` 表示 API 被限制无法使用；不在表格中的 API 不限制。

|                                       | default | nativeFunctionalized | browseOnly | embedded | chatTool |
|-|-|-|-|-|--|
|openSetting                            |         |                      | `X`        |          |      |
|<button open-type="share">       |         | `X`                  | `X`        | `X`      |  `X` |
|<button open-type="feedback">    |         |                      | `X`        |          |      |
|<button open-type="open-setting">|         |                      | `X`        |          |      |
|navigateToMiniProgram                  |         | `X`                  | `X`        |          |  `X` |
|openEmbeddedMiniProgram                |         | `X`                  | `X`        | `X`      |  `X` |
|openOfficialAccountArticle             |         |                      |            |          |  `X` |
|openChannelsUserProfile                |         |                      |            |          |  `X` |
|ad                                     |         |                      |            |          |  `X` |
|ad-custom                              |         |                      |            |          |  `X` |
|小程序菜单分享                            |         |                      |            |          |  `X` |

## 示例代码

```js
const func = function (res) {
  console.log(res.apiCategory)
}
wx.onApiCategoryChange(func)
// 取消监听
wx.offApiCategoryChange(func)
```