@tarojs/taro-h5 3.3.16 → 3.3.17

package/dist/taroApis.js

@@ -1 +1 @@
-module.exports = new Set(["addCard","addInterceptor","addPhoneContact","advancedGeneralIdentify","animalClassify","arrayBufferToBase64","authorize","base64ToArrayBuffer","canIUse","canvasGetImageData","canvasPutImageData","canvasToTempFilePath","carClassify","checkIsSoterEnrolledInDevice","checkIsSupportFacialRecognition","checkIsSupportSoterAuthentication","checkSession","chooseAddress","chooseImage","chooseInvoice","chooseInvoiceTitle","chooseLocation","chooseVideo","clearStorage","clearStorageSync","closeBLEConnection","closeBluetoothAdapter","closeSocket","connectSocket","connectWifi","createAnimation","createAudioContext","createBLEConnection","createCameraContext","createCanvasContext","createInnerAudioContext","createIntersectionObserver","createLivePlayerContext","createLivePusherContext","createMapContext","createSelectorQuery","createVideoContext","createWorker","dishClassify","downloadFile","drawCanvas","exitMiniProgram","faceVerifyForPay","getAccountInfoSync","getAvailableAudioSources","getBLEDeviceCharacteristics","getBLEDeviceServices","getBackgroundAudioManager","getBackgroundAudioPlayerState","getBeacons","getBluetoothAdapterState","getBluetoothDevices","getClipboardData","getConnectedBluetoothDevices","getConnectedWifi","getExtConfig","getExtConfigSync","getFileInfo","getFileSystemManager","getHCEState","getImageInfo","getLocation","getLogManager","getMenuButtonBoundingClientRect","getNetworkType","getRecorderManager","getSavedFileInfo","getSavedFileList","getScreenBrightness","getSetting","getShareInfo","getStorage","getStorageInfo","getStorageInfoSync","getStorageSync","getSwanId","getSystemInfo","getSystemInfoSync","getUpdateManager","getUserInfo","getWeRunData","getWifiList","hideHomeButton","hideKeyboard","hideLoading","hideNavigationBarLoading","hideShareMenu","hideTabBar","hideTabBarRedDot","hideToast","imageAudit","initTabBarApis","loadFontFace","login","logoClassify","makePhoneCall","navigateBackMiniProgram","navigateBackSmartProgram","navigateToMiniProgram","navigateToSmartGameProgram","navigateToSmartProgram","notifyBLECharacteristicValueChange","objectDetectIdentify","ocrBankCard","ocrDrivingLicense","ocrIdCard","ocrVehicleLicense","offWindowResize","onAccelerometerChange","onBLECharacteristicValueChange","onBLEConnectionStateChange","onBackgroundAudioPause","onBackgroundAudioPlay","onBackgroundAudioStop","onBeaconServiceChange","onBeaconUpdate","onBluetoothAdapterStateChange","onBluetoothDeviceFound","onCompassChange","onDeviceMotionChange","onGetWifiList","onHCEMessage","onMemoryWarning","onNetworkStatusChange","onSocketClose","onSocketError","onSocketMessage","onSocketOpen","onUserCaptureScreen","onWifiConnected","onWindowResize","openBluetoothAdapter","openCard","openDocument","openLocation","openSetting","pageScrollTo","pauseBackgroundAudio","pauseVoice","plantClassify","playBackgroundAudio","playVoice","preloadSubPackage","previewImage","readBLECharacteristicValue","removeSavedFile","removeStorage","removeStorageSync","removeTabBarBadge","reportAnalytics","request","requestPayment","requestPolymerPayment","saveFile","saveImageToPhotosAlbum","saveVideoToPhotosAlbum","scanCode","seekBackgroundAudio","sendHCEMessage","sendSocketMessage","setBackgroundColor","setBackgroundTextStyle","setClipboardData","setEnableDebug","setInnerAudioOption","setKeepScreenOn","setNavigationBarColor","setNavigationBarTitle","setScreenBrightness","setStorage","setStorageSync","setTabBarBadge","setTabBarItem","setTabBarStyle","setTopBarText","setWifiList","showActionSheet","showLoading","showModal","showNavigationBarLoading","showShareMenu","showTabBar","showTabBarRedDot","showToast","startAccelerometer","startBeaconDiscovery","startBluetoothDevicesDiscovery","startCompass","startDeviceMotionListening","startFacialRecognitionVerify","startFacialRecognitionVerifyAndUploadVideo","startHCE","startPullDownRefresh","startRecord","startSoterAuthentication","startWifi","stopAccelerometer","stopBackgroundAudio","stopBeaconDiscovery","stopBluetoothDevicesDiscovery","stopCompass","stopDeviceMotionListening","stopHCE","stopPullDownRefresh","stopRecord","stopVoice","stopWifi","textReview","textToAudio","updateShareMenu","uploadFile","vibrateLong","vibrateShort","writeBLECharacteristicValue"])
+module.exports = new Set(["EditorContext","addCard","addFileToFavorites","addInterceptor","addPhoneCalendar","addPhoneContact","addPhoneRepeatCalendar","addVideoToFavorites","advancedGeneralIdentify","animalClassify","arrayBufferToBase64","authPrivateMessage","authorize","authorizeForMiniProgram","base64ToArrayBuffer","canIUse","canvasGetImageData","canvasPutImageData","canvasToTempFilePath","carClassify","checkIsOpenAccessibility","checkIsSoterEnrolledInDevice","checkIsSupportFacialRecognition","checkIsSupportSoterAuthentication","checkSession","chooseAddress","chooseContact","chooseImage","chooseInvoice","chooseInvoiceTitle","chooseLicensePlate","chooseLocation","chooseMedia","chooseMessageFile","choosePoi","chooseVideo","clearStorage","clearStorageSync","closeBLEConnection","closeBluetoothAdapter","closeSocket","cloud","compressImage","compressVideo","connectSocket","connectWifi","createAnimation","createAudioContext","createBLEConnection","createBLEPeripheralServer","createCameraContext","createCanvasContext","createInnerAudioContext","createIntersectionObserver","createInterstitialAd","createLivePlayerContext","createLivePusherContext","createMapContext","createMediaAudioPlayer","createMediaContainer","createMediaRecorder","createOffscreenCanvas","createRewardedVideoAd","createSelectorQuery","createTCPSocket","createUDPSocket","createVKSession","createVideoContext","createVideoDecoder","createWebAudioContext","createWorker","disableAlertBeforeUnload","dishClassify","drawCanvas","enableAlertBeforeUnload","exitMiniProgram","exitVoIPChat","faceDetect","faceVerifyForPay","getAccountInfoSync","getApp","getAvailableAudioSources","getBLEDeviceCharacteristics","getBLEDeviceRSSI","getBLEDeviceServices","getBLEMTU","getBackgroundAudioManager","getBackgroundAudioPlayerState","getBackgroundFetchData","getBackgroundFetchToken","getBatteryInfo","getBatteryInfoSync","getBeacons","getBluetoothAdapterState","getBluetoothDevices","getChannelsLiveInfo","getChannelsLiveNoticeInfo","getClipboardData","getConnectedBluetoothDevices","getConnectedWifi","getCurrentInstance","getCurrentPages","getEnterOptionsSync","getExptInfoSync","getExtConfig","getExtConfigSync","getFileInfo","getFileSystemManager","getGroupEnterInfo","getHCEState","getImageInfo","getLaunchOptionsSync","getLocation","getLogManager","getMenuButtonBoundingClientRect","getNFCAdapter","getNetworkType","getOpenUserInfo","getPerformance","getRandomValues","getRealtimeLogManager","getRecorderManager","getSavedFileInfo","getSavedFileList","getScreenBrightness","getSelectedTextRange","getSetting","getShareInfo","getStorage","getStorageInfo","getStorageInfoSync","getStorageSync","getSwanId","getSystemInfo","getSystemInfoSync","getUpdateManager","getUserCryptoManager","getUserInfo","getUserProfile","getVideoInfo","getWeRunData","getWifiList","hideHomeButton","hideKeyboard","hideLoading","hideNavigationBarLoading","hideShareMenu","hideTabBar","hideTabBarRedDot","hideToast","imageAudit","initFaceDetect","initTabBarApis","isBluetoothDevicePaired","joinVoIPChat","loadFontFace","login","logoClassify","makeBluetoothPair","makePhoneCall","navigateBack","navigateBackMiniProgram","navigateBackSmartProgram","navigateTo","navigateToMiniProgram","navigateToSmartGameProgram","navigateToSmartProgram","nextTick","notifyBLECharacteristicValueChange","objectDetectIdentify","ocrBankCard","ocrDrivingLicense","ocrIdCard","ocrVehicleLicense","offAccelerometerChange","offAppHide","offAppShow","offAudioInterruptionBegin","offAudioInterruptionEnd","offBLECharacteristicValueChange","offBLEConnectionStateChange","offBLEMTUChange","offBLEPeripheralConnectionStateChanged","offBeaconServiceChange","offBeaconUpdate","offBluetoothAdapterStateChange","offBluetoothDeviceFound","offCompassChange","offCopyUrl","offDeviceMotionChange","offError","offGetWifiList","offGyroscopeChange","offHCEMessage","offKeyboardHeightChange","offLocalServiceDiscoveryStop","offLocalServiceFound","offLocalServiceLost","offLocalServiceResolveFail","offLocationChange","offLocationChangeError","offMemoryWarning","offPageNotFound","offThemeChange","offUnhandledRejection","offUserCaptureScreen","offVoIPChatInterrupted","offVoIPChatMembersChanged","offVoIPChatStateChanged","offVoIPVideoMembersChanged","offWifiConnected","offWindowResize","onAccelerometerChange","onAppHide","onAppShow","onAudioInterruptionBegin","onAudioInterruptionEnd","onBLECharacteristicValueChange","onBLEConnectionStateChange","onBLEMTUChange","onBLEPeripheralConnectionStateChanged","onBackgroundAudioPause","onBackgroundAudioPlay","onBackgroundAudioStop","onBackgroundFetchData","onBeaconServiceChange","onBeaconUpdate","onBluetoothAdapterStateChange","onBluetoothDeviceFound","onCompassChange","onCopyUrl","onDeviceMotionChange","onError","onGetWifiList","onGyroscopeChange","onHCEMessage","onKeyboardHeightChange","onLocalServiceDiscoveryStop","onLocalServiceFound","onLocalServiceLost","onLocalServiceResolveFail","onLocationChange","onLocationChangeError","onMemoryWarning","onNetworkStatusChange","onPageNotFound","onSocketClose","onSocketError","onSocketMessage","onSocketOpen","onThemeChange","onUnhandledRejection","onUserCaptureScreen","onVoIPChatInterrupted","onVoIPChatMembersChanged","onVoIPChatSpeakersChanged","onVoIPChatStateChanged","onVoIPVideoMembersChanged","onWifiConnected","onWindowResize","openBluetoothAdapter","openCard","openChannelsActivity","openChannelsEvent","openChannelsLive","openCustomerServiceChat","openDocument","openEmbeddedMiniProgram","openLocation","openSetting","openVideoEditor","pageScrollTo","pauseBackgroundAudio","pauseVoice","plantClassify","playBackgroundAudio","playVoice","pluginLogin","preloadSubPackage","previewImage","previewMedia","reLaunch","readBLECharacteristicValue","redirectTo","removeSavedFile","removeStorage","removeStorageSync","removeTabBarBadge","reportAnalytics","reportEvent","reportMonitor","reportPerformance","request","requestOrderPayment","requestPayment","requestPolymerPayment","requestSubscribeMessage","reserveChannelsLive","revokeBufferURL","saveFile","saveFileToDisk","saveImageToPhotosAlbum","saveVideoToPhotosAlbum","scanCode","seekBackgroundAudio","sendHCEMessage","sendSocketMessage","setBLEMTU","setBackgroundColor","setBackgroundFetchToken","setBackgroundTextStyle","setClipboardData","setEnable1v1Chat","setEnableDebug","setInnerAudioOption","setKeepScreenOn","setNavigationBarColor","setNavigationBarTitle","setPageInfo","setScreenBrightness","setStorage","setStorageSync","setTabBarBadge","setTabBarItem","setTabBarStyle","setTopBarText","setVisualEffectOnCapture","setWifiList","setWindowSize","shareFileMessage","shareToWeRun","shareVideoMessage","showActionSheet","showLoading","showModal","showNavigationBarLoading","showRedPackage","showShareImageMenu","showShareMenu","showTabBar","showTabBarRedDot","showToast","startAccelerometer","startBeaconDiscovery","startBluetoothDevicesDiscovery","startCompass","startDeviceMotionListening","startFacialRecognitionVerify","startFacialRecognitionVerifyAndUploadVideo","startGyroscope","startHCE","startLocalServiceDiscovery","startLocationUpdate","startLocationUpdateBackground","startPullDownRefresh","startRecord","startSoterAuthentication","startWifi","stopAccelerometer","stopBackgroundAudio","stopBeaconDiscovery","stopBluetoothDevicesDiscovery","stopCompass","stopDeviceMotionListening","stopFaceDetect","stopGyroscope","stopHCE","stopLocalServiceDiscovery","stopLocationUpdate","stopPullDownRefresh","stopRecord","stopVoice","stopWifi","subscribeVoIPVideoMembers","switchTab","textReview","textToAudio","updateShareMenu","updateVoIPChatMuteConfig","updateWeChatApp","vibrateLong","vibrateShort","writeBLECharacteristicValue"])

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "@tarojs/taro-h5",
-  "version": "3.3.16",
+  "version": "3.3.17",
   "description": "Taro h5 framework",
