Version: 2.x

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	微信小程序	H5	React Native
Taro.getSystemInfo	✔️	✔️	✔️