@tarojs/taro 3.3.8 → 3.3.12

package/html5.css

@@ -109,27 +109,27 @@
   margin-inline-end: 0;
   font-weight: bold;
 }
-:-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) .h5-h1 {
+:-webkit-any(.h5-article) .h5-h1 {
   font-size: 1.5em;
   margin-block-start: 0.83em;
   margin-block-end: 0.83em;
 }
-:-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) .h5-h1 {
+:-webkit-any(.h5-article) :-webkit-any(.h5-article) .h5-h1 {
   font-size: 1.17em;
   margin-block-start: 1em;
   margin-block-end: 1em;
 }
-:-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) .h5-h1 {
+:-webkit-any(.h5-article) :-webkit-any(.h5-article) :-webkit-any(.h5-article) .h5-h1 {
   font-size: 1em;
   margin-block-start: 1.33em;
   margin-block-end: 1.33em;
 }
-:-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) .h5-h1 {
+:-webkit-any(.h5-article) :-webkit-any(.h5-article) :-webkit-any(.h5-article) :-webkit-any(.h5-article) .h5-h1 {
   font-size: 0.83em;
   margin-block-start: 1.67em;
   margin-block-end: 1.67em;
 }
-:-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) :-webkit-any(.h5-article, .h5-aside, .h5-nav, .h5-section) .h5-h1 {
+:-webkit-any(.h5-article) :-webkit-any(.h5-article) :-webkit-any(.h5-article) :-webkit-any(.h5-article) :-webkit-any(.h5-article) .h5-h1 {
   font-size: 0.67em;
   margin-block-start: 2.33em;
   margin-block-end: 2.33em;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.3.8",
+  "version": "3.3.12",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -26,9 +26,9 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.3.8",
-    "@tarojs/runtime": "3.3.8",
-    "@tarojs/taro-h5": "3.3.8"
+    "@tarojs/api": "3.3.12",
+    "@tarojs/runtime": "3.3.12",
+    "@tarojs/taro-h5": "3.3.12"
   },
-  "gitHead": "51a672907177558f20d664e7c196fdb0bff41c75"
+  "gitHead": "0d7650ee4263efafacd87b9c8b69bb29b2a852c0"
 }

package/types/api/data-analysis/index.d.ts

@@ -0,0 +1,68 @@
+declare namespace Taro {
+  /** 自定义业务数据监控上报接口。
+   *
+   * **使用说明**
+   * 使用前，需要在「小程序管理后台-运维中心-性能监控-业务数据监控」中新建监控事件，配置监控描述与告警类型。每一个监控事件对应唯一的监控ID，开发者最多可以创建128个监控事件。
+   * @supported weapp
+   * @example
+   * ```tsx
+   * Taro.reportMonitor('1', 1)
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/data-analysis/wx.reportMonitor.html
+   */
+   function reportMonitor(
+    /** 监控ID，在「小程序管理后台」新建数据指标后获得 */
+    name: string,
+    /** 上报数值，经处理后会在「小程序管理后台」上展示每分钟的上报总量 */
+    value: number,
+  ): void
+
+  /** 自定义分析数据上报接口。使用前，需要在小程序管理后台自定义分析中新建事件，配置好事件名与字段。
+   * @supported weapp
+   * @example
+   * ```tsx
+   * Taro.reportAnalytics('purchase', {
+   *   price: 120,
+   *   color: 'red'
+   * })
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/data-analysis/wx.reportAnalytics.html
+   */
+  function reportAnalytics(
+    /** 事件名 */
+    eventName: string,
+    /** 上报的自定义数据，key 为配置中的字段名，value 为上报的数据。 */
+    data: General.IAnyObject,
+  ): void
+
+  /** 事件上报
+   * @supported weapp
+   * @example
+   * ```tsx
+   * Taro.reportEvent('purchase', {
+   *   price: 120,
+   *   color: 'red'
+   * })
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/data-analysis/wx.reportEvent.html
+   */
+  function reportEvent(
+    /** 事件名 */
+    eventId: string,
+    /** 上报的自定义数据，key 为配置中的字段名，value 为上报的数据。 */
+    data: General.IAnyObject,
+  ): void
+
+  /** 给定实验参数数组，获取对应的实验参数值
+   * @supported weapp
+   * @example
+   * ```tsx
+   * Taro.getExptInfoSync(['color'])
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/data-analysis/wx.getExptInfoSync.html
+   */
+  function getExptInfoSync(
+    /** 实验参数数组，不填则获取所有实验参数 */
+    keys?: Array<string>
+  ): General.IAnyObject
+}

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