-  "main:h5": "src/index.js",
+  "main:h5": "dist/index.js",
   "main": "dist/index.cjs.js",
-  "typings": "types/index.d.ts",
+  "typings": "src/types/index.d.ts",
   "files": [
     "dist",
     "src",
-    "index.js",
-    "types"
+    "index.js"
   ],
   "sideEffects": [
     "*.scss",
@@ -33,9 +32,10 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.3.16",
-    "@tarojs/router": "3.3.16",
-    "@tarojs/runtime": "3.3.16",
+    "@tarojs/api": "3.3.17",
+    "@tarojs/router": "3.3.17",
+    "@tarojs/runtime": "3.3.17",
+    "@tarojs/taro": "3.3.17",
     "base64-js": "^1.3.0",
     "jsonp-retry": "^1.0.3",
     "mobile-detect": "^1.4.2",
@@ -45,5 +45,5 @@
   "devDependencies": {
     "jest-fetch-mock": "^3.0.3"
   },
-  "gitHead": "75d3de695c98fab79998612ef87567a68ea981a7"
+  "gitHead": "3f3ce5f66d370b1982a30e4a5f2c8eb383652063"
 }

package/src/api/ad/index.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 广告
+export const createRewardedVideoAd = temporarilyNotSupport('createRewardedVideoAd')
+export const createInterstitialAd = temporarilyNotSupport('createInterstitialAd')

