Version: next

Taro.getSystemInfo(res)

获取系统信息,支持 Promise 化使用。

参考文档

类型

(res?: Option) => Promise<Result>

参数

Option

参数类型必填说明
complete
(res: any) => void
接口调用结束的回调函数(调用成功、失败都会执行)
fail
(res: any) => void
接口调用失败的回调函数
success
(res: Result) => void
接口调用成功的回调函数

Result

注意:H5 端不支持 version、statusBarHeight、fontSizeSetting、SDKVersion

参数类型说明
SDKVersion
string
客户端基础库版本
albumAuthorized
boolean
允许微信使用相册的开关(仅 iOS 有效)
benchmarkLevel
number
设备性能等级(仅Android小游戏)。取值为:-2 或 0(该设备无法运行小游戏),-1(性能未知),>=1(设备性能值,该值越高,设备性能越好,目前最高不到50)
bluetoothEnabled
boolean
蓝牙的系统开关
brand
string
设备品牌
cameraAuthorized
boolean
允许微信使用摄像头的开关
fontSizeSetting
number
用户字体大小(单位px)。以微信客户端「我-设置-通用-字体大小」中的设置为准
language
string
微信设置的语言
locationAuthorized
boolean
允许微信使用定位的开关
locationEnabled
boolean
地理位置的系统开关
microphoneAuthorized
boolean
允许微信使用麦克风的开关
model
string
设备型号
notificationAlertAuthorized
boolean
允许微信通知带有提醒的开关(仅 iOS 有效)
notificationAuthorized
boolean
允许微信通知的开关
notificationBadgeAuthorized
boolean
允许微信通知带有标记的开关(仅 iOS 有效)
notificationSoundAuthorized
boolean
允许微信通知带有声音的开关(仅 iOS 有效)
pixelRatio
number
设备像素比
platform
string
客户端平台
safeArea
SafeAreaResult
在竖屏正方向下的安全区域
screenHeight
number
屏幕高度,单位px
screenWidth
number
屏幕宽度,单位px
statusBarHeight
number
状态栏的高度,单位px
system
string
操作系统及版本
version
string
微信版本号
wifiEnabled
boolean
Wi-Fi 的系统开关
windowHeight
number
可使用窗口高度,单位px
windowWidth
number
可使用窗口宽度,单位px
errMsg
string
调用结果

示例代码

示例 1

Taro.getSystemInfo({
success: res => console.log(res)
})
.then(res => console.log(res))

示例 2

Taro.getSystemInfo({
success: function (res) {
console.log(res.model)
console.log(res.pixelRatio)
console.log(res.windowWidth)
console.log(res.windowHeight)
console.log(res.language)
console.log(res.version)
console.log(res.platform)
}
})

API 支持度

API微信小程序H5React Native
Taro.getSystemInfo✔️✔️✔️