@@ -469,12 +469,12 @@ declare namespace Taro {
     readFileSync(
       /** 要读取的文件的路径 */
       filePath: string,
+      /** 指定读取文件的字符编码，如果不传 encoding，则以 ArrayBuffer 格式读取文件的二进制内容 */
+      encoding?: keyof FileSystemManager.encoding,
       /**从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
       position?: number,
       /**指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
       length?: number,
-      /** 指定读取文件的字符编码，如果不传 encoding，则以 ArrayBuffer 格式读取文件的二进制内容 */
-      encoding?: keyof FileSystemManager.encoding,
     ): string | ArrayBuffer
     /** 获取文件的状态信息
      * @supported weapp

package/types/api/media/audio.d.ts

@@ -18,7 +18,7 @@ declare namespace Taro {
    *   success: function (res) {
    *     const filePath = res.tempFilePath
    *     Taro.playVoice({ filePath })
-   * 
+   *
    *     setTimeout(Taro.stopVoice, 5000)
    *   }
    * })
@@ -28,7 +28,7 @@ declare namespace Taro {
    * Taro.startRecord(params).then(res => {
    *   const filePath = res.tempFilePath
    *   Taro.playVoice({ filePath })
-   * 
+   *
    *   setTimeout(Taro.stopVoice, 5000)
    * })
    * ```
@@ -299,6 +299,10 @@ declare namespace Taro {
      * @default 1
      */
     volume: number
+    /** 播放速度。范围 0.5-2.0。
+     * @default 1
+     */
+    playbackRate: number
     /** 播放 */
     play(): void
     /** 暂停 */

package/types/api/media/image.d.ts

@@ -27,10 +27,14 @@ declare namespace Taro {
     interface Option {
       /** 需要预览的图片链接列表。 */
       urls: string[]
-      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
       /** 当前显示图片的链接 */
       current?: string
+      /** @support weapp 最低版本：2.13.0。是否显示长按菜单，默认值：true */
+      showmenu?: boolean
+      /** @support weapp 最低版本：2.13.0。origin: 发送完整的referrer; no-referrer: 不发送。格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；默认值：no-referrer */
+      referrerPolicy?: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: General.CallbackResult) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: General.CallbackResult) => void
       /** 接口调用成功的回调函数 */
@@ -50,6 +54,44 @@ declare namespace Taro {
    */
   function previewImage(option: previewImage.Option): Promise<General.CallbackResult>
 
+  namespace previewMedia {
+    interface Sources {
+      /** 图片或视频的地址 */
+      url: string
+      /** 资源的类型（图片或视频），默认值：image */
+      type?: 'image' | 'video'
+      /** 视频的封面图片 */
+      poster?: string
+    }
+    interface Option {
+      /** 需要预览的资源列表 */
+      sources: Sources[]
+      /** 当前显示的资源序号，默认值：0 */
+      current?:	number
+      /** 是否显示长按菜单	2.13.0，默认值：true */
+      showmenu?: boolean
+      /** origin: 发送完整的referrer; no-referrer: 不发送。格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；默认值：no-referrer */
+      referrerPolicy?: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: General.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: General.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: General.CallbackResult) => void
+    }
+  }
+  /** 预览图片和视频。
+   * @supported weapp 基础库 2.12.0 开始支持，低版本需做兼容处理。
+   * @example
+   * ```tsx
+   * Taro.previewMedia({
+   *   sources: []
+   * })
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.previewMedia.html
+   */
+  function previewMedia(option: previewMedia.Option): Promise<General.CallbackResult>
+
   namespace getImageInfo {
     interface Option {
       /** 图片的路径，可以是相对路径、临时文件路径、存储文件路径、网络图片路径 */

package/types/api/open-api/customer-service.d.ts

@@ -0,0 +1,41 @@
+declare namespace Taro {
+  namespace openCustomerServiceChat {
+    interface ExtInfo {
+      url: string
+    }
+    interface Option {
+      /** 客服信息 */
+      extInfo: ExtInfo
+      /** 企业ID */
+      corpId: string
+      /** 是否发送小程序气泡消息，默认值：false */
+      showMessageCard?: boolean
+      /** 气泡消息标题 */
+      sendMessageTitle?: string
+      /** 气泡消息小程序路径 */
+      sendMessagePath?: string
+      /** 气泡消息图片 */
+      sendMessageImg?: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: General.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: General.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: General.CallbackResult) => void
+    }
+  }
+
+  /** 打开微信客服。了解更多信息，可以参考微信客服介绍：https://work.weixin.qq.com/kf/。
+   * @supported weapp 基础库 2.19.0 开始支持，低版本需做兼容处理。
+   * @example
+   * ```tsx
+   * Taro.openCustomerServiceChat({
+   *   extInfo: {url: ''},
+   *   corpId: '',
+   *   success: function (res) { }
+   * })
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/service-chat/wx.openCustomerServiceChat.html
+   */
+  function openCustomerServiceChat(option?: openCustomerServiceChat.Option): Promise<General.CallbackResult>
+}

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

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

package/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Taro 类型定义文件
- * 
+ *
  * 目录结构
  * ├── api                                  小程序端能力 API
  * │   ├── ad
@@ -81,6 +81,7 @@
  * │   │   ├── soter.d.ts                   开放接口 -> 生物认证 API
  * |   |   ├── subscribe-message.d.ts       开放接口 -> 订阅消息 API
  * │   │   ├── user-info.d.ts               开放接口 -> 用户信息 API
+ * │   │   ├── customer-service.d.ts        开放接口 -> 微信客服 API
  * │   │   └── werun.d.ts                   开放接口 -> 微信运动 API
  * │   ├── route
  * │   │   └── index.d.ts                   路由 API
@@ -143,6 +144,7 @@
 /// <reference path="api/base/env.d.ts" />
 /// <reference path="api/canvas/index.d.ts" />
 /// <reference path="api/cloud/index.d.ts" />
+/// <reference path="api/data-analysis/index.d.ts" />
 /// <reference path="api/device/accelerometer.d.ts" />
 /// <reference path="api/device/battery.d.ts" />
 /// <reference path="api/device/ble.d.ts" />
@@ -185,18 +187,17 @@
 /// <reference path="api/open-api/address.d.ts" />
 /// <reference path="api/open-api/authorize.d.ts" />
 /// <reference path="api/open-api/card.d.ts" />
-/// <reference path="api/open-api/data-analysis.d.ts" />
 /// <reference path="api/open-api/facial.d.ts" />
 /// <reference path="api/open-api/invoice.d.ts" />
 /// <reference path="api/open-api/login.d.ts" />
 /// <reference path="api/open-api/navigate.d.ts" />
 /// <reference path="api/open-api/payment.d.ts" />
-/// <reference path="api/open-api/report.d.ts" />
 /// <reference path="api/open-api/settings.d.ts" />
 /// <reference path="api/open-api/soter.d.ts" />
 /// <reference path="api/open-api/subscribe-message.d.ts" />
 /// <reference path="api/open-api/user-info.d.ts" />
 /// <reference path="api/open-api/werun.d.ts" />
+/// <reference path="api/open-api/customer-service.d.ts" />
 /// <reference path="api/route/index.d.ts" />
 /// <reference path="api/share/index.d.ts" />
 /// <reference path="api/storage/background-fetch.d.ts" />

package/types/api/open-api/data-analysis.d.ts

@@ -1,19 +0,0 @@
-declare namespace Taro {
-  /** 自定义分析数据上报接口。使用前，需要在小程序管理后台自定义分析中新建事件，配置好事件名与字段。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.reportAnalytics('purchase', {
-   *   price: 120,
-   *   color: 'red'
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/data-analysis/wx.reportAnalytics.html
-   */
-  function reportAnalytics(
-    /** 事件名 */
-    eventName: string,
-    /** 上报的自定义数据，key 为配置中的字段名，value 为上报的数据。 */
-    data: General.IAnyObject,
-  ): void
-}

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

@@ -1,19 +0,0 @@
-declare namespace Taro {
-  /** 自定义业务数据监控上报接口。
-   *
-   * **使用说明**
-   * 使用前，需要在「小程序管理后台-运维中心-性能监控-业务数据监控」中新建监控事件，配置监控描述与告警类型。每一个监控事件对应唯一的监控ID，开发者最多可以创建128个监控事件。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.reportMonitor('1', 1)
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/report/wx.reportMonitor.html
-   */
-  function reportMonitor(
-    /** 监控ID，在「小程序管理后台」新建数据指标后获得 */
-    name: string,
-    /** 上报数值，经处理后会在「小程序管理后台」上展示每分钟的上报总量 */
-    value: number,
-  ): void
-}