package/src/api/ai/facial.ts

@@ -0,0 +1,6 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 人脸识别
+export const stopFaceDetect = temporarilyNotSupport('stopFaceDetect')
+export const initFaceDetect = temporarilyNotSupport('initFaceDetect')
+export const faceDetect = temporarilyNotSupport('faceDetect')

package/src/api/ai/index.ts

@@ -0,0 +1,2 @@
+export * from './facial'
+export * from './visual'

package/src/api/ai/visual.ts

@@ -0,0 +1,4 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 视觉算法
+export const createVKSession = temporarilyNotSupport('createVKSession')

package/src/api/alipay/index.ts

@@ -0,0 +1,4 @@
+import { temporarilyNotSupport } from '../utils'
+
+// AliPay
+export const getOpenUserInfo = temporarilyNotSupport('getOpenUserInfo')

package/src/api/base/crypto.ts

@@ -0,0 +1,4 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 加密
+export const getUserCryptoManager = temporarilyNotSupport('getUserCryptoManager')

package/src/api/base/debug.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+export const setEnableDebug = temporarilyNotSupport('setEnableDebug')
+export const getRealtimeLogManager = temporarilyNotSupport('getRealtimeLogManager')
+export const getLogManager = temporarilyNotSupport('getLogManager')

package/src/api/base/index.ts

