JSAPI reference

API Name

Function Description

my.canIUse

Judge whether the current Mini Program API, incoming parameter or return value, component, attribute, etc. are supported in the current version.

my.SDKVersion

Get the SDK version.

my.getAppIdSync

Obtain the Mini Program App ID synchronously.

my.getRunScene

Obtain the running version of the current Mini Program.

API Name

Function Description

my.offAppHide

Unlisten for the event that the mini program is switched to background from foreground.

my.offAppShow

Unlisten for the event that the mini program is switched to foreground from background.

my.onAppHide

Listen for the event that the mini program is switched to background from foreground.

my.onAppShow

Listen for the event that the mini program is switched to foreground from background.

my.offError

Unlisten for the event that JS errors occur in the mini program.

my.onError

Listen for the event that errors occur in the mini program.

my.offUnhandledRejection

Unlisten for the unhandledrejection event.

my.onUnhandledRejection

Listen for the unhandledrejection event.

API Name

Function Description

my.hideBackHome

Hide back to home button.

my.showNavigationBarLoading

Show navigation bar loading.

my.hideNavigationBarLoading

Hide navigation bar loading.

my.setNavigationBar

Set the navigation bar text and style.

API Name

Function Description

my.hideTabBar

Hide the tabBar.

my.setTabBarStyle

Set the style of tabBar.

API Name

Function Description

my.switchTab

Jump to the specified tabBar page and close all other pages that are not tabBar.

my.navigateTo

Maintain the current page and jump to the specified page within the application. Use my.navigateBack to return to the original page.

my.navigateBack

Close the current page and return to the previous one or more pages.

my.redirectTo

Close the current page and jump to the specified page within the application.

my.reLaunch

Close all current pages and jump to the specified page within the application.

API Name

Function Description

my.alert

Alert box.

my.confirm

Confirm box.

my.prompt

Prompt box.

my.showLoading

Show the loading hint.

my.hideLoading

Hide the loading hint.

my.showToast

Show a weak hint, which disappears in the specified seconds.

my.hideToast

Hide the weak hint.

my.showActionSheet

Display an operation menu.

API Name

Function Description

my.startPullDownRefresh

Start the pull-to-refresh function.

onPullDownRefresh

On the Page, customize the onPullDownRefresh function to listen to the pull-to-refresh event of user.

my.stopPullDownRefresh

Stop the pull-to-refresh for the current page.

API Name

Function Description

my.choosePhoneContact

Choose contact from system contact.

API Name

Function Description

my.datePicker

Open a date selection list.

API Name

Function Description

my.createAnimation

Create an instance of animation.

API Name

Function Description

my.createCanvasContext

Create the context of the canvas.

API Name

Function Description

my.hideKeyboard

Hide keyboard.

API Name

Function Description

my.pageScrollTo

Scroll to the destination location of the page.

API Name

Function Description

my.createSelectorQuery

Create an instance of SelectorQuery.

API Name

Function Description

my.multiLevelSelect

Multiple level selector, used for associated select with multiple levels.

API Name

Function Description

my.setBackgroundColor

Set background color.

API Name

Function Description

my.setCanPullDown

Set whether page can support pulldown.

API Name

Function Description

my.chooseImage

Choose image from camera or album of cellphone.

my.previewImage

Preview image.

my.saveImage

Save the online images to cellphone album.

my.getImageInfo

Get the information of the image.

my.compressImage

Compress large images to fulfill the size restrictions from some mini programs.

API Name

Function Description

my.chooseVideo

Shoot a video or choose a video from the album.

API Name

Function Description

my.createLottieContext

Create and return a Lottie context object lottieContext.

API Name

Function Description

my.getStorage

Get cached data.

my.getStorageSync

Get cached data synchronously.

my.setStorage

Store the data in the specified key in the local cache, which overlaps the original data corresponding to the key.

my.setStorageSync

Store synchronously the data in the specified key in the local cache.

my.removeStorage

Remove cached data.

my.removeStorageSync

Remove cached data synchronously.

my.clearStorage

Clear local data cache.

my.clearStorageSync

Clear local data cache synchronously.

API Name

Function Description

my.saveFile

Save file to the device.

my.getFileInfo

Get the information of the file.

my.getSavedFileInfo

Get the information of the saved file.

my.getSavedFileList

Get the information of all the saved file.

my.removeSavedFile

Remove the saved file.

my.chooseFileFromDisk

Choose a file to upload.

my.openDocument

Enable users to preview a PDF file within the mini program.

API Name

Function Description

my.getLocation

Get the current geographical location of the user.

my.openLocation

View the location on the built-in map.

my.chooseLocation

Open the built-in map to choose a location.

API Name

Function Description

my.createMapContext

Create and return a map context object mapContext.

my.calculateRoute

Calculate the route.

API Name

Function Description

my.request

Network request.

my.uploadFile

Upload the local resource to the developer server.

my.downloadFile

Download file resource to local location.

my.connectSocket

Create a WebSocket connection.

my.onSocketOpen

Listen to the event of enabling the WebSocket connection.

my.offSocketOpen

Unlisten to the event of enabling the WebSocket connection.

my.onSocketError

Listen to WebSocket error events.

my.offSocketError

Unlisten to WebSocket error events.

my.sendSocketMessage

Send data over WebSocket connection.

my.onSocketMessage

Listen to the event of receiving server messages by WebSocket.

