@tarojs/taro 3.7.0-alpha.2 → 3.7.0-alpha.22

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

@@ -57,14 +57,6 @@ declare module '../../index' {
   }
 
   namespace DownloadTask {
-    /** HTTP Response Header 事件的回调函数 */
-    type OffHeadersReceivedCallback = (
-      res: TaroGeneral.CallbackResult,
-    ) => void
-    /** 下载进度变化事件的回调函数 */
-    type OffProgressUpdateCallback = (
-        res: TaroGeneral.CallbackResult,
-    ) => void
     /** HTTP Response Header 事件的回调函数 */
     type OnHeadersReceivedCallback = (
         result: OnHeadersReceivedCallbackResult,
@@ -135,7 +127,7 @@ declare module '../../index' {
      */
     offProgressUpdate(
       /** 下载进度变化事件的回调函数 */
-      callback: DownloadTask.OffProgressUpdateCallback,
+      callback: DownloadTask.OnProgressUpdateCallback,
     ): void
     /** 监听 HTTP Response Header 事件。会比请求完成事件更早
      * @supported weapp, h5
@@ -151,7 +143,7 @@ declare module '../../index' {
      */
     offHeadersReceived(
       /** HTTP Response Header 事件的回调函数 */
-      callback: DownloadTask.OffHeadersReceivedCallback,
+      callback: DownloadTask.OnHeadersReceivedCallback,
     ): void
   }
 

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

@@ -2,7 +2,7 @@ import Taro from '../../index'
 
 declare module '../../index' {
   namespace request {
-    interface Option <T = any, U extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any > {
+    interface Option<T = any, U extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any> {
       /** 开发者服务器接口地址 */
       url: string
       /** 请求的参数 */
@@ -14,11 +14,11 @@ declare module '../../index' {
       header?: TaroGeneral.IAnyObject
       /** 超时时间，单位为毫秒
        * @default 2000
-       * @supported weapp, h5, tt
+       * @supported weapp, h5, tt, alipay
        */
       timeout?: number
       /** HTTP 请求方法
-       * @default GET
+       * @default "GET"
        */
       method?: keyof Method
       /** 返回的数据格式 */
@@ -54,70 +54,99 @@ declare module '../../index' {
        * @supported weapp
        */
       enableChunked?: boolean
+      /**
+       * wifi下使用移动网络发送请求
+       * @default false
+       * @supported weapp
+       */
+      forceCellularNetwork?: boolean
+      /**
+       * headers 中设置 cookie 字段是否生效。如果为 false，则 headers 中的 cookie 字段将被忽略，请求头中将包含服务端上一次返回的 cookie（如果有）。
+       * @default false
+       * @supported alipay 支付宝: 10.2.33+
+       */
+      enableCookie?: boolean
+      /**
+       * referer 策略，用于控制当前请求 header 对象中 referer 字段格式。该参数默认值可通过 app.json 中的配置进行修改。
+       * @default "querystring"
+       * @supported alipay 支付宝: 10.3.50+ APPX: 2.8.7 开发者工具: 3.5.1
+       * @see https://opendocs.alipay.com/mini/api/owycmh#referrerStrategy%20%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E
+       */
+      referrerStrategy?: keyof ReferrerStrategy
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult<T>) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
-      /** 设置 H5 端是否使用jsonp方式获取数据
+      /** 设置是否使用 jsonp 方式获取数据
        * @default false
        * @supported h5
        */
-      jsonp?: boolean
-      /** 设置 H5 端 jsonp 请求 url 是否需要被缓存
-       * @default false
+      jsonp?: boolean | string
+      /** 设置 jsonp 请求 url 是否需要被缓存
        * @supported h5
        */
-      jsonpCache?: boolean
-      /** 设置 H5 端是否允许跨域请求
+      jsonpCache?: RequestCache
+      /** 设置是否允许跨域请求
        * @default "same-origin"
        * @supported h5
        */
       mode?: keyof CorsMode
-      /** 设置 H5 端是否携带 Cookie
+      /** 设置是否携带 Cookie
        * @default "omit"
        * @supported h5
        */
       credentials?: keyof Credentials
-      /** 设置 H5 端缓存模式
+      /** 设置缓存模式
        * @default "default"
        * @supported h5
        */
       cache?: keyof Cache
-      /** 设置 H5 端请求重试次数
+      /** 设置请求重试次数
        * @default 2
        * @supported h5
+       * @h5 仅在 jsonp 模式下生效
        */
       retryTimes?: number
-      /** 设置 H5 端请求的兜底接口
+      /** 设置请求的兜底接口
        * @supported h5
+       * @h5 仅在 jsonp 模式下生效
        */
       backup?: string | string[]
-      /** 设置 H5 端请求响应的数据校验函数，若返回 false，则请求兜底接口，若无兜底接口，则报请求失败
+      /** 设置请求中止信号
+       * @supported h5
+       */
+      signal?: AbortSignal
+      /** 设置请求响应的数据校验函数，若返回 false，则请求兜底接口，若无兜底接口，则报请求失败
        * @supported h5
+       * @h5 仅在 jsonp 模式下生效
        */
       dataCheck?(): boolean
-      /** 设置 H5 端请求是否使用缓存
+      /** 设置请求是否使用缓存
        * @default false
        * @supported h5
+       * @h5 仅在 jsonp 模式下生效
        */
       useStore?: boolean
-      /** 设置 H5 端请求缓存校验的 key
+      /** 设置请求缓存校验的 key
        * @supported h5
+       * @h5 仅在 jsonp 模式下生效
        */
       storeCheckKey?: string
-      /** 设置 H5 端请求缓存签名
+      /** 设置请求缓存签名
        * @supported h5
+       * @h5 仅在 jsonp 模式下生效
        */
       storeSign?: string
-      /** 设置 H5 端请求校验函数，一般不需要设置
+      /** 设置请求校验函数，一般不需要设置
        * @supported h5
        */
       storeCheck?(): boolean
     }
 
-    interface SuccessCallbackResult < T extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any > extends TaroGeneral.CallbackResult {
+    interface SuccessCallbackResult<T extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any>
+      extends TaroGeneral.CallbackResult {
       /** 开发者服务器返回的数据 */
       data: T
       /** 开发者服务器返回的 HTTP Response Header */
@@ -132,10 +161,26 @@ declare module '../../index' {
 
     /** 返回的数据格式 */
     interface DataType {
-      /** 返回的数据为 JSON，返回后会对返回的数据进行一次 JSON.parse
+      /**
+       * 返回的数据为 JSON，返回后会对返回的数据进行一次 JSON.parse
        * 其他: 不对返回的内容进行 JSON.parse
        */
       json
+      /**
+       * 返回的数据为文本字符串
+       * @supported alipay
+       */
+      text
+      /**
+       * 返回的数据将转换为 base64 格式字符串
+       * @supported alipay
+       */
+      base64
+      /**
+       * 返回的数据将保持 ArrayBuffer 数据
+       * @supported alipay 支付宝: 10.1.70+
+       */
+      arraybuffer
     }
 
     /** HTTP 请求方法 */
@@ -199,6 +244,21 @@ declare module '../../index' {
       /** 浏览器在其HTTP缓存中寻找匹配的请求 */
       'only-if-cached'
     }
+    /** referer 策略 */
+    interface ReferrerStrategy {
+      /**
+       * referer 值为 https://{appid}.hybrid.alipay-eco.com/{appid}/{version}/index.html
+       */
+      index
+      /**
+       * 保留 page（pages/xxx/yyy），referer 值为 https://{appid}.hybrid.alipay-eco.com/{appid}/{version}/index.html#{page}
+       */
+      page
+      /**
+       * 默认值。会将发起请求时所在页面的 URL 作为 referer 值，会保留 page（pages/xxx/yyy）和 querystring（x=1&y=2）并可能有框架添加的其他参数，referer 值为 https://{appid}.hybrid.alipay-eco.com/{appid}/{version}/index.html#{page}?{querysrtring}{框架其他参数}
+       */
+      querystring
+    }
   }
 
   /** 网络请求任务对象
@@ -266,7 +326,7 @@ declare module '../../index' {
      */
     onHeadersReceived(
       /** HTTP Response Header 事件的回调函数 */
-      callback: RequestTask.onHeadersReceived.Callback,
+      callback: RequestTask.onHeadersReceived.Callback
     ): void
     /** 取消监听 HTTP Response Header 事件
      * @supported weapp
@@ -274,7 +334,7 @@ declare module '../../index' {
      */
     offHeadersReceived(
       /** HTTP Response Header 事件的回调函数 */
-      callback: RequestTask.onHeadersReceived.Callback,
+      callback: RequestTask.onHeadersReceived.Callback
     ): void
     /** 监听 Transfer-Encoding Chunk Received 事件。当接收到新的chunk时触发。
      * @supported weapp
@@ -282,7 +342,7 @@ declare module '../../index' {
      */
     onChunkReceived(
       /** Transfer-Encoding Chunk Received 事件的回调函数 */
-      callback: RequestTask.onChunkReceived.Callback,
+      callback: RequestTask.onChunkReceived.Callback
     ): void
     /** 移除 Transfer-Encoding Chunk Received 事件的监听函数
      * @supported weapp
@@ -290,7 +350,7 @@ declare module '../../index' {
      */
     offChunkReceived(
       /** Transfer-Encoding Chunk Received 事件的回调函数 */
-      callback: RequestTask.onChunkReceived.Callback,
+      callback: RequestTask.onChunkReceived.Callback
     ): void
   }
 

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

@@ -56,14 +56,6 @@ declare module '../../index' {
   }
 
   namespace UploadTask {
-    /** HTTP Response Header 事件的回调函数 */
-    type OffHeadersReceivedCallback = (
-      res: TaroGeneral.CallbackResult,
-    ) => void
-    /** 上传进度变化事件的回调函数 */
-    type OffProgressUpdateCallback = (
-      res: TaroGeneral.CallbackResult,
-    ) => void
     /** HTTP Response Header 事件的回调函数 */
     type OnHeadersReceivedCallback = (
       result: OnHeadersReceivedCallbackResult,
@@ -138,7 +130,7 @@ declare module '../../index' {
      */
     offProgressUpdate(
       /** 上传进度变化事件的回调函数 */
-      callback: UploadTask.OffProgressUpdateCallback,
+      callback: UploadTask.OnProgressUpdateCallback,
     ): void
     /** 监听 HTTP Response Header 事件。会比请求完成事件更早
      * @supported weapp, h5
@@ -154,7 +146,7 @@ declare module '../../index' {
      */
     offHeadersReceived(
       /** HTTP Response Header 事件的回调函数 */
-      callback: UploadTask.OffHeadersReceivedCallback,
+      callback: UploadTask.OnHeadersReceivedCallback,
     ): void
   }
 

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

@@ -4,32 +4,34 @@ declare module '../../index' {
   namespace chooseAddress {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: TaroGeneral.CallbackResult) => void
+      complete?: (res: SuccessCallbackResult) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
     }
 
-    interface SuccessCallbackResult {
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 收货人姓名 */
+      userName: string
+      /** 邮编 */
+      postalCode: string
+      /** 国标收货地址第一级地址 */
+      provinceName: string
       /** 国标收货地址第二级地址 */
       cityName: string
       /** 国标收货地址第三级地址 */
       countyName: string
+      /** 国标收货地址第四级地址 */
+      streetName: string
       /** 详细收货地址信息 */
       detailInfo: string
-      /** 错误信息 */
-      errMsg: string
+      /** 新选择器详细收货地址信息 */
+      detailInfoNew: string
       /** 收货地址国家码 */
       nationalCode: string
-      /** 邮编 */
-      postalCode: string
-      /** 国标收货地址第一级地址 */
-      provinceName: string
       /** 收货人手机号码 */
       telNumber: string
-      /** 收货人姓名 */
-      userName: string
     }
   }
 

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

@@ -68,6 +68,31 @@ declare module '../../index' {
     }
   }
 
+  namespace getChannelsShareKey {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 分享者 openid  */
+      sharerOpenId: string
+      /** 推广员 */
+      promoter: Promoter
+    }
+    interface Promoter {
+      /** 推广员昵称 */
+      finderNickname: string
+      /** 推广员id */
+      promoterId: string
+      /** 推广员openid */
+      promoterOpenId: string
+    }
+  }
+
   namespace getChannelsLiveNoticeInfo {
     interface Option {
       /** 视频号 id，以“sph”开头的id，可在视频号助手获取 */
@@ -164,6 +189,12 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.openChannelsActivity.html
      */
     openChannelsActivity(option?: openChannelsActivity.Option): Promise<TaroGeneral.CallbackResult>
+    /** 获取视频号直播卡片/视频卡片的分享来源，
+     * 仅当卡片携带了分享信息、同时用户已授权该小程序获取视频号分享信息且启动场景值为 1177、1184、1195、1208 时可用
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.getChannelsShareKey.html
+     */
+    getChannelsShareKey(option?: getChannelsShareKey.Option): Promise<getChannelsShareKey.SuccessCallbackResult>
     /** 获取视频号直播预告信息
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.getChannelsLiveNoticeInfo.html

package/types/api/open-api/device-voip.d.ts

@@ -0,0 +1,63 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace requestDeviceVoIP {
+    interface Option {
+      /** 设备唯一序列号。由厂商分配，长度不能超过128字节。字符只接受数字，大小写字母，下划线（_）和连字符（-） */
+      sn: string
+      /** 设备票据，5分钟内有效 */
+      snTicket: string
+      /** 设备型号 id。通过微信公众平台注册设备获得。 */
+      modelId: string
+      /** 设备名称，将显示在授权弹窗内（长度不超过13）。授权框中「设备名字」= 「deviceName」 + 「modelId 对应设备型号」 */
+      deviceName: string
+      /** 是否为授权设备组，默认 false */
+      isGroup?: boolean
+      /** 设备组的唯一标识 id 。isGroup 为 true 时只需要传该参数，isGroup 为 false 时不需要传该参数，但需要传 sn、snTicket、modelId、deviceName 。 */
+      groupId: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace getDeviceVoIPList {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      list: DeviceVoIP[]
+    }
+    interface DeviceVoIP {
+      /** 设备唯一序列号。（仅单台设备时） */
+      sn: string
+      /** 设备型号 id。通过微信公众平台注册设备获得。（仅单台设备时）	 */
+      model_id: string
+      /** 设备组的唯一标识 id（仅设备组时）  */
+      group_id: string
+      /** 设备（组）授权状态。0：未授权；1：已授权  */
+      status: number
+    }
+  }
+
+  interface TaroStatic {
+    /** 请求用户授权与设备（组）间进行音视频通话
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/device-voip/wx.requestDeviceVoIP.html
+     */
+    requestDeviceVoIP(option: requestDeviceVoIP.Option): Promise<TaroGeneral.CallbackResult>
+    /** 查询当前用户授权的音视频通话设备（组）信息
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/device-voip/wx.getDeviceVoIPList.html
+     */
+    getDeviceVoIPList(option: getDeviceVoIPList.Option): Promise<getDeviceVoIPList.SuccessCallbackResult>
+  }
+}

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

@@ -81,7 +81,7 @@ declare module '../../index' {
      *
      * 通过 Taro.login 接口获得的用户登录态拥有一定的时效性。用户越久未使用小程序，用户登录态越有可能失效。反之如果用户一直在使用小程序，则用户登录态一直保持有效。具体时效逻辑由微信维护，对开发者透明。开发者只需要调用 Taro.checkSession 接口检测当前用户登录态是否有效。
      *
-     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
+     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用 Taro.checkSession 成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
      * @supported weapp
      * @example
      * ```tsx

package/types/api/open-api/my-miniprogram.d.ts

@@ -8,7 +8,7 @@ declare module '../../index' {
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: TaroGeneral.CallbackResult) => void
+      success?: (res: SuccessCallbackResult) => void
     }
 
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
@@ -23,6 +23,6 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/my-miniprogram/wx.checkIsAddedToMyMiniProgram.html
      */
-    checkIsAddedToMyMiniProgram(option?: checkIsAddedToMyMiniProgram.Option):Promise<checkIsAddedToMyMiniProgram.SuccessCallbackResult>
+    checkIsAddedToMyMiniProgram(option?: checkIsAddedToMyMiniProgram.Option): void
   }
 }

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

@@ -0,0 +1,99 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace getPrivacySetting {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 是否需要用户授权隐私协议（如果开发者没有在[mp后台-设置-服务内容声明-用户隐私保护指引]中声明隐私收集类型则会返回false；如果开发者声明了隐私收集，且用户之前同意过隐私协议则会返回false；如果开发者声明了隐私收集，且用户还没同意过则返回true；如果用户之前同意过、但后来小程序又新增了隐私收集类型也会返回true） */
+      needAuthorization: boolean
+      /** 隐私授权协议的名称 */
+      privacyContractName: string
+    }
+  }
+
+  namespace requirePrivacyAuthorize {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace openPrivacyContract {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace onNeedPrivacyAuthorization {
+    /**
+     * resolve 是 onNeedPrivacyAuthorization 的回调参数，是一个接口函数。
+     * 当触发 needPrivacyAuthorization 事件时，触发该事件的隐私接口或组件会处于 pending 状态。
+     * 如果调用 resolve({ buttonId: 'disagree-btn'， event:'agree' })，则触发当前 needPrivacyAuthorization 事件的原隐私接口或组件会继续执行。其中 buttonId 为隐私同意授权按钮的id，为确保用户有同意的操作，基础库会检查对应的同意按钮是否被点击过。
+     * 如果调用 resolve({ event: 'disagree' })，则触发当前 needPrivacyAuthorization 事件的原隐私接口或组件会失败并返回 API:fail privacy permission is not authorized 的错误信息。
+     * 在调用 resolve({ event: 'agree'/'disagree' }) 之前，开发者可以调用 resolve({ event: 'exposureAuthorization' }) 把隐私弹窗曝光告知平台。
+     */
+    interface ResolveOption {
+      /** 用户操作类型 */
+      event: 'exposureAuthorization' | 'agree' | 'disagree'
+      /** 同意授权按钮的id （仅event=agree时必填） */
+      buttonId?: string
+    }
+    /**
+     * 触发本次 onNeedPrivacyAuthorization 事件的关联信息
+     */
+    interface EventInfo {
+      referrer: string
+    }
+
+    /** 隐私授权监听函数 */
+    type Listener = (
+      /** 事件回调函数 */
+      resolve: (option: ResolveOption) => void,
+      /** 关联事件信息 */
+      eventInfo: EventInfo
+    ) => void
+  }
+
+  interface TaroStatic {
+    /**
+     * 查询隐私授权情况。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.getPrivacySetting.html
+     */
+    getPrivacySetting(option?: getPrivacySetting.Option): void
+    /**
+     * 跳转至隐私协议页面。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.openPrivacyContract.html
+     */
+    openPrivacyContract(option?: openPrivacyContract.Option): void
+    /**
+     * 模拟隐私接口调用，并触发隐私弹窗逻辑。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.requirePrivacyAuthorize.html
+     */
+    requirePrivacyAuthorize(option?: requirePrivacyAuthorize.Option): void
+    /**
+     * 监听隐私接口需要用户授权事件。当需要用户进行隐私授权时会触发。触发该事件时，开发者需要弹出隐私协议说明，并在用户同意或拒绝授权后调用回调接口 resolve 触发原隐私接口或组件继续执行。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.onNeedPrivacyAuthorization.html
+     */
+    onNeedPrivacyAuthorization(listener: onNeedPrivacyAuthorization.Listener): void
+  }
+}

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

@@ -156,6 +156,7 @@ declare module '../../index' {
 
     /** 关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。
      * @supported weapp, h5, rn, tt
+     * @h5 未针对 tabbar 页面做限制处理
      * @example
      * ```tsx
      * Taro.redirectTo({
@@ -168,6 +169,7 @@ declare module '../../index' {
 
     /** 保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 Taro.navigateBack 可以返回到原页面。小程序中页面栈最多十层。
      * @supported weapp, h5, rn, tt
+     * @h5 未针对 tabbar 页面做限制处理
      * @example
      * ```tsx
      * Taro.navigateTo({
@@ -194,6 +196,7 @@ declare module '../../index' {
 
     /** 关闭当前页面，返回上一页面或多级页面。可通过 getCurrentPages 获取当前的页面栈，决定需要返回几层。
      * @supported weapp, h5, rn, tt
+     * @h5 若入参 delta 大于现有页面数时，返回应用打开的第一个页面（如果想要返回首页请使用 reLaunch 方法）。
      * @example
      * ```tsx
      * // 注意：调用 navigateTo 跳转时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。见下方示例代码

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

@@ -200,7 +200,7 @@ declare module '../../index' {
      * Taro.downloadFile({
      *   url: 'https://res.wx.qq.com/wxdoc/dist/assets/img/demo.ef5c5bef.jpg',
      *   success: (res) => {
-     *     wx.showShareImageMenu({
+     *     Taro.showShareImageMenu({
      *       path: res.tempFilePath
      *     })
      *   }

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

@@ -0,0 +1,59 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  /**
+   * Snapshot 实例，可通过 SelectorQuery 获取。
+   *
+   * Snapshot 通过 id 跟一个 snapshot 组件绑定，操作对应的 snapshot 组件。
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/Snapshot.html
+   */
+  interface Snapshot {
+    /**
+     * 画布宽度
+     */
+    width: number
+    /**
+     * 画布高度
+     */
+    height: number
+    /**
+     * 对 snapshot 组件子树进行截图
+     * @param option
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/Snapshot.takeSnapshot.html
+     */
+    takeSnapshot(option: Snapshot.TakeSnapshot.Option): Promise<TaroGeneral.CallbackResult>
+  }
+
+  namespace Snapshot {
+    namespace TakeSnapshot {
+      interface Option {
+        /**
+         * 截图导出类型，'file' 保存到临时文件目录或 'arraybuffer' 返回图片二进制数据，默认值为 'file'
+         */
+        type: string
+        /**
+         * 截图文件格式，'rgba' 或 'png'，默认值为 'png'
+         */
+        format: string
+        /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+        complete?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用失败的回调函数 */
+        fail?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用成功的回调函数 */
+        success?: (res: SuccessCallbackResult) => void
+      }
+
+      interface SuccessCallbackResult {
+        /**
+         * 截图保存的临时文件路径，当 type 为 file 该字段生效
+         */
+        tempFilePath: string
+        /**
+         * 截图对应的二进制数据，当 type 为 arraybuffer 该字段生效
+         */
+        data: string
+      }
+    }
+  }
+}