@@ -0,0 +1,23 @@
+import { fromByteArray, toByteArray } from 'base64-js'
+
+import { temporarilyNotSupport } from '../utils'
+
+// TODO env 环境变量
+
+export const canIUse = temporarilyNotSupport('canIUse')
+
+export function arrayBufferToBase64 (arrayBuffer) {
+  return fromByteArray(arrayBuffer)
+}
+
+export function base64ToArrayBuffer (base64) {
+  return toByteArray(base64)
+}
+
+export * from './system'
+export * from './update'
+export * from './weapp/life-cycle'
+export * from './weapp/app-event'
+export * from './debug'
+export * from './performance'
+export * from './crypto'

package/src/api/base/performance.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 性能
+export const reportPerformance = temporarilyNotSupport('reportPerformance')
+export const getPerformance = temporarilyNotSupport('getPerformance')

package/src/api/base/system/index.ts

@@ -0,0 +1,2 @@
+export { getSystemInfo, getSystemInfoSync } from './info'
+export { getNetworkType, onNetworkStatusChange } from './network'

package/src/api/base/system/info.ts

@@ -0,0 +1,64 @@
+import Taro from '@tarojs/api'
+import MobileDetect from 'mobile-detect'
+
+import { MethodHandler } from '../../utils/handler'
+
+export const getSystemInfoSync: typeof Taro.getSystemInfoSync = () => {
+  const md = new MobileDetect(navigator.userAgent)
+
+  const info: ReturnType<typeof Taro.getSystemInfoSync> = {
+    brand: md.mobile() || '', // 手机品牌
+    model: md.mobile() || '', // 手机型号
+    system: md.os(), // 操作系统版本
+    pixelRatio: window.devicePixelRatio, // 设备像素比
+    screenWidth: window.screen.width, // 屏幕宽度
+    screenHeight: window.screen.height, // 屏幕高度
+    windowWidth: document.documentElement.clientWidth, // 可使用窗口宽度
+    windowHeight: document.documentElement.clientHeight, // 可使用窗口高度
+    version: '', // 微信版本号
+    statusBarHeight: NaN, // 状态栏的高度
+    platform: navigator.platform, // 客户端平台
+    language: navigator.language, // 微信设置的语言
+    fontSizeSetting: NaN, // 用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px
+    SDKVersion: '', // 客户端基础库版本
+
+    // TODO
+    albumAuthorized: false,
+    benchmarkLevel: 0,
+    bluetoothEnabled: false,
+    cameraAuthorized: false,
+    enableDebug: false,
+    locationAuthorized: false,
+    locationEnabled: false,
+    microphoneAuthorized: false,
+    notificationAlertAuthorized: false,
+    notificationAuthorized: false,
+    notificationBadgeAuthorized: false,
+    notificationSoundAuthorized: false,
+    safeArea: {
+      bottom: 0,
+      height: 0,
+      left: 0,
+      right: 0,
+      top: 0,
+      width: 0
+    },
+    wifiEnabled: false
+  }
+
+  return info
+}
+
+export const getSystemInfo: typeof Taro.getSystemInfo = async (options = {}) => {
+  const { success, fail, complete } = options
+  const handle = new MethodHandler({ name: 'getSystemInfo', success, fail, complete })
+
+  try {
+    const info = await getSystemInfoSync()
+    return handle.success(info)
+  } catch (error) {
+    return handle.fail({
+      errMsg: error
+    })
+  }
+}