my.offSocketMessage

Unlisten to the event of receiving server messages by WebSocket.

my.closeSocket

Close the WebSocket connection.

my.onSocketClose

Listen to the event of closing the WebSocket connection.

my.offSocketClose

Unlisten to the event of closing the WebSocket connection.

API Name

Function Description

my.getSystemInfo

Get system information.

API Name

Function Description

my.getNetworkType

Get the current network status.

API Name

Function Description

my.getClipboard

Get the clipboard data.

my.setClipboard

Set the clipboard data.

API Name

Function Description

my.watchShake

The watchshake function.

API Name

Function Description

my.onAccelerometerChange

Listen to the acceleration data event.

my.offAccelerometerChange

Unlisten to the acceleration data event.

API Name

Function Description

my.onCompassChange

Listen to the compass data change event.

my.offCompassChange

Unlisten to the compass data change event.

API Name

Function Description

my.vibrate

Invoke the vibrate ability of device.

API Name

Function Description

my.makePhoneCall

Make a phone call.

API Name

Function Description

my.getServerTime

Get the server time.

API Name

Function Description

my.onUserCaptureScreen

Listen to the capture screen event by users.

my.offUserCaptureScreen

Cancel the listen to the capture screen event by users.

API Name

Function Description

my.setKeepScreenOn

Set whether screen keeps awake.

my.getScreenBrightness

Get the screen brightness.

my.setScreenBrightness

Set the screen brightness.

API Name

Function Description

my.getScreenOrientation

Get screen orientation

my.setScreenOrientation

Set screen orientation

API Name

Function Description

my.openSetting

Open the mini program settings page.

my.getSetting

Obtain the user's current settings.

API Name

Function Description

my.addPhoneContact

Add contact to phone contact.

API Name

Function Description

my.showAuthGuide

Guide user to grant the authorization when the permission needed.

API Name

Function Description

my.scan

Call the scanning QR code function.

API Name

Function Description

my.onMemoryWarning

Listen to the insufficient memory alarm event.

my.offMemoryWarning

Unlisten to the insufficient memory alarm event.

API Name

Function Description

my.getBatteryInfo

Obtain the battery level and the charging state of the current device asynchronously.

my.getBatteryInfoSync

Obtain the battery level and the charging state of the current device synchronously.

Reference

Description

Bluetooth API Overview

Provide the system requirement and the process flow on how the Bluetooth APIs work.

Bluetooth API Error Codes

List the normal error code and relative solutions.

Bluetooth API FAQ

FAQs about using Bluetooth API.

API Name

Function Description

my.connectBLEDevice

Connect to low energy Bluetooth devices.

my.disconnectBLEDevice

Disconnect to low energy Bluetooth devices.

my.getBLEDeviceCharacteristics

Get the characteristics of low energy Bluetooth devices.

my.getBLEDeviceServices

Get all the low energy Bluetooth devices that are discovered, including the connected devices.

my.notifyBLECharacteristicValueChange

Enable the function to notify changes to the characteristic value.

my.offBLECharacteristicValueChange

Disable the function to notify changes to the characteristic value.

my.offBLEConnectionStateChanged

Disable the the event listener for the connection status.

my.onBLECharacteristicValueChange

Enable the event listener for changes to the characteristic value.

my.onBLEConnectionStateChanged

Enable the event listener for changes to the connection status, such as device lost and device disconnected.

my.readBLECharacteristicValue

Read the characteristic value.

my.writeBLECharacteristicValue

Write data to the characteristic value.

API Name

Function Description

my.closeBluetoothAdapter

Close the Bluetooth module in the mini program.

my.openBluetoothAdapter

Initialize the Bluetooth module in the mini program.

my.getBluetoothAdapterState

Check the Bluetooth adapter status in the mini program.

my.startBluetoothDevicesDiscovery

Start discovering Bluetooth devices.

my.stopBluetoothDevicesDiscovery

Stop discovering Bluetooth devices.

my.getBluetoothDevices

Get all the Bluetooth devices that are discovered, including those that are connected to the current device.

my.getConnectedBluetoothDevices

Get the Bluetooth devices that are connected.

my.onBluetoothDeviceFound

Use this API when a new Bluetooth device is found.

my.offBluetoothDeviceFound

Remove the Bluetooth devices that are found.

my.onBluetoothAdapterStateChange

Monitor the Bluetooth adapter state changes.

my.offBluetoothAdapterStateChange

Remove the Bluetooth adapter with a state change.

API name

Description

my.checkLocalBioAuthSupported

Check the availability of biometric authentication on the user's device.

my.startLocalBioAuth

Initiate a biometric authentication process on the user's device.

API Name

Function Description

my.showSharePanel

Trigger the sharing.

API Name

Function Description

my.getUpdateManager

Create an UpdateManager object.

API Name

Function Description

my.createWebViewContext

By creating webViewContext, mini program can send message to web-view. This API will create a webViewContext instance.

API Name

Function Description

my.getSiteInfo

Get the site information assigned by Alipay Connect.

API Name

Function Description

my.navigateToMiniProgram

Jump to another mini program.

my.navigateBackMiniProgram

Return to the previous mini program, only when another mini program jumps to the current mini program.

my.getAuthCode

Get auth code.

my.getOpenUserInfo

Get basic information about user.

my.tradePay

Start to pay.

my.crossPay

Start a payment transaction.

my.signContract

Sign the withholding contract.