tt.canIUse

基础库 1.35.0 开始支持本方法,这是一个同步方法。

判断小程序的 API,回调,参数,组件等是否在当前版本可用。

语法

tt.canIUse('swiper');
tt.canIUse('request.success.data');

参数说明

schema

类型默认值必填说明
string用来测试的能力

使用 ${API}.${method}.${param}.${option} 或者 ${component}.${attribute}.${option} 方式来调用。

schema 详细说明

参数说明
${API}API 名字
${method}调用方式,有效值为 return, success, object, callback
${param}参数或者返回值
${option}参数的有效值或者返回值的属性或者组件属性的有效值
${component}组件名字
${attribute}组件属性

返回值

boolean

当前版本是否可用。

代码示例

对象的属性或方法

tt.canIUse("UpdateManager");
tt.canIUse("Stats.isDirectory");

接口参数、回调或者返回值

tt.canIUse("exitMiniProgram");
tt.canIUse("getLaunchOptionsSync.return.path");
tt.canIUse("getSystemInfo.success.screenWidth");
tt.canIUse("showToast.object.title");
tt.canIUse("onCompassChange.callback.direction");
tt.canIUse("request.object.method.GET");

组件的属性

tt.canIUse("swiper");
tt.canIUse("text.selectable");
tt.canIUse("button.open-type.contact");

Bug & Tip

  • Tip:回调函数的名称以文档为准。
  • Tip:不支持 fail 和 complete 回调函数的判断。
  • Tip:支持 success 回调参数的判断。例如:
tt.canIUse("request.success.data");
  • Tip:纯 number 类型的属性不做支持。
点击纠错