package/src/api/base/system/network.ts

@@ -0,0 +1,70 @@
+import Taro from '@tarojs/api'
+
+import { MethodHandler } from '../../utils/handler'
+import { temporarilyNotSupport } from '../../utils'
+
+function getConnection () {
+  // @ts-ignore
+  return navigator.connection || navigator.mozConnection || navigator.webkitConnection || navigator.msConnection
+}
+
+export const getNetworkType: typeof Taro.getNetworkType = (options = {}) => {
+  const connection = getConnection()
+  const { success, fail, complete } = options
+  const handle = new MethodHandler<Taro.getNetworkType.SuccessCallbackResult>({ name: 'getNetworkType', success, fail, complete })
+
+  let networkType: keyof Taro.getNetworkType.networkType = 'unknown'
+  // 浏览器不支持获取网络状态
+  if (!connection) {
+    return handle.success({ networkType })
+  }
+
+  // Supports only the navigator.connection.type value which doesn't match the latest spec.
+  // https://www.davidbcalhoun.com/2010/using-navigator-connection-android/
+  if (!isNaN(Number(connection.type))) {
+    switch (connection.type) {
+      // @ts-ignore
+      case connection.WIFI:
+        networkType = 'wifi'
+        break
+      // @ts-ignore
+      case connection.CELL_3G:
+        networkType = '3g'
+        break
+      // @ts-ignore
+      case connection.CELL_2G:
+        networkType = '2g'
+        break
+      default:
+        // ETHERNET, UNKNOWN
+        networkType = 'unknown'
+    }
+  } else if (connection.type) {
+    // @ts-ignore
+    networkType = connection.type // Only supports the type value.
+    // @ts-ignore
+  } else if (connection.effectiveType) {
+    // @ts-ignore
+    networkType = connection.effectiveType
+  }
+
+  return handle.success({ networkType })
+}
+
+export const onNetworkStatusChange: typeof Taro.onNetworkStatusChange = (cb) => {
+  const connection = getConnection()
+  if (connection) {
+    connection.addEventListener('change', function () {
+      getNetworkType()
+        .then(res => {
+          const { networkType } = res
+          const isConnected = networkType !== 'none'
+          const obj = { isConnected, networkType }
+          cb(obj)
+        })
+    })
+  }
+}
+
+export const offNetworkStatusChange = temporarilyNotSupport('offNetworkStatusChange')
+export const getLocalIPAddress = temporarilyNotSupport('getLocalIPAddress')

package/src/api/base/update.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 更新
+export const updateWeChatApp = temporarilyNotSupport('updateWeChatApp')
+export const getUpdateManager = temporarilyNotSupport('getUpdateManager')

package/src/api/base/weapp/app-event.ts

@@ -0,0 +1,19 @@
+import { temporarilyNotSupport } from '../../utils'
+
+// 应用级事件
+export const onUnhandledRejection = temporarilyNotSupport('onUnhandledRejection')
+export const onThemeChange = temporarilyNotSupport('onThemeChange')
+export const onPageNotFound = temporarilyNotSupport('onPageNotFound')
+export const onError = temporarilyNotSupport('onError')
+export const onAudioInterruptionEnd = temporarilyNotSupport('onAudioInterruptionEnd')
+export const onAudioInterruptionBegin = temporarilyNotSupport('onAudioInterruptionBegin')
+export const onAppShow = temporarilyNotSupport('onAppShow')
+export const onAppHide = temporarilyNotSupport('onAppHide')
+export const offUnhandledRejection = temporarilyNotSupport('offUnhandledRejection')
+export const offThemeChange = temporarilyNotSupport('offThemeChange')
+export const offPageNotFound = temporarilyNotSupport('offPageNotFound')
+export const offError = temporarilyNotSupport('offError')
+export const offAudioInterruptionEnd = temporarilyNotSupport('offAudioInterruptionEnd')
+export const offAudioInterruptionBegin = temporarilyNotSupport('offAudioInterruptionBegin')
+export const offAppShow = temporarilyNotSupport('offAppShow')
+export const offAppHide = temporarilyNotSupport('offAppHide')

