Node Functions

Overview

• Node module functions are used for node operations
• This module has no prefix; call functions directly
• After fetching nodes, lock them before searching to avoid issues with parent/child functions

getNodeInfo Get Node Collection

• timeout Timeout in milliseconds
• @return {array} Array of node objects

function main() {
    let nodes = text("aaa").getNodeInfo(0)
    if (nodes){
        logd(JSON.stringify(nodes))
        for (let i = 0; i < nodes.length; i++) {
            logd(JSON.stringify(nodes[i]))
            logd(nodes[i].text)
            logd(nodes[i].bounds.top)
            logd(nodes[i].bounds.centerX())
        }
    }
}

main();

getOneNodeInfo Get Single Node

• timeout Timeout in milliseconds
• @return {NodeInfo} Node object

function main() {
    let node = text("aaa").getOneNodeInfo(0);
    if (node){
        logd(JSON.stringify(node));
        logd(node.text)
        logd(node.bounds.top)
        logd(node.bounds.centerX())
    }
}

main();

Selector Functions

xpath Selection

• XPath selector; see https://www.jianshu.com/p/c205334122b3 and https://www.runoob.com/xpath/xpath-syntax.html
• Use the IDE node panel to inspect xpath attributes and test xpath
• @param value e.g. //node[@value='易点云测'] selects nodes whose value equals 易点云测 (EasyClick Cloud Test)

function main() {
    // Get selector object
    var selector = xpath("//node[@value='易点云测']");
    let n = selector.getNodeInfo(1000);
    logd(JSON.stringify(n))
}

main();

id id Exact Attribute Match

