对象操作API
ATK对象操作API提供了两类方法:操作和属性。操作方法用于对控件执行具体的操作,而属性方法则用于获取控件的运行时属性。
在使用JavaScript API时,由于控件访问是异步的,因此获取属性的方法也是以方法的形式出现。这意味着调用属性时需要加上括号
()
,返回值是一个Promise
对象。如果在async
函数中使用,可以通过await
获取实际的值。
CukeTest 为Linux桌面应用中的控件提供了丰富的API,便于用户对控件进行各种操作和属性获取。这些API涵盖了常见的控件操作,如点击、输入文本、获取值等,同时也允许用户获取控件的各种属性,例如文本、状态、位置等。
通过这些API,可以轻松编写自动化脚本,以确保Linux桌面应用的各个功能模块正常工作。
常用方法
在使用ATK对象操作API时,以下是一些常见的操作和属性方法:
- 操作方法: 这些方法用于对控件执行实际的动作,例如点击按钮、选择列表项、滚动到某个位置等。
- 属性方法: 这些方法用于获取控件的运行时属性,例如获取控件的文本内容、检查控件是否可见、获取控件的位置等。
示例代码
以下是一个简单的示例,展示了如何使用ATK对象操作API获取属性和执行操作:
JavaScript
Python
// 假设我们有一个按钮控件
let button = model.getButton("Button");
// 点击按钮
await button.click();
// 获取按钮的文本属性
let buttonName = await button.name();
console.log(`按钮文本: ${buttonText}`);
# 假设我们有一个按钮控件
button = model.getButton("Button")
# 点击按钮
button.click()
# 获取按钮的文本属性
button_name = button.name()
print(f"按钮文本: {button_name}")
更多API介绍
更多控件的操作和属性的帮助可以在通用控件方法中找到,或者在模型管理器中查看。您还可以通过拖拽模型文件生成的脚本,按住Ctrl
键点击脚本头部的leanpro.atk
引用,跳转到类型定义文件以了解更多信息。