package/src/api/base/weapp/life-cycle.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../../utils'
+
+// 生命周期
+export const getLaunchOptionsSync = temporarilyNotSupport('getLaunchOptionsSync')
+export const getEnterOptionsSync = temporarilyNotSupport('getEnterOptionsSync')

package/src/api/canvas/CanvasContext.ts

@@ -0,0 +1,230 @@
+import { CanvasGradient } from '@tarojs/api'
+
+interface IAction {
+  func: (...arr: any[]) => void
+  args: any[]
+}
+
+const TextBaseLineMap: Record<keyof Taro.CanvasContext.textBaseline, CanvasTextBaseline> = {
+  top: 'top',
+  bottom: 'bottom',
+  middle: 'middle',
+  normal: 'alphabetic'
+}
+
+export class CanvasContext implements Taro.CanvasContext {
+  __raw__: CanvasRenderingContext2D
+  actions: IAction[] = []
+
+  set ctx (e: CanvasRenderingContext2D) {
+    this.__raw__ = e
+  }
+
+  get ctx () {
+    return this.__raw__
+  }
+
+  canvas: HTMLCanvasElement
+
+  protected emptyActions () {
+    this.actions.length = 0
+  }
+
+  protected enqueueActions (func: IAction['func']) {
+    return (...args) => {
+      this.actions.push({
+        func,
+        args
+      })
+    }
+  }
+
+  set fillStyle (e) { this.enqueueActions(() => { this.ctx.fillStyle = e }) }
+  get fillStyle () { return this.ctx.fillStyle as string }
+  set font (e) { this.ctx.font = e }
+  get font () { return this.ctx.font }
+  set globalAlpha (e) { this.enqueueActions(() => { this.ctx.globalAlpha = e }) }
+  get globalAlpha () { return this.ctx.globalAlpha }
+  set globalCompositeOperation (e) { this.enqueueActions(() => { this.ctx.globalCompositeOperation = e }) }
+  get globalCompositeOperation () { return this.ctx.globalCompositeOperation }
+  set lineCap (e) { this.enqueueActions(() => { this.ctx.lineCap = e }) }
+  get lineCap () { return this.ctx.lineCap }
+  set lineDashOffset (e) { this.enqueueActions(() => { this.ctx.lineDashOffset = e }) }
+  get lineDashOffset () { return this.ctx.lineDashOffset }
+  set lineJoin (e) { this.enqueueActions(() => { this.ctx.lineJoin = e }) }
+  get lineJoin () { return this.ctx.lineJoin }
+  set lineWidth (e) { this.enqueueActions(() => { this.ctx.lineWidth = e }) }
+  get lineWidth () { return this.ctx.lineWidth }
+  set miterLimit (e) { this.enqueueActions(() => { this.ctx.miterLimit = e }) }
+  get miterLimit () { return this.ctx.miterLimit }
+  set shadowBlur (e) { this.enqueueActions(() => { this.ctx.shadowBlur = e }) }
+  get shadowBlur () { return this.ctx.shadowBlur }
+  set shadowColor (e) { this.enqueueActions(() => { this.ctx.shadowColor = e }) }
+  get shadowColor () { return this.ctx.shadowColor }
+  set shadowOffsetX (e) { this.enqueueActions(() => { this.ctx.shadowOffsetX = e }) }
+  get shadowOffsetX () { return this.ctx.shadowOffsetX }
+  set shadowOffsetY (e) { this.enqueueActions(() => { this.ctx.shadowOffsetY = e }) }
+  get shadowOffsetY () { return this.ctx.shadowOffsetY }
+  set strokeStyle (e) { this.enqueueActions(() => { this.ctx.strokeStyle = e }) }
+  get strokeStyle () { return this.ctx.strokeStyle as string }
+  /** 小程序文档中不包括 ↓↓↓ */
+  set textAlign (e) { this.ctx.textAlign = e }
+  get textAlign () { return this.ctx.textAlign }
+  set textBaseline (e) { this.ctx.textBaseline = e }
+  get textBaseline () { return this.ctx.textBaseline }
+  set direction (e) { this.ctx.direction = e }
+  get direction () { return this.ctx.direction }
+  set imageSmoothingEnabled (e) { this.enqueueActions(() => { this.ctx.imageSmoothingEnabled = e }) }
+  get imageSmoothingEnabled () { return this.ctx.imageSmoothingEnabled }
+  set imageSmoothingQuality (e) { this.enqueueActions(() => { this.ctx.imageSmoothingQuality = e }) }
+  get imageSmoothingQuality () { return this.ctx.imageSmoothingQuality }
+  set filter (e) { this.enqueueActions(() => { this.ctx.filter = e }) }
+  get filter () { return this.ctx.filter }
+  /** 小程序文档中不包括 ↑↑↑ */
+
+  arc = this.enqueueActions(this.ctx.arc)
+  arcTo = this.enqueueActions(this.ctx.arcTo)
+  beginPath = this.enqueueActions(this.ctx.beginPath)
+  bezierCurveTo = this.enqueueActions(this.ctx.bezierCurveTo)
+  clearRect = this.enqueueActions(this.ctx.clearRect)
+  clip = this.enqueueActions(this.ctx.clip)
+  closePath = this.enqueueActions(this.ctx.closePath)
+
+  createPattern (image: string, repetition: keyof Taro.CanvasContext.repetition): void {
+    return this.createPattern(image, repetition)
+  }
+
+  /**
+   * 将之前在绘图上下文中的描述（路径、变形、样式）画到 canvas 中。
+   * @todo 每次 draw 都会读取 width 和 height
+   */
+  async draw (reserve?: boolean, callback?: (...args: any[]) => any): Promise<void> {
+    try {
+      if (!reserve) {
+        this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height)
+      }
+
+      // 部分 action 是异步的
+      for (const { func, args } of this.actions) {
+        await func.apply(this.ctx, args)
+      }
+
+      this.emptyActions()
+      callback && callback()
+    } catch (e) {
+      /* eslint-disable no-throw-literal */
+      throw {
+        errMsg: e.message
+      }
+    }
+  }
+
+  drawImage (imageResource: string, ...extra: any[]): void {
+    type TExtra = [number, number]
+    this.enqueueActions(() => {
+      // 需要转换为 Image
+      if (typeof imageResource === 'string') {
+        const img = new Image()
+        img.src = imageResource
+        return new Promise<void>((resolve, reject) => {
+          img.onload = () => {
+            this.ctx.drawImage(img, ...extra as TExtra)
+            resolve()
+          }
+          img.onerror = reject
+        })
+      }
+
+      this.ctx.drawImage(imageResource, ...extra as TExtra)
+    })
+  }
+
+  fill = this.enqueueActions(this.ctx.fill)
+  fillRect = this.enqueueActions(this.ctx.fillRect)
+  fillText = this.enqueueActions(this.ctx.fillText)
+  lineTo = this.enqueueActions(this.ctx.lineTo)
+  moveTo = this.enqueueActions(this.ctx.moveTo)
+  quadraticCurveTo = this.enqueueActions(this.ctx.quadraticCurveTo)
+  rect = this.enqueueActions(this.ctx.rect)
+  restore = this.enqueueActions(this.ctx.restore)
+  rotate = this.enqueueActions(this.ctx.rotate)
+  save = this.enqueueActions(this.ctx.save)
+  scale = this.enqueueActions(this.ctx.scale)
+
+  setFillStyle (color: string | CanvasGradient): void {
+    this.enqueueActions(() => { this.ctx.fillStyle = color })
+  }
+
+  setFontSize (fontSize: number): void {
+    this.font = `${fontSize}px`
+  }
+
+  setGlobalAlpha (alpha: number): void {
+    this.globalAlpha = alpha
+  }
+
+  setLineCap (lineCap: keyof Taro.CanvasContext.lineCap): void {
+    this.lineCap = lineCap
+  }
+
+  setLineDash (pattern: number[], offset: number): void {
+    this.enqueueActions(() => {
+      this.ctx.setLineDash(pattern)
+      this.ctx.lineDashOffset = offset
+    })
+  }
+
+  setLineJoin (lineJoin: keyof Taro.CanvasContext.lineJoin): void {
+    this.lineJoin = lineJoin
+  }
+
+  setLineWidth (lineWidth: number): void {
+    this.lineWidth = lineWidth
+  }
+
+  setMiterLimit (miterLimit: number): void {
+    this.miterLimit = miterLimit
+  }
+
+  setShadow (offsetX: number, offsetY: number, blur: number, color: string): void {
+    this.enqueueActions(() => {
+      this.ctx.shadowOffsetX = offsetX
+      this.ctx.shadowOffsetY = offsetY
+      this.ctx.shadowColor = color
+      this.ctx.shadowBlur = blur
+    })
+  }
+
+  setStrokeStyle (color: string | CanvasGradient): void {
+    this.enqueueActions(() => { this.ctx.strokeStyle = color })
+  }
+
+  setTextAlign (align: keyof Taro.CanvasContext.align): void {
+    this.textAlign = align
+  }
+
+  setTextBaseline (textBaseline: keyof Taro.CanvasContext.textBaseline): void {
+    this.textBaseline = TextBaseLineMap[textBaseline] || 'alphabetic'
+  }
+
+  setTransform = this.enqueueActions(this.ctx.setTransform)
+  stroke = this.enqueueActions(this.ctx.stroke)
+  strokeRect = this.enqueueActions(this.ctx.strokeRect)
+  strokeText = this.enqueueActions(this.ctx.strokeText)
+  transform = this.enqueueActions(this.ctx.transform)
+  translate = this.enqueueActions(this.ctx.translate)
+
+  measureText (text: string): TextMetrics {
+    return this.measureText(text)
+  }
+
+  createCircularGradient (x: number, y: number, r: number): CanvasGradient {
+    const radialGradient = this.ctx.createRadialGradient(x, y, 0, x, y, r)
+
+    return radialGradient
+  }
+
+  createLinearGradient (x0: number, y0: number, x1: number, y1: number): CanvasGradient {
+    return this.createLinearGradient(x0, y0, x1, y1)
+  }
+}

