@tarojs/taro 3.4.2 → 3.4.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.4.2",
+  "version": "3.4.5",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -24,9 +24,9 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.4.2",
-    "@tarojs/runtime": "3.4.2",
-    "@tarojs/taro-h5": "3.4.2"
+    "@tarojs/api": "3.4.5",
+    "@tarojs/runtime": "3.4.5",
+    "@tarojs/taro-h5": "3.4.5"
   },
-  "gitHead": "26b329326c6a7da652e8d712ee33df01ab8d2d0e"
+  "gitHead": "789e873f7b9477124b44a900cd4f6a2810e4e06a"
 }

package/types/api/ad/index.d.ts

@@ -97,7 +97,7 @@ declare module '../../index' {
     type OnLoadCallback = (res: TaroGeneral.CallbackResult) => void
     interface OnErrorCallbackResult extends TaroGeneral.CallbackResult {
       /** 错误码
-       * @see https://nervjs.github.io/taro/docs/apis/General#AdErrCode
+       * @see /docs/apis/General#aderrcode
        */
       errCode: keyof TaroGeneral.AdErrCode
       /** 错误信息 */
@@ -160,7 +160,7 @@ declare module '../../index' {
   namespace RewardedVideoAd {
     interface OnErrorCallbackResult extends TaroGeneral.CallbackResult {
       /** 错误码
-       * @see https://nervjs.github.io/taro/docs/apis/General#AdErrCode
+       * @see /docs/apis/General#aderrcode
        */
       errCode: keyof TaroGeneral.AdErrCode
       /** 错误信息 */

package/types/api/canvas/index.d.ts

@@ -3,9 +3,9 @@ import Taro from '../../index'
 declare module '../../index' {
   namespace canvasToTempFilePath {
     interface Option {
-      /** 画布标识，传入 [canvas](/docs/components/canvas/canvas) 组件实例 （canvas type="2d" 时使用该属性）。 */
+      /** 画布标识，传入 [canvas](/docs/components/canvas) 组件实例 （canvas type="2d" 时使用该属性）。 */
       canvas?: CanvasProps
-      /** 画布标识，传入 [canvas](/docs/components/canvas/canvas) 组件的 canvas-id */
+      /** 画布标识，传入 [canvas](/docs/components/canvas) 组件的 canvas-id */
       canvasId?: string
       /** 图片的质量，目前仅对 jpg 有效。取值范围为 (0, 1]，不在范围内时当作 1.0 处理。 */
       quality?: number
@@ -75,7 +75,7 @@ declare module '../../index' {
   }
   namespace canvasPutImageData {
     interface Option {
-      /** 画布标识，传入 [canvas](/docs/components/canvas/canvas) 组件的 canvas-id 属性。 */
+      /** 画布标识，传入 [canvas](/docs/components/canvas) 组件的 canvas-id 属性。 */
       canvasId: string
       /** 图像像素点数据，一维数组，每四项表示一个像素点的 rgba */
       data: Uint8ClampedArray
@@ -97,7 +97,7 @@ declare module '../../index' {
   }
   namespace canvasGetImageData {
     interface Option {
-      /** 画布标识，传入 [canvas](/docs/components/canvas/canvas) 组件的 `canvas-id` 属性。 */
+      /** 画布标识，传入 [canvas](/docs/components/canvas) 组件的 `canvas-id` 属性。 */
       canvasId: string
       /** 将要被提取的图像数据矩形区域的高度 */
       height: number
@@ -1736,9 +1736,9 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/wx.createCanvasContext.html
      */
     createCanvasContext(
-      /** 要获取上下文的 [canvas](/docs/components/canvas/canvas) 组件 canvas-id 属性 */
+      /** 要获取上下文的 [canvas](/docs/components/canvas) 组件 canvas-id 属性 */
       canvasId: string,
-      /** 在自定义组件下，当前组件实例的this，表示在这个自定义组件下查找拥有 canvas-id 的 [canvas](/docs/components/canvas/canvas) ，如果省略则不在任何自定义组件内查找 */
+      /** 在自定义组件下，当前组件实例的this，表示在这个自定义组件下查找拥有 canvas-id 的 [canvas](/docs/components/canvas) ，如果省略则不在任何自定义组件内查找 */
       component?: TaroGeneral.IAnyObject,
     ): CanvasContext
 
@@ -1767,7 +1767,7 @@ declare module '../../index' {
      */
     canvasToTempFilePath(
       option: canvasToTempFilePath.Option,
-      /** 在自定义组件下，当前组件实例的this，以操作组件内 [canvas](/docs/components/canvas/canvas) 组件 */
+      /** 在自定义组件下，当前组件实例的this，以操作组件内 [canvas](/docs/components/canvas) 组件 */
       component?: TaroGeneral.IAnyObject,
     ): Promise<canvasToTempFilePath.SuccessCallbackResult>
 
@@ -1789,7 +1789,7 @@ declare module '../../index' {
      */
     canvasPutImageData(
       option: canvasPutImageData.Option,
-      /** 在自定义组件下，当前组件实例的this，以操作组件内 [canvas](/docs/components/canvas/canvas) 组件 */
+      /** 在自定义组件下，当前组件实例的this，以操作组件内 [canvas](/docs/components/canvas) 组件 */
       component?: TaroGeneral.IAnyObject,
     ): Promise<TaroGeneral.CallbackResult>
 
@@ -1815,7 +1815,7 @@ declare module '../../index' {
      */
     canvasGetImageData(
       option: canvasGetImageData.Option,
-      /** 在自定义组件下，当前组件实例的this，以操作组件内 [canvas](/docs/components/canvas/canvas) 组件 */
+      /** 在自定义组件下，当前组件实例的this，以操作组件内 [canvas](/docs/components/canvas) 组件 */
       component?: TaroGeneral.IAnyObject,
     ): Promise<canvasGetImageData.SuccessCallbackResult>
   }

package/types/api/cloud/index.d.ts

@@ -690,6 +690,21 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-sdk-api/Cloud.database.html
      */
     database(config?: cloud.IConfig): DB.Database
+
+    /** 调用云托管服务
+     * @supported weapp
+     * @example
+     * 假设已经初始化了一个叫c1的云开发实例，并发起云托管调用
+     *
+     * ``` tsx
+     * const r = await c1.callContainer({
+     *   path: '/path/to/container', // 填入容器的访问路径
+     *   method: 'POST',
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-sdk-api/container/Cloud.callContainer.html
+     */
+     callContainer < R = any, P = any >(params: cloud.CallContainerParam<P>): Promise<cloud.CallContainerResult<R>>
   }
 
   namespace DB {

package/types/api/device/network.d.ts

@@ -139,7 +139,7 @@ declare module '../../index' {
      * @example
      * ```tsx
      * Taro.getNetworkType({
-     *   success: function (res)) {
+     *   success: function (res) {
      *     // 返回网络类型, 有效值：
      *     // wifi/2g/3g/4g/unknown(Android下不常见的网络类型)/none(无网络)
      *     var networkType = res.networkType

package/types/api/location/index.d.ts

@@ -87,16 +87,22 @@ declare module '../../index' {
 
   namespace chooseLocation {
     interface Option {
-      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: TaroGeneral.CallbackResult) => void
-      /** 接口调用失败的回调函数 */
-      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 目标地纬度 */
       latitude?: number
       /** 目标地经度 */
       longitude?: number
+      /** 地图选点组件参数
+       * @supported h5
+       * @h5 仅支持 H5 使用
+       * @see https://lbs.qq.com/webApi/component/componentGuide/componentPicker
+       */
+      mapOpts?: Record<string, unknown>
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
     }
 
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {

package/types/api/network/request.d.ts

@@ -2,7 +2,7 @@ import Taro from '../../index'
 
 declare module '../../index' {
   namespace request {
-    interface Option < U extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any > {
+    interface Option <T = any, U extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any > {
       /** 开发者服务器接口地址 */
       url: string
       /** 请求的参数 */
@@ -55,7 +55,7 @@ declare module '../../index' {
        */
       enableChunked?: boolean
       /** 接口调用成功的回调函数 */
-      success?: (result: SuccessCallbackResult) => void
+      success?: (result: SuccessCallbackResult<T>) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -367,7 +367,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html
      */
-    request<T = any, U = any>(option: request.Option<U>): RequestTask<T>
+    request<T = any, U = any>(option: request.Option<T, U>): RequestTask<T>
 
     /** 可以使用拦截器在请求发出前或发出后做一些额外操作。
      *

package/types/api/open-api/authorize.d.ts

@@ -37,7 +37,7 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /** **仅小程序插件中能调用该接口**，用法同 [Taro.authorize](./authorize)。目前仅支持三种 scope
+    /** **仅小程序插件中能调用该接口**，用法同 [Taro.authorize](../authorize)。目前仅支持三种 scope
      * @supported weapp
      * @example
      * ```tsx

package/types/api/open-api/settings.d.ts

@@ -5,7 +5,6 @@ declare module '../../index' {
     interface Option {
       /**
        * 是否同时获取用户订阅消息的订阅状态，默认不获取。注意：withSubscriptions 只返回用户勾选过订阅面板中的“总是保持以上选择，不再询问”的订阅消息。
-       * 最低版本：2.10.3
        */
       withSubscriptions?: boolean
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -28,6 +27,10 @@ declare module '../../index' {
 
   namespace getSetting {
     interface Option {
+      /**
+       * 是否同时获取用户订阅消息的订阅状态，默认不获取。注意：withSubscriptions 只返回用户勾选过订阅面板中的“总是保持以上选择，不再询问”的订阅消息。
+       */
+      withSubscriptions?: boolean
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */

package/types/api/ui/animation.d.ts

@@ -473,7 +473,7 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /** 创建一个动画实例 [animation](./Animation)。调用实例的方法来描述动画。最后通过动画实例的 export 方法导出动画数据传递给组件的 animation 属性。
+    /** 创建一个动画实例 [animation](../Animation)。调用实例的方法来描述动画。最后通过动画实例的 export 方法导出动画数据传递给组件的 animation 属性。
      * @supported weapp, h5
      * @example
      * ```tsx

package/types/api/worker/index.d.ts

@@ -60,7 +60,7 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /** 创建一个 Worker 线程。目前限制最多只能创建一个 Worker，创建下一个 Worker 前请先调用 [Worker.terminate](/docs/apis/worker/Worker#terminate)
+    /** 创建一个 Worker 线程。目前限制最多只能创建一个 Worker，创建下一个 Worker 前请先调用 [Worker.terminate](/docs/apis/worker/#terminate)
      * @supported weapp
      * @example
      * ```tsx

package/types/api/wxml/index.d.ts

@@ -268,7 +268,7 @@ declare module '../../index' {
       /** 回调函数 */
       callback?: NodesRef.FieldsCallback,
     ): SelectorQuery
-    /** 获取 Node 节点实例。目前支持 [Canvas](/docs/components/canvas/canvas) 的获取。
+    /** 获取 Node 节点实例。目前支持 [Canvas](/docs/components/canvas) 的获取。
      * @supported weapp, h5
      * @example
      * ```tsx

package/types/taro.extend.d.ts

@@ -9,7 +9,7 @@ declare module './index' {
     duration?: number
   }
 
-  interface RequestParams extends request.Option<any> {
+  interface RequestParams<T> extends request.Option<T, any> {
     [propName: string]: any
   }
 
@@ -89,5 +89,12 @@ declare module './index' {
      * ```
      */
     setGlobalDataPlugin: SetGlobalDataPlugin
+
+    /**
+     * @supported weapp
+     * @desc 获取自定义 TabBar 对应的 React 或 Vue 组件实例
+     * @param page 小程序页面对象，可以通过 Taro.getCurrentInstance().page 获取
+     */
+    getTabBar<T>(page: Current['page']): T | undefined
   }
 }