## 2026-03-13 v5.1.2
- 更新 API 定义到 3.14.3

## 2026-02-25 v5.1.1
- 修复 `v5.1.0` 解决依赖安全问题时引入的依赖版本问题

## 2026-02-25 v5.1.0
- 修复 `v5.0.0` 更新导致 property 指定 `type: null` 时，值推导为 `never` 的问题（[#369](https://github.com/wechat-miniprogram/api-typings/pull/369)）
- 解决依赖安全问题

## 2026-02-12 v5.0.1
- 更新 API 定义到 3.14.2

## 2026-01-15 v5.0.0
合入 [#362](https://github.com/wechat-miniprogram/api-typings/pull/362), [#363](https://github.com/wechat-miniprogram/api-typings/pull/363) by [@LastLeaf](https://github.com/LastLeaf)。这两个 Pull Request 对 `Component`, `Behavior` 及 `Page` 的进行了一些改动：
1. 在 `Component`, `Behavior` 及 `Page` 的返回值中交叉一个实际并不存在的 Branded Type，携带 `data`, `properties` 及 `methods` 的类型信息，用以支持 [glass-easel-analyzer](https://github.com/wechat-miniprogram/glass-easel-analyzer) 的组件类型分析；
1. 修改 `properties` 的类型推导方式，使其类似 [glass-easel](https://github.com/wechat-miniprogram/glass-easel)，相比原有的推导方式，能更准确地保留 property 的 `value` 的类型

这是一个 **破坏性改动**，从低于 5.0.0 的版本升级时，可能需要进行一些适配：
1. 全局函数 `Component` 和 `Behavior` 的泛型 `TProperty` 的定义有一些改变，如果之前的代码中以 `FullProperty` 形式手动指定了这个泛型，可能需要为 `FullProperty` 添加 `value` 的具体类型；
1. 4.0.0 中添加的 `WechatMiniprogram.Behavior.BehaviorIdentifier` 更名为 `WechatMiniprogram.Behavior.Identifier`；
1. `Component()`, `Behavior()` 和 `Page()` 的返回值类型都有对应的改变，在实际类型上增加了一个 Branded Type。对于这几个函数的返回值类型：
   - `Behavior` 的返回类型可以使用新增加的 `WechatMiniprogram.Behavior.Identifier` 来表达；
   - `Component` 的返回类型可以使用新增加的 `WechatMiniprogram.Component.Identifier` 来表达；
   - `Page` 需要留意实际返回值应为 `void` (`undefined`)，必要时也可以使用新增加的 `WechatMiniprogram.Page.VoidReturnType`；
1. 自定义组件的 `this.data` 和 `this.property` 的推导类型可能会有所变化，需要根据推导类型进行相应改动。

## 2026-01-15 v4.1.3
- 更新 API 定义到 3.13.1
- 依照更新过的 `Platform` 枚举值更新测试用例

## 2025-12-16 v4.1.2
- 更新 API 定义到 3.12.1

## 2025-12-03 v4.1.1
- 更新 API 定义到 3.12.0

## 2025-07-15 v4.1.0
- 修改 `getOpenerEventChannel` 的返回值的类型，使其有可能返回空对象，以正确反映实际情况。这是一个 **破坏性改动**，`getOpenerEventChannel` 的返回值上的 `emit`, `on` 等方法不再可以直接调用 ([#350](https://github.com/wechat-miniprogram/api-typings/issues/350))
- 解决依赖安全问题

## 2025-07-15 v4.0.8
- 更新 API 定义到 3.8.10

## 2025-04-18 v4.0.7
- 更新云开发拓展能力类型定义

## 2025-04-18 v4.0.6
- 更新 API 定义到 3.8.0

## 2025-02-08 v4.0.5
- 修复 `setTimeout` 和 `setInterval` 的参数 ([#323](https://github.com/wechat-miniprogram/api-typings/issues/323))
- 更新 API 定义到 3.7.7

## 2025-01-14 v4.0.4
- 解决依赖安全问题

## 2025-01-14 v4.0.3
- 补齐云开发 `CollectionReference` 上的 `aggregate` ([#276](https://github.com/wechat-miniprogram/api-typings/issues/276))
- 补齐组件实例方法 `setInitialRenderingCache` 和 `getAppBar` by [@Yang Mingshan](https://github.com/yangmingshan) ([#339](https://github.com/wechat-miniprogram/api-typings/issues/339))
- 更新 API 定义到 3.7.4

## 2024-11-13 v4.0.2
- 补齐 `RaycastHit` ([#337](https://github.com/wechat-miniprogram/api-typings/issues/337))

## 2024-09-24 v4.0.1
- 更新 API 定义到 3.5.7

## 2024-09-24 v4.0.0
合入 [#332](https://github.com/wechat-miniprogram/api-typings/pull/332), [#333](https://github.com/wechat-miniprogram/api-typings/pull/333), [#334](https://github.com/wechat-miniprogram/api-typings/pull/334) by [@lvzl](https://github.com/lv-z-l)。这几个 Pull Request 对 `Component` 和 `Behavior` 的实现进行了较大改动，以支持：
1. 对于 `Array` 和 `Object` 类型的 `property` 和 `data`，以值的实际类型作为泛型推导的结果，而非固定推导为 `any[]` 和 `Record<string, any>`；
2. 改变了 `BehaviorIdentifier` 的类型，通过为其交叉一个带有 `Behavior` 定义信息的虚假类型，使 `Component` 和 `Behavior` 能自动推导其使用到的 `Behavior` 的 `data`, `properties` 及 `methods`；

这是一个比较大的 **破坏性改动**，从低于 4.0.0 的版本升级时，可能需要进行一些适配：
1. 全局函数 `Component` 和 `Behavior` 的第四个泛型现在是新的 `TBehavior`，如果之前的代码中有为这两个函数手动指定泛型的用例，需要手动添加这个泛型；
2. `Behavior()` 的返回值不再是 `string`（或者说不完全是），之前使用 `string` 接受 `Behavior()` 返回值的实现需要修改为 `WechatMiniprogram.Behavior.BehaviorIdentifier`；
3. 自定义组件的 `this.data` 和 `this.property` 的推导类型可能会有所变化，需要根据推导类型进行相应改动。

## 2024-08-08 v3.12.3
- 更新 API 定义到 3.5.2
- 修复 [#235](https://github.com/wechat-miniprogram/api-typings/issues/235), [#302](https://github.com/wechat-miniprogram/api-typings/issues/302), [#303](https://github.com/wechat-miniprogram/api-typings/issues/303), [#304](https://github.com/wechat-miniprogram/api-typings/issues/304) by [@Yang Mingshan](https://github.com/yangmingshan)

## 2023-12-01 v3.12.2
- 更新 API 定义到 3.2.3

## 2023-10-17 v3.12.1
- 更新 API 定义到 3.1.2
- 补齐自定义组件实例的 `getPassiveEvent`, `setPassiveEvent` 方法

## 2023-08-24 v3.12.0
- `App` 生命周期 `onLaunch`, `onShow` 参数中的 `referrerInfo` 字段类型对齐 API 定义中的 `ReferrerInfo`。这是一个 **破坏性改动**，其中 `extraData` 的类型从 `any` 收窄到了 `Record<string, any>`
- 根据实际实现，修改了 `LaunchOptions` 中 `query` 字段的类型。这是一个 **破坏性改动**，该类型从 `Record<string, any>` 收窄到了 `Record<string, string>`

## 2023-08-24 v3.11.1
- 更新 API 定义到 3.0.1

## 2023-08-04 v3.11.0
- 更新 API 定义到 3.0.0
  - 暂未支持 [glass-easel](https://github.com/wechat-miniprogram/glass-easel) [Chaining API](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/glass-easel/chaining-api.html) 的类型定义
- 补齐 `WXWebAssembly` 定义

## 2023-06-09 v3.10.0
- 更新 API 定义到 2.32.1
- 新增 CanvasRenderingContext 类型定义 [#111](https://github.com/wechat-miniprogram/api-typings/issues/111)

## 2023-04-10 v3.9.1
- 更新 API 定义到 2.30.4
- 修复页面 `onShareAppMessage` 异步形式的定义错误

## 2023-01-12 v3.9.0
- 更新 API 定义到 2.29.1
- 将 xr-frame 的命名空间由 `WechatXrFrame` 改为 `XrFrame`。这是一个 **破坏性改动**

## 2022-09-09 v3.6.0
- 更新 API 定义到 2.26.0
- 更改了部分监听方法及其参数的命名

## 2022-06-24 v3.5.0
- 更新 API 定义到 2.24.6

## 2022-04-01 v3.4.6
- 更新 API 定义到 2.23.2

## 2022-01-20 v3.4.5
- 更新 API 定义到 2.21.3

## 2021-08-24 v3.4.4
- 更新 API 定义到 2.20.1

## 2021-08-24 v3.4.3
- 更新 API 定义到 2.19.2
- 补充自定义组件获取更新性能接口定义

## 2021-08-02 v3.4.2
- 更新 API 定义到 2.19.0
- 重新整理了注释，包括：
  - 加入插件支持情况、版本和说明
  - 将支持和废弃情况挪到前面，使其更不容易因为接口说明太长而被忽略
  - 移除文首、文末和多余（连续超过两个）的空行
  - 修复几个链接

## 2021-07-07 v3.4.1
- 移除一个意外加入的非预期字符

## 2021-07-07 v3.4.0
- 更新 API 定义到 2.18.0
- 更新来自文档代码示例的测试用例
- 更新 npm 依赖以解决安全问题
- 修复 [#202](https://github.com/wechat-miniprogram/api-typings/issues/202), [#204](https://github.com/wechat-miniprogram/api-typings/issues/204)

## 2021-04-21 v3.3.2
- 更新 API 定义到 2.16.1

## 2021-04-09 v3.3.1
- 更新 API 定义到 2.16.0

## 2021-03-02 v3.3.0
- 更新部分新接口定义
- 支持泛型（[#177](https://github.com/wechat-miniprogram/api-typings/issues/177)）
- 支持索引签名，以支持 `wx.requestSubscribeMessage`（[#175](https://github.com/wechat-miniprogram/api-typings/issues/175)）

## 2021-02-22 v3.2.3
- 更新 API 定义到 2.15.0
- 修复 `Component.triggerEvent` 的 `detail` 类型
- 修复几个接口的定义（[#193](https://github.com/wechat-miniprogram/api-typings/issues/193), [#185](https://github.com/wechat-miniprogram/api-typings/issues/185), [#180](https://github.com/wechat-miniprogram/api-typings/issues/180)）
- 修改 `MethodOption` 以解决 [#161](https://github.com/wechat-miniprogram/api-typings/issues/161)（鸣谢：[@Lienviws](https://github.com/Lienviws)）

## 2021-01-14 v3.2.2
- 修复几个接口未 Promise 化的问题

## 2021-01-06 v3.2.1
- 更新 API 定义到 2.14.1
- 补齐 `virtualHost` ([#174](https://github.com/wechat-miniprogram/api-typings/issues/174))

## 2020-11-13 v3.2.0
- 更新 API 定义到 2.14.0
- 补齐 NFC 接口的错误码

## 2020-11-04 v3.1.6
- 补齐 `requirePlugin` 和 `requireMiniProgram`

## 2020-10-29 v3.1.5
- 更新 API 定义
- 修复代码格式问题（`no-unnecessary-qualifier`）

## 2020-10-28 v3.1.4
- 更新 API 定义到 2.13.2
- 为被废弃的接口增加了 `@deprecated` 标识

## 2020-10-14 v3.1.3
- 修复 `ICustomTimelineContent` 的 `query` 的类型

## 2020-09-30 v3.1.2
- 更新 API 定义到 2.13.1

## 2020-09-24 v3.1.1
- 更新 API 定义到 2.13.0
- 改变了嵌套命名空间的写法
- 支持 `Component` 的第五个泛型参数，用于将自定义组件作为页面根组件使用的情况

## 2020-09-22 v3.1.0
- 将代码风格检查从 tslint 迁移到 eslint

## 2020-08-19 v3.0.2
- 更新 API 定义
- 合并 PR [#151](https://github.com/wechat-miniprogram/api-typings/pull/151), [#152](https://github.com/wechat-miniprogram/api-typings/pull/152)，补齐事件类型，补齐 `onShareTimeline`

## 2020-08-19 v3.0.2
- 更新 API 定义
- 合并 PR [#124](https://github.com/wechat-miniprogram/api-typings/pull/124), [#145](https://github.com/wechat-miniprogram/api-typings/pull/145)，修复两个动画接口的问题

## 2020-08-03 v3.0.1
- 更新 API 定义
- 修复某些取消监听的接口（`off`）的参数不为可选值的问题

## 2020-07-30 v3.0.0
- 由于基础库接口基本向前兼容，不再与基础库保持版本同步
- 更新 API 定义到 2.12.0

## 2020-06-15 v2.11.0-1
- 该版本继续合并了一部分完全相同的 interface / callback，是一个 **破坏性改动**，原本字面上引用了这些 interface / callback 的代码可能会报错。
- 为 `Component` 构造器增加第四个泛型，以允许在自定义组件上挂载自定义的字段 ([#133](https://github.com/wechat-miniprogram/api-typings/issues/133))
- 修复一些接口错误 ([#134](https://github.com/wechat-miniprogram/api-typings/issues/134))
- 补齐 `App` 的 `onThemeChange` ([#135](https://github.com/wechat-miniprogram/api-typings/issues/135))
- 补齐 `Page` 的 `onAddToFavorites` ([#136](https://github.com/wechat-miniprogram/api-typings/issues/136))

## 2020-05-20 v2.11.0
- 同步 API 定义到基础库 2.11.0
- 该版本继续合并了一部分完全相同的 interface / callback，是一个 **破坏性改动**，原本字面上引用了这些 interface / callback 的代码可能会报错。
- 修复接口错误 ([#126](https://github.com/wechat-miniprogram/api-typings/issues/126))

## 2020-04-20 v2.10.4
- 同步 API 定义到基础库 2.10.4
- 在之前的版本中，分属于不同接口的两个 interface / callback 即使完全相同，也会拥有不同的名字。在这次更新中，他们将合并为同一个（如 `FileSystemManagerGetFileInfoCompleteCallback` 和 `WxGetFileInfoCompleteCallback` 都变成了 `GetFileInfoCompleteCallback`）。这是一个 **破坏性改动**，原本字面上引用了这些 interface / callback 的代码可能会报错。
- 修复了一些取消监听接口（off callback）的参数错误 ([#120](https://github.com/wechat-miniprogram/api-typings/issues/120))

## 2020-04-03 v2.10.3-1
- 补齐 `Component` 的 `getOpenerEventChannel` ([#112](https://github.com/wechat-miniprogram/api-typings/issues/113) by [@baranwang](https://github.com/baranwang))
- 加入了部分事件的定义 ([#115](https://github.com/wechat-miniprogram/api-typings/issues/115) by [@zenml](https://github.com/zenml))
- 更新了小程序·云开发的 API 定义 ([#92](https://github.com/wechat-miniprogram/api-typings/issues/92))

## 2020-03-26 v2.10.3
- 同步 API 定义到基础库 2.10.3

## 2020-03-18 v2.10.2-1
- 支持 API Promise 化调用 ([#105](https://github.com/wechat-miniprogram/api-typings/issues/105)) 

## 2020-03-06 v2.10.2
- 同步 API 定义到基础库 2.10.2

## 2020-02-10 v2.10.1-1
- 允许重写部分全局变量 (由 `const` 改为 `let`)  ([#102](https://github.com/wechat-miniprogram/api-typings/issues/102)) 
- 补齐 `Page` 上的 `options` 字段 ([#101](https://github.com/wechat-miniprogram/api-typings/issues/101) by [@baranwang](https://github.com/baranwang)) 

## 2020-01-19 v2.10.1
- 同步 API 定义到基础库 2.10.1
- 补齐 `Component` `selectOwnerComponent`, `animate`, `clearAnimation` ([#96](https://github.com/wechat-miniprogram/api-typings/issues/96)) 
- 补齐 `App` `onUnhandledRejection` ([#99](https://github.com/wechat-miniprogram/api-typings/issues/99)) 

## 2020-01-07 v2.10.0-1
- 修复接口错误 ([#95](https://github.com/wechat-miniprogram/api-typings/issues/95)) 

## 2020-01-07 v2.10.0
- 同步 API 定义到基础库 2.10.0

## 2019-12-20 v2.9.4
- 同步 API 定义到基础库 2.9.4
- 修正一些接口错误 ([#88](https://github.com/wechat-miniprogram/api-typings/issues/88)，[#89](https://github.com/wechat-miniprogram/api-typings/issues/89)，[#91](https://github.com/wechat-miniprogram/api-typings/issues/91)) 

## 2019-12-06 v2.9.3
- 同步 API 定义到基础库 2.9.3
- 补齐 `Component` 纯数据字段 (`pureDataPattern`) 
- 支持 `Component` 的属性监听器使用 `string` 类型

## 2019-11-14 v2.9.2
- 同步 API 定义到基础库 2.9.2
- 补齐 `Behaviors` 中缺少的一些选项

## 2019-11-06 v2.9.1
- 同步 API 定义到基础库 2.9.1

## 2019-10-23 v2.9.0
- 同步 API 定义到基础库 2.9.0

## 2019-10-10 v2.8.3-1
- 修复注释文档中不可用的链接
- 组件实例类型支持 `Partial` 的自定义方法 ([用例](https://github.com/wechat-miniprogram/api-typings/blob/master/test/issue.test.ts#L170-L185)) 

## 2019-09-19 v2.8.3
- 同步 API 定义到基础库 2.8.3
- `getApp` 支持范型 ([#77](https://github.com/wechat-miniprogram/api-typings/issues/77)) 
- 修正一些接口错误 ([#73](https://github.com/wechat-miniprogram/api-typings/issues/73), [#75](https://github.com/wechat-miniprogram/api-typings/issues/75), [#79](https://github.com/wechat-miniprogram/api-typings/issues/79)) 
- 补齐 `require`, `exports`, `module.exports` 定义，以支持在没有 `@types/node` 下编译

## 2019-09-10 v2.8.2
- 同步 API 定义到基础库 2.8.2
- 加强了参数为可选值的方法参数类型定义和注释 (如 `FileSystemManager.appendFileSync` 的 `encoding`) 

## 2019-08-30 v2.8.1
- 同步 API 定义到基础库 2.8.1
- 修复了部分最低基础库显示为 `[object Object]` 的问题

## 2019-08-20 v2.8.0-2

- 将 `object` 改为 `Record<string, any>`，以允许任意属性和方法
- 自定义组件属性构造器为 `ObjectConstructor` 时，类型推导为 `Record<string, any>` 而不是 `object`
- 修正 `component` 参数的类型为页面或自定义组件实例
- 补齐 `console: WechatMiniprogram.Console` 全局变量
- 修正一些其他的接口类型错误

## 2019-08-14 v2.8.0-1

- 补齐 `styleIsolation` 到 `ComponentOption`

## 2019-08-14 v2.8.0

- 同步 API 定义到基础库 2.8.0
- 不再向全局暴露 `IAnyObject`，收回到命名空间 `WechatMiniprogram` 内
- 对齐代码规范，使用 4 空格缩进，不再使用分号等
- 小幅改动 behavior, component 和 page 的定义，使其对 data 和 properties 等的类型推断更准确
- 修复了一些其他问题 ([#60](https://github.com/wechat-miniprogram/api-typings/issues/60), [#59](https://github.com/wechat-miniprogram/api-typings/issues/59), [#48](https://github.com/wechat-miniprogram/api-typings/issues/48), [#47](https://github.com/wechat-miniprogram/api-typings/issues/47), [#45](https://github.com/wechat-miniprogram/api-typings/issues/45), [#33](https://github.com/wechat-miniprogram/api-typings/issues/33), [#13](https://github.com/wechat-miniprogram/api-typings/issues/13)) 

## 2019-08-08 v2.7.7-2

- 补齐了部分接口 fail 回调的错误码 ([#51](https://github.com/wechat-miniprogram/api-typings/issues/51)) 

## 2019-08-06 v2.7.7-1

- 重写了 page, component 和 behavior 的定义，替换原来不完整的定义，使其更全面，更准确 ([#46](https://github.com/wechat-miniprogram/api-typings/issues/46), [#40](https://github.com/wechat-miniprogram/api-typings/issues/40), [#30](https://github.com/wechat-miniprogram/api-typings/issues/30), [#28](https://github.com/wechat-miniprogram/api-typings/issues/28), [#27](https://github.com/wechat-miniprogram/api-typings/issues/27)) 

## 2019-07-31 v2.7.7

- 同步 API 定义到基础库 2.7.7
- 将命名空间从 `Wx` 更改为更正式的 `WechatMiniprogram`，这是一个 **破坏性改动**，原本字面上引用了 `Wx` 命名空间的代码可能失效
- 修复了云开发的定义无法使用的问题 ([#25](https://github.com/wechat-miniprogram/api-typings/issues/25), [#32](https://github.com/wechat-miniprogram/api-typings/issues/32), [#42](https://github.com/wechat-miniprogram/api-typings/issues/42)) 
- 修复了一些其它问题 ([#11](https://github.com/wechat-miniprogram/api-typings/issues/11), [#35](https://github.com/wechat-miniprogram/api-typings/issues/35), [#43](https://github.com/wechat-miniprogram/api-typings/issues/43))