【愚公系列】《微信小程序开发解析》013-基础API

🏆 作者简介，愚公搬代码
🏆《头衔》：华为云特约编辑，华为云云享专家，华为开发者专家，华为产品云测专家，CSDN博客专家，CSDN商业化专家，阿里云专家博主，阿里云签约作者，腾讯云优秀博主，腾讯云内容共创官，掘金优秀博主，亚马逊技领云博主，51CTO博客专家等。
🏆《近期荣誉》：2022年度博客之星TOP2，2023年度博客之星TOP2，2022年华为云十佳博主，2023年华为云十佳博主等。
🏆《博客内容》：.NET、Java、Python、Go、Node、前端、IOS、Android、鸿蒙、Linux、物联网、网络安全、大数据、人工智能、U3D游戏、小程序等相关领域知识。
🏆🎉欢迎 👍点赞✍评论⭐收藏

---

🚀前言

随着移动互联网的快速发展，微信小程序因其轻量化和便捷性受到了广泛欢迎。作为一种创新的应用形式，小程序让开发者能够快速构建和发布应用，从而满足用户多样化的需求。在这一过程中，掌握微信小程序的基础API是每位开发者必不可少的技能。

🚀一、基础API

🔎1.boolean wx.canUse(string schema)

wx.canUse 是微信小程序中的一个 API，用于检查当前版本是否支持某个特定的接口或功能。此方法接受一个字符串参数 schema，表示要检查的接口或功能的名称，并返回一个布尔值，表示是否支持该接口或功能。

🦋1.1 使用方法

const canUse = wx.canUse('schema');
console.log(canUse); // 输出 true 或 false

🦋1.2 参数

• schema：需要检查的接口或功能的名称，类型为字符串。

🦋1.3 返回值

• boolean：返回 true 表示支持该接口或功能，返回 false 表示不支持该接口或功能。

🦋1.4 示例

假设我们要检查当前版本是否支持 wx.onBLECharacteristicValueChange 方法：

if (wx.canUse('wx.onBLECharacteristicValueChange')) {
   
  console.log('当前版本支持 wx.onBLECharacteristicValueChange');
  // 可以安全调用 wx.onBLECharacteristicValueChange 方法
} else {
   
  console.log('当前版本不支持 wx.onBLECharacteristicValueChange');
  // 提示用户更新微信版本或采取其他兼容措施
}

🦋1.5 使用场景

1. 版本兼容性检查：在开发微信小程序时，不同用户可能使用不同的微信版本。通过 wx.canUse 可以在运行时检查某些新特性或方法是否可用，从而避免调用不受支持的 API 导致程序崩溃。
2. 功能降级：如果某个新特性在部分老版本中不可用，可以通过 wx.canUse 提前判断，并提供替代方案或功能降级处理。

🦋1.6 注意事项

• schema 参数需要严格按照 API 名称传递，不支持模糊匹配。
• 在微信开发者工具中进行测试时，确保工具的版本是最新的，以便准确模拟最新的微信环境。

🔎2.Object wx.getSystemInfoSync()

wx.getSystemInfoSync() 和 wx.getSystemInfoAsync() 是微信小程序提供的两个用于获取系统信息的 API。它们的主要差异在于同步与异步的执行方式。

🦋2.1 wx.getSystemInfoSync()

wx.getSystemInfoSync() 是一个同步 API，调用该方法会立即返回系统信息对象。由于是同步执行，会阻塞代码的后续执行，直到系统信息获取完成。因此，使用时需要谨慎，避免在性能敏感的部分使用。

示例代码

try {
   
  const res = wx.getSystemInfoSync();
  console.log(res.model); // 设备型号
  console.log(res.pixelRatio); // 设备像素比
  console.log