tt.canIUse
收藏
我的收藏

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

判断小程序的 API、回调、参数、组件、Page 或 Component 实例的属性和方法等是否在当前版本可用。

语法

tt.canIUse(schema)

参数说明

schema

类型	默认值	必填	说明	最低支持版本
string		是	用来测试的能力，模式为 ${API}.${method}.${param}.${option} 或 ${component}.${attribute}.${option} 或 Page.${method} 或者 Page.${attribute} 或 Component.${method} 或 Component.${attribute}	3.41.0

schema 详细说明

值	说明	最低支持版本
${API}	API 名字	3.41.0
${method}	调用方式，有效值为 return、success、object、callback	3.41.0
${param}	参数或者返回值	3.41.0
${option}	参数的有效值或者返回值的属性或者组件属性的有效值	3.41.0
${component}	组件名字	3.41.0
${attribute}	组件属性	3.41.0

返回值

返回值是一个布尔值，表示在当前版本是否可用。

扫码体验

代码示例

开发者工具中预览

// 对象的属性或方法
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");

// Page 函数的 this 上的方法
tt.canIUse("Page.provide");
tt.canIUse("Page.setProvide");

// Component 函数的 this 上的方法
tt.canIUse("Component.inject");
tt.canIUse("Component.observers");

Bug & Tip

•

Tip：回调函数的名称以文档为准；

•

Tip：不支持 fail 和 complete 回调函数的判断；

•

Tip：支持 success 回调参数的判断，例如：tt.canIUse("request.success.data")；

•

Tip：纯 number 类型的属性不做支持。

tt.canIUse收藏我的收藏

语法