package/src/api/canvas/canvasGetImageData.ts

@@ -0,0 +1,29 @@
+import Taro from '@tarojs/api'
+import { MethodHandler } from '../utils/handler'
+import { findDOM } from '../utils'
+
+/**
+ * 获取 canvas 区域隐含的像素数据。
+ */
+const canvasGetImageData: typeof Taro.canvasGetImageData = ({ canvasId, success, fail, complete, x, y, width, height }, inst) => {
+  const handle = new MethodHandler({ name: 'canvasGetImageData', success, fail, complete })
+  const el = findDOM(inst) as HTMLElement
+  const canvas = el?.querySelector(`canvas[canvas-id="${canvasId}"]`) as HTMLCanvasElement
+
+  try {
+    const ctx = canvas?.getContext('2d')
+    // TODO ImageData => Uint8ClampedArray
+    const data = ctx?.getImageData(x, y, width, height) as unknown as Uint8ClampedArray
+    return handle.success({
+      width,
+      height,
+      data
+    })
+  } catch (e) {
+    return handle.fail({
+      errMsg: e.message
+    })
+  }
+}
+
+export default canvasGetImageData

package/src/api/canvas/canvasPutImageData.ts

@@ -0,0 +1,26 @@
+import Taro from '@tarojs/api'
+import { MethodHandler } from '../utils/handler'
+import { findDOM } from '../utils'
+
+/**
+ * 将像素数据绘制到画布。在自定义组件下，第二个参数传入自定义组件实例 this，以操作组件内 <canvas> 组件
+ * @todo 暂未支持尺寸相关功能
+ */
+const canvasPutImageData: typeof Taro.canvasPutImageData = ({ canvasId, data, x, y, success, fail, complete }, inst) => {
+  const handle = new MethodHandler({ name: 'canvasPutImageData', success, fail, complete })
+  const el = findDOM(inst) as HTMLElement
+  const canvas = el?.querySelector(`canvas[canvas-id="${canvasId}"]`) as HTMLCanvasElement
+
+  try {
+    const ctx = canvas.getContext('2d')
+    // TODO Uint8ClampedArray => ImageData
+    ctx?.putImageData(data as unknown as ImageData, x, y)
+    return handle.success()
+  } catch (e) {
+    return handle.fail({
+      errMsg: e.message
+    })
+  }
+}
+
+export default canvasPutImageData

package/src/api/canvas/canvasToTempFilePath.ts

@@ -0,0 +1,26 @@
+import Taro from '@tarojs/api'
+import { findDOM } from '../utils'
+import { MethodHandler } from '../utils/handler'
+
+/**
+ * 把当前画布指定区域的内容导出生成指定大小的图片。在 draw() 回调里调用该方法才能保证图片导出成功。
+ * @todo 暂未支持尺寸相关功能
+ */
+const canvasToTempFilePath: typeof Taro.canvasToTempFilePath = ({ canvasId, fileType, quality, success, fail, complete }, inst) => {
+  const handle = new MethodHandler({ name: 'canvasToTempFilePath', success, fail, complete })
+  const el = findDOM(inst) as HTMLElement
+  const canvas = el?.querySelector(`canvas[canvas-id="${canvasId}"]`) as HTMLCanvasElement
+
+  try {
+    const dataURL = canvas?.toDataURL(`image/${fileType || 'png'}`, quality)
+    return handle.success({
+      tempFilePath: dataURL
+    })
+  } catch (e) {
+    return handle.fail({
+      errMsg: e.message
+    })
+  }
+}
+
+export default canvasToTempFilePath