Globals

client#

The device client, injected automatically. Gestures, apps, screen access and selectors are all its methods — client.click, client.session, client.label and so on.

declare const client: WDA.Client;

Возвращаемое значение

Пример

client.session('com.apple.Preferences');
var size = client.windowSize();

См. также client.session、client.click

params#

The script's parameters, injected automatically. Parameters added to a script in the console's Script Manager are read directly as params.name — no call needed.

declare const params: Record<string, string | number | boolean>;

Возвращаемое значение

Примечания

Пример

var keyword = params.keyword;
var rounds = params.rounds || 10;
logi('search ' + keyword + ', ' + rounds + ' rounds');

См. также getScriptConfig

getScriptConfig#

Read the extra configuration filled in for this script on the parameter page.

getScriptConfig(scriptName: string): unknown | null;

Параметры

Возвращаемое значение

Пример

var cfg = getScriptConfig('daily-like');

См. также params

getTaskId#

The current task's ID; getScriptId() returns the current script's ID.

getTaskId(): string;
getScriptId(): string;

Возвращаемое значение

Примечания

Пример

logi('task=' + getTaskId());

См. также getDeviceId

getDeviceId#

This device's ID in the system.

getDeviceId(): string;

Возвращаемое значение

Пример

logi('device=' + getDeviceId());

shouldStop#

Whether the task has been asked to stop. Long loops must check it; otherwise pressing Stop in the console only takes effect when the script finishes on its own.

shouldStop(): boolean;

Возвращаемое значение

Примечания

Пример

for (var i = 0; i < 100; i++) {
  if (shouldStop()) {
    return false;
  }
  client.swipeUp();
  sleep(randomFloat(1, 3));
}

См. также sleep

WDA.ErrorCode#

Every error carries a stable code in e.code. Branch on the code, never on the message text — the text is written for people and its wording changes. The full list is in the table at the end of this page.

declare const WDA: {
  ErrorCode: {
    ELEMENT_NOT_FOUND: "WDA_ELEMENT_NOT_FOUND";
    INVALID_ARGUMENT: "INVALID_ARGUMENT";
    FEATURE_UNAVAILABLE: "FEATURE_UNAVAILABLE";
    // …见下表 / see the table below
  };
};

Примечания

Пример

try {
  client.label('OK').click();
} catch (e) {
  if (e.code === WDA.ErrorCode.ELEMENT_NOT_FOUND) {
    loge('OK button not found');
  } else {
    throw e;
  }
}