• Exact match on id attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by id
    let nd = id("Settings").getOneNodeInfo(1000)
    if (nd) {
        console.log("id search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("id search: node not found ")
    }
    // Search by regex
    nd = idMatch(".*Settings.*").getNodeInfo(1000)
    if (nd) {
        console.log("idMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("idMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

idMatch id Regex Attribute Match

• Regex match on id attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by id
    let nd = id("Settings").getOneNodeInfo(1000)
    if (nd) {
        console.log("id search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("id search: node not found ")
    }
    // Search by regex
    nd = idMatch(".*Settings.*").getNodeInfo(1000)
    if (nd) {
        console.log("idMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("idMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

key key Exact Attribute Match

• Exact match on key attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // key
    let nd = key("Settings").getOneNodeInfo(1000)
    if (nd) {
        console.log("key search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("key search: node not found ")
    }
    // Search by regex
    nd = keyMatch(".*Settings.*").getNodeInfo(1000)
    if (nd) {
        console.log("keyMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("keyMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

keyMatch key

• Regex match on key attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = keyMatch("Settings").getOneNodeInfo(1000)
    if (nd) {
        console.log("key search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("keyMatch search: node not found ")
    }
    // Search by regex
    nd = keyMatch(".*Settings.*").getNodeInfo(1000)
    if (nd) {
        console.log("keyMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("keyMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

type type Exact Attribute Match

• Exact match on type attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by type
    let nd = type("Item").getOneNodeInfo(1000)
    if (nd) {
        console.log("type search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("label search: node not found ")
    }
    // Search by type regex
    nd = typeMatch(".*Item.*").getNodeInfo(1000)
    if (nd) {
        console.log("typeMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("typeMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

typeMatch type Regex Attribute Match

• Regex match on type attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by type
    let nd = type("Item").getOneNodeInfo(1000)
    if (nd) {
        console.log("type search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("label search: node not found ")
    }
    // Search by type regex
    nd = typeMatch(".*Item.*").getNodeInfo(1000)
    if (nd) {
        console.log("typeMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("ltypeMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

hint hint Exact Attribute Match

• Exact match on hint attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = hint("123").getOneNodeInfo(1000)
    if (nd) {
        console.log("value search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("value search: node not found ")
    }
    nd = textMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("textMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("textMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

hintMatch hint Regex Attribute Match

• Regex match on hint attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = hintMatch("123").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    nd = textMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("textMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("textMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

text text Exact Attribute Match

• Exact match on text attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = text("123").getOneNodeInfo(1000)
    if (nd) {
        console.log("value search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("value search: node not found ")
    }
    nd = textMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("textMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("textMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

textMatch text Regex Attribute Match

• Regex match on text attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = text("123").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    nd = textMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("textMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("textMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

hostWindowId hostWindowId Exact Attribute Match

• Exact match on hostWindowId attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = hostWindowId("123").getOneNodeInfo(1000)
    if (nd) {
        console.log("value search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("value search: node not found ")
    }
    nd = hostWindowIdMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("hostWindowIdMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("hostWindowIdMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

hostWindowIdMatch hostWindowId

• Regex match on hostWindowId attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = hostWindowId("123").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    nd = hostWindowIdMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("textMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("textMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

description description Exact Attribute Match

• Exact match on description attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = description("123").getOneNodeInfo(1000)
    if (nd) {
        console.log("value search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("value search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

descriptionMatch description

• Regex match on description attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = description("123").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    nd = descriptionMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("descriptionMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("descriptionMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

bundleName bundleName Exact Attribute Match

• Exact match on bundleName attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = bundleName("123").getOneNodeInfo(1000)
    if (nd) {
        console.log("value search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("value search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

bundleNameMatch bundleName

• Regex match on bundleName attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = bundleName("123").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    nd = bundleNameMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("bundleNameMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("bundleNameMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

pagePath pagePath Exact Attribute Match

• Exact match on pagePath attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = pagePath("123").getOneNodeInfo(1000)
    if (nd) {
        console.log("value search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log("value search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

pagePathMatch pagePath

• Regex match on pagePath attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = pagePath("123").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    nd = pagePathMatch(".*123.*").getNodeInfo(1000)
    if (nd) {
        console.log("pagePathMatch search node info {} ", JSON.stringify(nd))
    } else {
        console.log("pagePathMatch search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

longClickable longClickable Exact Attribute Match

• Exact match on longClickable attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by longClickable
    let nd = longClickable(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

enable enable Exact Attribute Match

• Exact match on enable attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by enable
    let nd = enable(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

visible visible Exact Attribute Match

• Exact match on visible attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by visible
    let nd = visible(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

zIndex zIndex Exact Attribute Match

• Exact match on zIndex attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by zIndex
    let nd = zIndex(1).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

index index Exact Attribute Match

• Exact match on index attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by index
    let nd = index(1).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

depth depth Exact Attribute Match

• Exact match on depth attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by depth
    let nd = depth(1).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

focused focused Exact Attribute Match

• Exact match on focused attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = focused(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

enabled enabled Exact Attribute Match

• Exact match on enabled attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    let nd = enabled(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

selected selected Exact Attribute Match

• Exact match on selected attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by selected
    let nd = selected(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}
main()

checkable checkable Exact Attribute Match

• Exact match on checkable attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by checkable
    let nd = checkable(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}
main()

checked checked Exact Attribute Match

• Exact match on checked attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by checked
    let nd = checked(true).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}
function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}
main()

childcount childcount Exact Attribute Match

• Exact match on childcount attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by childCount
    let nd = childCount(2).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

bounds bounds Bounds Range Match

• Bounds range match on bounds attribute

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Search by bounds
    let nd = bounds(100, 100, 300, 300).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

Click Node

clickCenter Click Node Center

• Click the center of the node
• @return {bool} true on success, false on failure

function main() {
    let node = text("Maps").getOneNodeInfo(10000)
    logd(JSON.stringify(node))
    if (node) {
        logd(node.clickCenter())
    }

}

main()

clickRandom Click Node Randomly

• Click a random point within the node bounds
• @return {bool} true on success, false on failure

function main() {
    let node = text("Maps").getOneNodeInfo(10000)
    logd(JSON.stringify(node))
    if (node) {
        logd(node.clickRandom())
    }

}

main()

Multi-Attribute Cascaded Query

function main() {
    // Write your code here
    logd("Checking automation environment...")
    // If automation service is OK
    if (!autoServiceStart(3)) {
        logd("automation service failed to start; cannot run script")
        exit();
        return;
    }
    logd("Starting script...")
    // Release previous lock first
    releaseNode();
    // Lock new node data
    lockNode();
    // Begin node search
    // Cascaded attribute search
    let nd = textMatch(".*1.*").enabled(true).bounds(100, 100, 300, 300).getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        // Click if found
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
        logd("click it: {}", c)
    } else {
        console.log(" search: node not found ")
    }
    // Release previous lock first
    releaseNode();
}

function autoServiceStart(time) {
    for (let i = 0; i < time; i++) {
        if (isServiceOk()) {
            return true;
        }
        let started = startEnv();
        logd("Service start attempt " + (i + 1) + " result: " + started);
        if (isServiceOk()) {
            return true;
        }
    }
    return isServiceOk();
}

main()

Node Cascading Operations

Cascaded Get Single Node getOneNodeInfo

• Get the first node via selector
• @param timeout Wait time in ms; 0=no wait
• @return NodeInfo object or null

function main() {
    // Get selector object
    var node =type("Text").getOneNodeInfo(10000);
    if (node) {
        // Get one child node
        node = node.getOneNodeInfo(text("Ad"), 10000);
        if (!node) {
            toast("no child nodes");
            return;
        }
        var x = node.click();
        logd(x);
    } else {
        toast("no nodes");
    }
}

main();

Cascaded Get Multiple Nodes getNodeInfo

• Get node information
• @param timeout Wait time in ms; 0=no wait
• @return Collection of NodeInfo nodes

function main() {
    // Get selector object
    // Select nodes with type=Text
    var node = type("Text").getOneNodeInfo(10000);
    if (node) {
        // Get all child nodes
        node = node.getNodeInfo(text("Ad").type("Text"), 10000);
        if (!node) {
            toast("no child nodes");
            return;
        }
        var x = node[0].click();
        logd(x);
    } else {
        toast("no nodes");
    }
}

main();

parent Query Node Parent

• Query the node's parent
• @return {NodeInfo} Node object

function main() {
    // Begin node search
    let nd = textMatch(".*1.*").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        let parent = nd.parent()
        console.log(" search parent {} ", JSON.stringify(parent))
    } else {
        console.log(" search: node not found ")
    }
// Release previous lock first
    releaseNode();
}


main()

child Get Single Child Node

• Get a single child node
• @param index Child node index
• @return {NodeInfo} NodeInfo object or null

function main() {
    // Begin node search
    let nd = textMatch(".*1.*").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        let child1 = nd.child(0)
        console.log(" search child {} ", JSON.stringify(child1))
    } else {
        console.log(" search: node not found ")
    }
// Release previous lock first
    releaseNode();
}


main()

allChildren Get All Child Nodes

• Get all child nodes
• @return {array} Array of NodeInfo nodes

function main() {
    // Begin node search
    let nd = textMatch(".*1.*").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        let allChildren = nd.allChildren()
        console.log(" search allChildren {} ", JSON.stringify(allChildren))
    } else {
        console.log(" search: node not found ")
    }
// Release previous lock first
    releaseNode();
}


main()

siblings Get All Sibling Nodes

• All sibling nodes of the current node
• @return {array} Array of NodeInfo nodes

function main() {
    // Begin node search
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        let siblings = nd.siblings()
        console.log(" search siblings {} ", JSON.stringify(siblings))
    } else {
        console.log(" search: node not found ")
    }
// Release previous lock first
    releaseNode();
}

main()

previousSiblings Get Previous Sibling Nodes

• Sibling nodes before the current node
• Supported: EC HarmonyOS Next 1.0.0+
• @return {array} Array of NodeInfo nodes

function main() {
    // Begin node search
    let nd = textMatch(".*1.*").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        let previousSiblings = nd.previousSiblings()
        console.log(" search previousSiblings {} ", JSON.stringify(previousSiblings))
    } else {
        console.log(" search: node not found ")
    }
// Release previous lock first
    releaseNode();
}

main()

nextSiblings Get Next Sibling Nodes

• Sibling nodes after the current node
• @return {array} Array of NodeInfo nodes

function main() {
    // Begin node search
    let nd = textMatch(".*1.*").getOneNodeInfo(1000)
    if (nd) {
        console.log(" search node info {} ", JSON.stringify(nd))
        let nextSiblings = nd.nextSiblings()
        console.log(" search nextSiblings {} ", JSON.stringify(nextSiblings))
    } else {
        console.log(" search: node not found ")
    }
// Release previous lock first
    releaseNode();
}

main()