/* * Copyright (C) 2022 Huawei Device Co., Ltd. * Licensed under the Apache License,Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing,software * distributed under the License is distributed on an "ASIS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * @file * @kit TestKit */ import { Callback } from './@ohos.base'; /** * Enumerates the string value match pattern. * * @enum {number} * @syscap SystemCapability.Test.UiTest * @since 8 */ /** * Enumerates the string value match pattern. * * @enum {number} * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 */ /** * Enumerates the string value match pattern. * * @enum {number} * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 */ declare enum MatchPattern { /** * Equals to a string. * * @syscap SystemCapability.Test.UiTest * @since 8 * @test */ /** * Equals to a string. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Equals to a string. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ EQUALS = 0, /** * Contains a substring. * * @syscap SystemCapability.Test.UiTest * @since 8 * @test */ /** * Contains a substring. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Contains a substring. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ CONTAINS = 1, /** * StartsWith a substring. * * @syscap SystemCapability.Test.UiTest * @since 8 * @test */ /** * StartsWith a substring. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * StartsWith a substring. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ STARTS_WITH = 2, /** * EndsWith a substring. * * @syscap SystemCapability.Test.UiTest * @since 8 * @test */ /** * EndsWith a substring. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * EndsWith a substring. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ ENDS_WITH = 3 } /** * Describes the attribute requirements for the target UiComponents. * * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On */ declare class By { /** * Specifies the text for the target UiComponent. * * @param { string } txt The text value. * @param { MatchPattern } pattern The {@link MatchPattern} of the text value,default to {@link MatchPattern.EQUALS} * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#text * @test */ text(txt: string, pattern?: MatchPattern): By; /** * Specifies the inspector key of the target UiComponent. * * @param { string } key The inspectorKey value. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#id * @test */ key(key: string): By; /** * Specifies the id of the target UiComponent. * * @param { number } id The id value. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @test */ id(id: number): By; /** * Specifies the type of the target UiComponent. * * @param { string } tp The type value. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#type * @test */ type(tp: string): By; /** * Specifies the clickable status of the target UiComponent. * * @param { boolean } b The clickable status,default to true. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#clickable * @test */ clickable(b?: boolean): By; /** * Specifies the scrollable status of the target UiComponent. * * @param { boolean } b The scrollable status,default to true. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#scrollable * @test */ scrollable(b?: boolean): By; /** * Specifies the enabled status of the target UiComponent. * * @param { boolean } b The enabled status,default to true. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#enabled * @test */ enabled(b?: boolean): By; /** * Specifies the focused status of the target UiComponent. * * @param { boolean } b The focused status,default to true. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#focused * @test */ focused(b?: boolean): By; /** * Specifies the selected status of the target UiComponent. * * @param { boolean } b The selected status,default to true. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#selected * @test */ selected(b?: boolean): By; /** * Requires the target UiComponent which is before another UiComponent that specified by the given {@link By} * object,used to locate UiComponent relatively. * * @param { By } by Describes the attribute requirements of UiComponent which the target one is in front of. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#isBefore * @test */ isBefore(by: By): By; /** * Requires the target UiComponent which is after another UiComponent that specified by the given {@link By} * object,used to locate UiComponent relatively. * * @param { By } by Describes the attribute requirements of UiComponent which the target one is in back of. * @returns { By } this {@link By} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.On#isAfter * @test */ isAfter(by: By): By; } /** * Represents a UiComponent of the ohos application,user can perform operations or query attributes on it. * * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.uitest.Component * @test */ declare class UiComponent { /** * Click this {@link UiComponent}. * * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#click * @test */ click(): Promise; /** * Double click this {@link UiComponent}. * * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#doubleClick * @test */ doubleClick(): Promise; /** * Long click this {@link UiComponent}. * * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#longClick * @test */ longClick(): Promise; /** * Get the id attribute value. * * @returns { Promise } the id value. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @test */ getId(): Promise; /** * Get the inspectorKey attribute value. * * @returns { Promise } the inspectorKey value. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#getId * @test */ getKey(): Promise; /** * Get the text attribute value. * * @returns { Promise } the text value. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#getText * @test */ getText(): Promise; /** * Get the type name. * * @returns { Promise } the type name. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#getType * @test */ getType(): Promise; /** * Get the clickable status of this {@link UiComponent}. * * @returns { Promise } the clickable status. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#isClickable * @test */ isClickable(): Promise; /** * Get the scrollable status of this {@link UiComponent}. * * @returns { Promise } the scrollable status. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#isScrollable * @test */ isScrollable(): Promise; /** * Get the enabled status of this {@link UiComponent}. * * @returns { Promise } the enabled status. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#isEnabled * @test */ isEnabled(): Promise; /** * Get the focused status of this {@link UiComponent}. * * @returns { Promise } the focused status. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#isFocused * @test */ isFocused(): Promise; /** * Get the selected status of this {@link UiComponent}. * * @returns { Promise } the selected status. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#isSelected * @test */ isSelected(): Promise; /** * Inject text to this {@link UiComponent},applicable to TextInput. * * @param { string } text The text to inject. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#inputText * @test */ inputText(text: string): Promise; /** * Scroll on this {@link UiComponent}to find matched {@link UiComponent},applicable to scrollable one. * * @param { By } by The attribute requirements of the target {@link UiComponent}. * @returns { Promise } the found result,or undefined if not found. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Component#scrollSearch * @test */ scrollSearch(by: By): Promise; } /** * The unified facade of UiTest framework,can be used to find {@link UiComponent},trigger keyEvents,perform * coordinates-based UI actions,capture screen and so on. * * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.uitest.Driver * @test */ declare class UiDriver { /** * Create an {@link UiDriver} object. * * @returns { UiDriver } the {@link UiDriver} object. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#create * @test */ static create(): UiDriver; /** * Delay with specified duration. * * @param { number } duration The delay duration in milliseconds. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#delayMs * @test */ delayMs(duration: number): Promise; /** * Find the first matched {@link UiComponent} on current UI. * * @param { By } by The attribute requirements of the target {@link UiComponent}. * @returns { Promise } the first matched {@link UiComponent} or undefined. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#findComponent * @test */ findComponent(by: By): Promise; /** * Find all the matched {@link UiComponent}s on current UI. * * @param { By } by The attribute requirements of the target {@link UiComponent}. * @returns { Promise> } the matched {@link UiComponent}s list. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#findComponents * @test */ findComponents(by: By): Promise>; /** * Assert the matched {@link UiComponent}s exists on current UI;if not,assertError will be raised. * * @param { By } by The attribute requirements of the target {@link UiComponent}. * @returns { Promise } * @throws {BusinessError} 401 - if the input parameters are invalid. * @throws {BusinessError} 17000002 - if the async function was not called with await. * @throws {BusinessError} 17000003 - if the assertion failed. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#assertComponentExist * @test */ assertComponentExist(by: By): Promise; /** * Press the BACK key. * * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#pressBack * @test */ pressBack(): Promise; /** * Press the specified key. * * @param { number } keyCode the target keyCode. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#triggerKey * @test */ triggerKey(keyCode: number): Promise; /** * Click on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#click * @test */ click(x: number, y: number): Promise; /** * DoubleClick on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#doubleClick * @test */ doubleClick(x: number, y: number): Promise; /** * LongClick on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#longClick * @test */ longClick(x: number, y: number): Promise; /** * Swipe on the screen between the specified points. * * @param { number } startx The x-coordinate of the starting point. * @param { number } starty The y-coordinate of the starting point. * @param { number } endx The x-coordinate of the ending point. * @param { number } endy The y-coordinate of the ending point. * @returns { Promise } * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.UiTest.Driver#swipe * @test */ swipe(startx: number, starty: number, endx: number, endy: number): Promise; /** * Capture current screen and save as picture which PNG format. * * @param { string } savePath the path where to store the picture. * @returns { Promise } true if screen-capturing and file-storing are completed successfully,false otherwise. * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.uitest.Driver#screenCap * @test */ screenCap(savePath: string): Promise; } /** * Enumerates the window mode of the tested window. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Enumerates the window mode of the tested window. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ declare enum WindowMode { /** * The test window is a full screen window. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * The test window is a full screen window. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ FULLSCREEN = 0, /** * The test window is the first window in the split screen state. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * The test window is the first window in the split screen state. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ PRIMARY = 1, /** * The test window is the second window in the split screen state. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * The test window is the second window in the split screen state. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ SECONDARY = 2, /** * The test window is a floating window. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * The test window is a floating window. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ FLOATING = 3 } /** * Enumerates the resize direction for the window. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Enumerates the resize direction for the window. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ declare enum ResizeDirection { /** * Left. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Left. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ LEFT = 0, /** * Right. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Right. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ RIGHT = 1, /** * Up. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Up. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ UP = 2, /** * Down. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Down. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ DOWN = 3, /** * Upper left. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Upper left. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ LEFT_UP = 4, /** * Lower left. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Lower left. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ LEFT_DOWN = 5, /** * Upper right. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Upper right. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ RIGHT_UP = 6, /** * Lower right. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Lower right. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ RIGHT_DOWN = 7 } /** * Enumerates the rotation of the device display. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Enumerates the rotation of the device display. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ declare enum DisplayRotation { /** * Device display does not rotate to display vertically. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Device display does not rotate to display vertically. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ ROTATION_0 = 0, /** * Device display rotates 90 degrees clockwise to display horizontally. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Device display rotates 90 degrees clockwise to display horizontally. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ ROTATION_90 = 1, /** * Device display rotates clockwise 180 degrees to display vertically in reverse. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Device display rotates clockwise 180 degrees to display vertically in reverse. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ ROTATION_180 = 2, /** * Device display rotates 270 degrees clockwise to display horizontally in reverse. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Device display rotates 270 degrees clockwise to display horizontally in reverse. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ ROTATION_270 = 3 } /** * Represents the point on the device screen. * * @typedef Point * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Represents the point on the device screen. * * @typedef Point * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 */ /** * Represents the point on the device screen. * * @typedef Point * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 */ declare interface Point { /** * The x-coordinate of the coordinate point. * * @type { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The x-coordinate of the coordinate point. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 */ /** * The x-coordinate of the coordinate point. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 */ readonly x: number; /** * The y-coordinate of the coordinate point. * * @type { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The y-coordinate of the coordinate point. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 */ /** * The y-coordinate of the coordinate point. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 */ readonly y: number; } /** * Represents the rectangle area on the device screen. * * @typedef Rect * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Represents the rectangle area on the device screen. * * @typedef Rect * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ /** * Represents the rectangle area on the device screen. * * @typedef Rect * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 */ declare interface Rect { /** * The x-coordinate of the top left corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The x-coordinate of the top left corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ /** * The x-coordinate of the top left corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 */ readonly left: number; /** * The y-coordinate of the top left corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The y-coordinate of the top left corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ /** * The y-coordinate of the top left corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 */ readonly top: number; /** * The x-coordinate at the bottom right corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The x-coordinate at the bottom right corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ /** * The x-coordinate at the bottom right corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 */ readonly right: number; /** * The y-coordinate at the bottom right corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The y-coordinate at the bottom right corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ /** * The y-coordinate at the bottom right corner of the rectangle. * * @type { number } * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 */ readonly bottom: number; } /** * Represents filer condition to get the window . * * @typedef WindowFilter * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Represents filer condition to get the window . * * @typedef WindowFilter * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ declare interface WindowFilter { /** * The package name of the application which the window belongs to. * * @type { ?string } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The package name of the application which the window belongs to. * * @type { ?string } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ bundleName?: string; /** * The title of the window. * * @type { ?string } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The title of the window. * * @type { ?string } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ title?: string; /** * The focal state of the window. * * @type { ?boolean } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The focal state of the window. * * @type { ?boolean } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ focused?: boolean; /** * The active state of the window. * * @type { ?boolean } * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * The active state of the window. * * @type { ?boolean } * @syscap SystemCapability.Test.UiTest * @since 11 * @deprecated since 11 * @useinstead ohos.UiTest.WindowFilter#active */ actived?: boolean; /** * The active state of the window. * * @type { ?boolean } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ active?: boolean; } /** * Represents the information of an UI element, can be a component or window. * * @typedef UIElementInfo * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Represents the information of an UI element, can be a component or window. * * @typedef UIElementInfo * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ declare interface UIElementInfo { /** * The bundle name of the host application. * @type { string } * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * The bundle name of the host application. * @type { string } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ readonly bundleName: string; /** * The component type, set it as 'window' if it's a window. * @type { string } * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * The component type, set it as 'window' if it's a window. * @type { string } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ readonly type: string; /** * The text of component, set it as window's title if it's a window. * @type { string } * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * The text of component, set it as window's title if it's a window. * @type { string } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ readonly text: string; } /** * Observer to monitor UI events. * * @typedef UIEventObserver * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Observer to monitor UI events. * * @typedef UIEventObserver * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ declare interface UIEventObserver { /** * Listen for toast show once * * @param { 'toastShow' } type 'toastShow'. * @param { Callback } callback function, returns the monitored UIElementInfo. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Listen for toast show once * * @param { 'toastShow' } type -'toastShow'. * @param { Callback } callback - function, returns the monitored UIElementInfo. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ once(type: 'toastShow', callback: Callback): void; /** * Listen for dialog show once * * @param { 'dialogShow' } type 'dialogShow'. * @param { Callback } callback function, returns the monitored UIElementInfo. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Listen for dialog show once * * @param { 'dialogShow' } type - 'dialogShow'. * @param { Callback } callback - function, returns the monitored UIElementInfo. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ once(type: 'dialogShow', callback: Callback): void; } /** * Enumerates the direction for the UI operation . * * @enum { number } * @syscap SystemCapability.Test.UiTest * @since 10 */ /** * Enumerates the direction for the UI operation . * * @enum { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ declare enum UiDirection { /** * Left. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Left. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ LEFT = 0, /** * Right. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Right. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ RIGHT = 1, /** * Up. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Up. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ UP = 2, /** * Down. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Down. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ DOWN = 3 } /** * Enumerates the id of the button on the mouse. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @since 10 */ /** * Enumerates the id of the button on the mouse. * * @enum { number } * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ declare enum MouseButton { /** * Left button of the mouse. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Left button of the mouse. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ MOUSE_BUTTON_LEFT = 0, /** * Right button of the mouse.. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Right button of the mouse.. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ MOUSE_BUTTON_RIGHT = 1, /** * MIDDLE button of the mouse. * * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * MIDDLE button of the mouse. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ MOUSE_BUTTON_MIDDLE = 2 } /** * Describes the attribute requirements for the target Components. * * @syscap SystemCapability.Test.UiTest * @since 9 */ /** * Describes the attribute requirements for the target Components. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 */ /** * Describes the attribute requirements for the target Components. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 */ declare class On { /** * Specifies the text for the target Component. * * @param { string } txt The text value. * @param { MatchPattern } pattern The {@link MatchPattern} of the text value, default to {@link MatchPattern.EQUALS} * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the text for the target Component. * * @param { string } txt The text value. * @param { MatchPattern } pattern The {@link MatchPattern} of the text value, default to {@link MatchPattern.EQUALS} * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the text for the target Component. * * @param { string } txt - the text value. * @param { MatchPattern } [pattern] - the {@link MatchPattern} of the text value,Set it default {@link MatchPattern.EQUALS} if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ text(txt: string, pattern?: MatchPattern): On; /** * Specifies the id of the target Component. * * @param { string } id The id value. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the id of the target Component. * * @param { string } id The id value. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the id of the target Component. * * @param { string } id - the id value. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ id(id: string): On; /** * Specifies the type of the target Component. * * @param { string } tp The type value. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the type of the target Component. * * @param { string } tp The type value. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the type of the target Component. * * @param { string } tp - The type value. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ type(tp: string): On; /** * Specifies the clickable status of the target Component. * * @param { boolean } b The clickable status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the clickable status of the target Component. * * @param { boolean } b The clickable status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the clickable status of the target Component. * * @param { boolean } [b] - the clickable status.Set it default true if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ clickable(b?: boolean): On; /** * Specifies the longClickable status of the target Component. * * @param { boolean } b The clickable status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the longClickable status of the target Component. * * @param { boolean } b The clickable status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the longClickable status of the target Component. * * @param { boolean } [b] - the longClickable status.Set it default true if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ longClickable(b?: boolean): On; /** * Specifies the scrollable status of the target Component. * * @param { boolean } b The scrollable status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the scrollable status of the target Component. * * @param { boolean } b The scrollable status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the scrollable status of the target Component. * * @param { boolean } [b] - the scrollable status.Set it default true if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ scrollable(b?: boolean): On; /** * Specifies the enabled status of the target Component. * * @param { boolean } b The enabled status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the enabled status of the target Component. * * @param { boolean } b The enabled status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the enabled status of the target Component. * * @param { boolean } [b] - the enabled status.Set it default true if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ enabled(b?: boolean): On; /** * Specifies the focused status of the target Component. * * @param { boolean } b The focused status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the focused status of the target Component. * * @param { boolean } b The focused status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the focused status of the target Component. * * @param { boolean } [b] - the focused status.Set it default true if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ focused(b?: boolean): On; /** * Specifies the selected status of the target Component. * * @param { boolean } b The selected status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the selected status of the target Component. * * @param { boolean } b The selected status,default to true. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the selected status of the target Component. * * @param { boolean } [b] the - selected status.Set it default true if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ selected(b?: boolean): On; /** * Specifies the checked status of the target Component. * * @param { boolean } b The checked status,default to false. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the checked status of the target Component. * * @param { boolean } b The checked status,default to false. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the checked status of the target Component. * * @param { boolean } [b] - the checked status.Set it default false if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ checked(b?: boolean): On; /** * Specifies the checkable status of the target Component. * * @param { boolean } b The checkable status,default to false. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Specifies the checkable status of the target Component. * * @param { boolean } b The checkable status,default to false. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Specifies the checkable status of the target Component. * * @param { boolean } [b] - the checkable status.Set it default false if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. 1. Incorrect parameter types; 2. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ checkable(b?: boolean): On; /** * Requires that the target Component which is before another Component that specified by the given {@link On} * object,used to locate Component relatively. * * @param { On } on Describes the attribute requirements of Component which the target one is in front of. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Requires that the target Component which is before another Component that specified by the given {@link On} * object,used to locate Component relatively. * * @param { On } on - describes the attribute requirements of Component which the target one is in front of. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isBefore(on: On): On; /** * Requires that the target Component which is after another Component that specified by the given {@link On} * object,used to locate Component relatively. * * @param { On } on Describes the attribute requirements of Component which the target one is in back of. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Requires that the target Component which is after another Component that specified by the given {@link On} * object,used to locate Component relatively. * * @param { On } on - describes the attribute requirements of Component which the target one is in back of. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isAfter(on: On): On; /** * Requires that the target Component which is inside of another Component that specified by the given {@link On} * object,used to locate Component relatively. * * @param { On } on Describes the attribute requirements of Component which the target one is inside of. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Requires that the target Component which is inside of another Component that specified by the given {@link On} * object,used to locate Component relatively. * * @param { On } on - describes the attribute requirements of Component which the target one is inside of. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ within(on: On): On; /** * Specifies the bundleName of the application which the window that the target Component is located belongs. * * @param { string } bundleName The bundleName of the specified window. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Specifies the bundleName of the application which the window that the target Component is located belongs. * * @param { string } bundleName - the bundleName of the specified window. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ inWindow(bundleName: string): On; /** * Specifies the description for the target Component. * * @param { string } val - the description value. * @param { MatchPattern } [pattern] - the {@link MatchPattern} of description value,set it default {@link MatchPattern.EQUALS} if null or undefined. * @returns { On } this {@link On} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ description(val: string, pattern?: MatchPattern): On; } /** * Represents an Component of the ohos application,user can perform operations or query attributes on it. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Represents an Component of the ohos application,user can perform operations or query attributes on it. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ /** * Represents an Component of the ohos application,user can perform operations or query attributes on it. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 * @test */ declare class Component { /** * Click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ click(): Promise; /** * Double click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Double click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Double click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ doubleClick(): Promise; /** * Long click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Long click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Long click this {@link Component}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ longClick(): Promise; /** * Get the id attribute value. * * @returns { Promise } the id value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the id attribute value. * * @returns { Promise } the id value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the id attribute value. * * @returns { Promise } the id value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ getId(): Promise; /** * Get the text attribute value. * * @returns { Promise } the text value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the text attribute value. * * @returns { Promise } the text value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the text attribute value. * * @returns { Promise } the text value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ getText(): Promise; /** * Get the type name. * * @returns { Promise } the type name. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the type name. * * @returns { Promise } the type name. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the type name. * * @returns { Promise } the type name. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ getType(): Promise; /** * Get the clickable status of this {@link Component}. * * @returns { Promise } the clickable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the clickable status of this {@link Component}. * * @returns { Promise } the clickable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the clickable status of this {@link Component}. * * @returns { Promise } the clickable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isClickable(): Promise; /** * Get the longClickable status of this {@link Component}. * * @returns { Promise } the longClickable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the longClickable status of this {@link Component}. * * @returns { Promise } the longClickable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the clickable status of this {@link Component}. * * @returns { Promise } the clickable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isLongClickable(): Promise; /** * Get the scrollable status of this {@link Component}. * * @returns { Promise } the scrollable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the scrollable status of this {@link Component}. * * @returns { Promise } the scrollable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the scrollable status of this {@link Component}. * * @returns { Promise } the scrollable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isScrollable(): Promise; /** * Get the enabled status of this {@link Component}. * * @returns { Promise } the enabled status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the enabled status of this {@link Component}. * * @returns { Promise } the enabled status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the enabled status of this {@link Component}. * * @returns { Promise } the enabled status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isEnabled(): Promise; /** * Get the focused status of this {@link Component}. * * @returns { Promise } the focused status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the focused status of this {@link Component}. * * @returns { Promise } the focused status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the focused status of this {@link Component}. * * @returns { Promise } the focused status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isFocused(): Promise; /** * Get the selected status of this {@link Component}. * * @returns { Promise } the selected status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the selected status of this {@link Component}. * * @returns { Promise } the selected status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the selected status of this {@link Component}. * * @returns { Promise } the selected status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isSelected(): Promise; /** * Get the checked status of this {@link Component}. * * @returns { Promise } the checked status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the checked status of this {@link Component}. * * @returns { Promise } the checked status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the checked status of this {@link Component}. * * @returns { Promise } the checked status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isChecked(): Promise; /** * Get the checkable status of this {@link Component}. * * @returns { Promise } the checkable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the checkable status of this {@link Component}. * * @returns { Promise } the checkable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the checkable status of this {@link Component}. * * @returns { Promise } the checkable status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ isCheckable(): Promise; /** * Inject text to this {@link Component},applicable to TextInput. * * @param { string } text The text to inject. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Inject text to this {@link Component},applicable to TextInput. * * @param { string } text The text to inject. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Inject text to this {@link Component},applicable to TextInput. * * @param { string } text - the text to inject. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ inputText(text: string): Promise; /** * Clear text of this {@link Component},applicable to TextInput. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Clear text of this {@link Component},applicable to TextInput. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Clear text of this {@link Component},applicable to TextInput. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 10 * @test */ clearText(): Promise; /** * Scroll on this {@link Component} to the top,applicable to scrollable one. * * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Scroll on this {@link Component} to the top,applicable to scrollable one. * * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Scroll on this {@link Component} to the top,applicable to scrollable one. * * @param { number } [speed] - the speed of swipe(pixels per second),ranges from 200 to 40000.Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ scrollToTop(speed?: number): Promise; /** * Scroll on this {@link Component} to the bottom,applicable to scrollable one. * * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Scroll on this {@link Component} to the bottom,applicable to scrollable one. * * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Scroll on this {@link Component} to the bottom,applicable to scrollable one. * * @param { number } [speed] - the speed of swipe(pixels per second),ranges from 200 to 40000. Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ scrollToBottom(speed?: number): Promise; /** * Scroll on this {@link Component}to find matched {@link Component},applicable to scrollable one. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise } the found result,or undefined if not found. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Scroll on this {@link Component}to find matched {@link Component},applicable to scrollable one. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise } the found result,or undefined if not found. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Scroll on this {@link Component}to find matched {@link Component},applicable to scrollable one. * * @param { On } on - the attribute requirements of the target {@link Component}. * @returns { Promise } the found result,or undefined if not found. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 10 * @test */ scrollSearch(on: On): Promise; /** * Get the bounds rect of this {@link Component}. * * @returns { Promise } the bounds rect object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the bounds rect of this {@link Component}. * * @returns { Promise } the bounds rect object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ /** * Get the bounds rect of this {@link Component}. * * @returns { Promise } the bounds rect object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 * @test */ getBounds(): Promise; /** * Get the boundsCenter of this {@link Component}. * * @returns { Promise } the boundsCenter object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the boundsCenter of this {@link Component}. * * @returns { Promise } the boundsCenter object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Get the boundsCenter of this {@link Component}. * * @returns { Promise } the boundsCenter object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ getBoundsCenter(): Promise; /** * Drag this {@link Component} to the bounds rect of target Component. * * @param { Component } target The target {@link Component}. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Drag this {@link Component} to the bounds rect of target Component. * * @param { Component } target - the target {@link Component}. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ dragTo(target: Component): Promise; /** * Pinch enlarge this {@link Component} to the target scale. * * @param { number } scale The scale of the pinch enlarge this {@link Component}'s size. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Pinch enlarge this {@link Component} to the target scale. * * @param { number } scale - the scale of the pinch enlarge this {@link Component}'s size, ranges greater than 1. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ pinchOut(scale: number): Promise; /** * Pinch shrink this {@link Component} to the target scale. * * @param { number } scale The scale of the pinch shrink this {@link Component}'s size. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Pinch shrink this {@link Component} to the target scale. * * @param { number } scale - the scale of the pinch shrink this {@link Component}'s size, ranges from 0 to 1. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ pinchIn(scale: number): Promise; /** * Get the description attribute value. * * @returns { Promise } the description value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the component is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getDescription(): Promise; } /** * The unified facade of UiTest framework,can be used to find {@link Component},trigger keyEvents,perform * coordinates-based UI actions,capture screen and so on. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * The unified facade of UiTest framework,can be used to find {@link Component},trigger keyEvents,perform * coordinates-based UI actions,capture screen and so on. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ /** * The unified facade of UiTest framework,can be used to find {@link Component},trigger keyEvents,perform * coordinates-based UI actions,capture screen and so on. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 12 * @test */ declare class Driver { /** * Create an {@link Driver} object. * * @returns { Driver } the {@link Driver} object. * @throws { BusinessError } 17000001 - if the test framework failed to initialize. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Create an {@link Driver} object. * * @returns { Driver } the {@link Driver} object. * @throws { BusinessError } 17000001 - if the test framework failed to initialize. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Create an {@link Driver} object. * * @returns { Driver } the {@link Driver} object. * @throws { BusinessError } 17000001 - if the test framework failed to initialize. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ static create(): Driver; /** * Delay with specified duration. * * @param { number } duration The delay duration in milliseconds. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Delay with specified duration. * * @param { number } duration The delay duration in milliseconds. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Delay with specified duration. * * @param { number } duration - the delay duration in milliseconds, not less than 0. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ delayMs(duration: number): Promise; /** * Find the first matched {@link Component} on current UI. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise } the first matched {@link Component} or undefined. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Find the first matched {@link Component} on current UI. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise } the first matched {@link Component} or undefined. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Find the first matched {@link Component} on current UI. * * @param { On } on - the attribute requirements of the target {@link Component}. * @returns { Promise } the first matched {@link Component} or undefined. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ findComponent(on: On): Promise; /** * Find the first matched {@link UiWindow} window. * * @param { WindowFilter } filter The filer condition of the target {@link UiWindow}. * @returns { Promise } the first matched {@link UiWindow} or undefined. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Find the first matched {@link UiWindow} window. * * @param { WindowFilter } filter - the filer condition of the target {@link UiWindow}. * @returns { Promise } the first matched {@link UiWindow} or undefined. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ findWindow(filter: WindowFilter): Promise; /** * Find the first matched {@link Component} on current UI during the time given. * * @param { On } on The attribute requirements of the target {@link Component}. * @param { number } time Duration of finding in milliseconds * @returns { Promise } the first matched {@link Component} or undefined. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Find the first matched {@link Component} on current UI during the time given. * * @param { On } on - the attribute requirements of the target {@link Component}. * @param { number } time - duration of finding in milliseconds, not less than 0. * @returns { Promise } the first matched {@link Component} or undefined. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ waitForComponent(on: On, time: number): Promise; /** * Find all the matched {@link Component}s on current UI. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise> } the matched {@link Component}s list. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Find all the matched {@link Component}s on current UI. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise> } the matched {@link Component}s list. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Find all the matched {@link Component}s on current UI. * * @param { On } on - the attribute requirements of the target {@link Component}. * @returns { Promise> } the matched {@link Component}s list. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ findComponents(on: On): Promise>; /** * Assert t the matched {@link Component}s exists on current UI;if not,assertError will be raised. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000003 - if the assertion failed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Assert t the matched {@link Component}s exists on current UI;if not,assertError will be raised. * * @param { On } on The attribute requirements of the target {@link Component}. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000003 - if the assertion failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Assert t the matched {@link Component}s exists on current UI;if not,assertError will be raised. * * @param { On } on - the attribute requirements of the target {@link Component}. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000003 - if the assertion failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ assertComponentExist(on: On): Promise; /** * Press the BACK key. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Press the BACK key. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Press the BACK key. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ pressBack(): Promise; /** * Press the specified key. * * @param { number } keyCode the target keyCode. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Press the specified key. * * @param { number } keyCode - the target keyCode. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ triggerKey(keyCode: number): Promise; /** * Press two or three key combinations * * @param { number } key0 the first keyCode. * @param { number } key1 the second keyCode. * @param { number } key2 the third keyCode. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Press two or three key combinations * * @param { number } key0 - the first keyCode. * @param { number } key1 - the second keyCode. * @param { number } [key2] - the third keyCode,set it default 0 if null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ triggerCombineKeys(key0: number, key1: number, key2?: number): Promise; /** * Click on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Click on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Click on the specified location on the screen. * * @param { number } x - the x-coordinate, not less than 0. * @param { number } y - the y-coordinate, not less than 0. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ click(x: number, y: number): Promise; /** * DoubleClick on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * DoubleClick on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * DoubleClick on the specified location on the screen. * * @param { number } x - the x-coordinate, not less than 0. * @param { number } y - the y-coordinate, not less than 0. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ doubleClick(x: number, y: number): Promise; /** * LongClick on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * LongClick on the specified location on the screen. * * @param { number } x The x-coordinate. * @param { number } y The y-coordinate. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * LongClick on the specified location on the screen. * * @param { number } x - the x-coordinate, not less than 0. * @param { number } y - the y-coordinate, not less than 0. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ longClick(x: number, y: number): Promise; /** * Swipe on the screen between the specified points. * * @param { number } startx The x-coordinate of the starting point. * @param { number } starty The y-coordinate of the starting point. * @param { number } endx The x-coordinate of the ending point. * @param { number } endy The y-coordinate of the ending point. * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Swipe on the screen between the specified points. * * @param { number } startx The x-coordinate of the starting point. * @param { number } starty The y-coordinate of the starting point. * @param { number } endx The x-coordinate of the ending point. * @param { number } endy The y-coordinate of the ending point. * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Swipe on the screen between the specified points. * * @param { number } startx - the x-coordinate of the starting point, not less than 0. * @param { number } starty - the y-coordinate of the starting point, not less than 0. * @param { number } endx - the x-coordinate of the ending point, not less than 0. * @param { number } endy - the y-coordinate of the ending point, not less than 0. * @param { number } [speed] - the speed of swipe(pixels per second),ranges from 200 to 40000. Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ swipe(startx: number, starty: number, endx: number, endy: number, speed?: number): Promise; /** * Drag on the screen between the specified points. * * @param { number } startx The x-coordinate of the starting point. * @param { number } starty The y-coordinate of the starting point. * @param { number } endx The x-coordinate of the ending point. * @param { number } endy The y-coordinate of the ending point. * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Drag on the screen between the specified points. * * @param { number } startx - the x-coordinate of the starting point, not less than 0. * @param { number } starty - the y-coordinate of the starting point, not less than 0. * @param { number } endx - the x-coordinate of the ending point, not less than 0. * @param { number } endy - the y-coordinate of the ending point, not less than 0. * @param { number } [speed] the speed of drag(pixels per second),ranges from 200 to 40000. Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ drag(startx: number, starty: number, endx: number, endy: number, speed?: number): Promise; /** * Capture current screen and save as picture which PNG format. * * @param { string } savePath the path where to store the picture. * @returns { Promise } true if screen-capturing and file-storing are completed successfully,false otherwise. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Capture current screen and save as picture which PNG format. * * @param { string } savePath - the path where to store the picture, must be in the application sandbox directory. * @returns { Promise } true if screen-capturing and file-storing are completed successfully,false otherwise. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ screenCap(savePath: string): Promise; /** * Set the rotation of the device display. * * @param { DisplayRotation } rotation The target rotation to set. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Set the rotation of the device display. * * @param { DisplayRotation } rotation - the target rotation to set. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ setDisplayRotation(rotation: DisplayRotation): Promise; /** * Get the rotation of the device display. * * @returns { Promise } the current display rotation. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the rotation of the device display. * * @returns { Promise } the current display rotation. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getDisplayRotation(): Promise; /** * Enable/disable the rotation of device display. * * @param { boolean } enabled Enable the rotation or not. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Enable/disable the rotation of device display. * * @param { boolean } enabled - enable the rotation or not. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ setDisplayRotationEnabled(enabled: boolean): Promise; /** * Get the size of the device display. * * @returns { Promise } the size of the device display. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the size of the device display. * * @returns { Promise } the size of the device display. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getDisplaySize(): Promise; /** * Get the density of the device display. * * @returns { Promise } the density of the device display. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the density of the device display. * * @returns { Promise } the density of the device display. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getDisplayDensity(): Promise; /** * Wake up the device display. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Wake up the device display. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ wakeUpDisplay(): Promise; /** * Press the home key. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Press the home key. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ pressHome(): Promise; /** * Wait for the UI become idle. * * @param { number } idleTime the threshold of UI idle time, in millisecond. * @param { number } timeout The maximum time to wait for idle, in millisecond. * @returns { Promise } true if wait for idle succeed in the timeout, false otherwise. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Wait for the UI become idle. * * @param { number } idleTime - the threshold of UI idle time, in millisecond, not less than 0. * @param { number } timeout - the maximum time to wait for idle, in millisecond, not less than 0. * @returns { Promise } true if wait for idle succeed in the timeout, false otherwise. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ waitForIdle(idleTime: number, timeout: number): Promise; /** * Inject fling on the device display. * * @param { Point } from The coordinate point where the finger touches the screen. * @param { Point } to The coordinate point where the finger leaves the screen. * @param { number } stepLen the length of each step, in pixels. * @param { number } speed The speed of fling (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Inject fling on the device display. * * @param { Point } from The coordinate point where the finger touches the screen. * @param { Point } to The coordinate point where the finger leaves the screen. * @param { number } stepLen the length of each step, in pixels. * @param { number } speed The speed of fling (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @since 10 * @test */ /** * Inject fling on the device display. * * @param { Point } from - the coordinate point where the finger touches the screen. * @param { Point } to - the coordinate point where the finger leaves the screen. * @param { number } stepLen - the length of each step, in pixels. * @param { number } [speed] - the speed of fling(pixels per second),ranges from 200 to 40000. Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ fling(from: Point, to: Point, stepLen: number, speed: number): Promise; /** * Inject multi-pointer action on the device display. * * @param { PointerMatrix } pointers The two-dimensional array of pointers to inject. * @param { number } speed The speed of swipe (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } true if the operation finished, false * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Inject multi-pointer action on the device display. * * @param { PointerMatrix } pointers - the two-dimensional array of pointers to inject. * @param { number } [speed] - the speed of swipe(pixels per second),ranges from 200 to 40000. Set it default 600 if out of range or null or undefined. * @returns { Promise } true if the operation finished, false * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ injectMultiPointerAction(pointers: PointerMatrix, speed?: number): Promise; /** * Inject fling on the device display. * * @param { UiDirection } direction The direction of this action. * @param { number } speed The speed of fling (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Inject fling on the device display. * * @param { UiDirection } direction - the direction of this action. * @param { number } speed - the speed of fling (pixels per second),default is 600,the value ranges from 200 to 40000,set it 600 if out of range. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ fling(direction: UiDirection, speed: number): Promise; /** * Click on the specified location on the screen with the specified mouse button, and press the specified key simultaneously if necessary. * * @param { Point } p The coordinate of the specified location. * @param { MouseButton } btnId The button of Mouse. * @param { number } key1 the first keyCode. * @param { number } key2 the second keyCode. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Click on the specified location on the screen with the specified mouse button, and press the specified key simultaneously if necessary. * * @param { Point } p - the coordinate of the specified location. * @param { MouseButton } btnId - the button of Mouse. * @param { number } [key1] - the first keyCode,set it default 0 if null or undefined. * @param { number } [key2] - the second keyCode,set it default 0 if null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseClick(p: Point, btnId: MouseButton, key1?: number, key2?: number): Promise; /** * Move the mouse cursor to the specified location. * * @param { Point } p The coordinate of the specified location. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Move the mouse cursor to the specified location. * * @param { Point } p - the coordinate of the specified location. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseMoveTo(p: Point): Promise; /** * The mouse wheel scrolls the specified cell at the specified position, and press the specified key simultaneously if necessary. * * @param { Point } p The coordinate of the specified location. * @param { boolean } down Whether the mouse wheel rolls down. * @param { number } d The number of cells that the mouse wheel scrolls, each cell will make the target point shift 120 pixels. * @param { number } key1 the first keyCode. * @param { number } key2 the second keyCode. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * The mouse wheel scrolls the specified cell at the specified position, and press the specified key simultaneously if necessary. * * @param { Point } p - the coordinate of the specified location. * @param { boolean } down - whether the mouse wheel rolls down. * @param { number } d - the number of cells that the mouse wheel scrolls, each cell will make the target point shift 120 pixels. * @param { number } [key1] - the first keyCode,set it default 0 if null or undefined. * @param { number } [key2] - the second keyCode,set it default 0 if null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseScroll(p: Point, down: boolean, d: number, key1?: number, key2?: number): Promise; /** * The mouse wheel scrolls the specified cell at the specified position, and press the specified key simultaneously if necessary. * * @param { Point } p - the coordinate of the specified location. * @param { boolean } down - whether the mouse wheel rolls down. * @param { number } d - the number of cells that the mouse wheel scrolls, each cell will make the target point shift 120 pixels. * @param { number } [key1] - the first keyCode,set it default 0 if null or undefined. * @param { number } [key2] - the second keyCode,set it default 0 if null or undefined. * @param { number } [speed] - The Speed of mouse wheel rolls(cells per second),ranges from 1 to 500.Set it default 20 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseScroll(p: Point, down: boolean, d: number, key1?: number, key2?: number, speed?: number): Promise; /** * Capture the specified area of current screen and save as picture which PNG format. * * @param { string } savePath the path where to store the picture. * @param { Rect } rect The specified area of current screen, default to full screen. * @returns { Promise } true if screen-capturing and file-storing are completed successfully,false otherwise. * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Capture the specified area of current screen and save as picture which PNG format. * * @param { string } savePath - the path where to store the picture, must be in the application sandbox directory. * @param { Rect } [rect] - the specified area of current screen, default to full screen.Set it default if null or undefined. * @returns { Promise } true if screen-capturing and file-storing are completed successfully,false otherwise. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ screenCapture(savePath: string, rect?: Rect): Promise; /** * Create an {@link UIEventObserver} object. * * @returns { UIEventObserver } the {@link UIEventObserver} object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @since 10 * @test */ /** * Create an {@link UIEventObserver} object. * * @returns { UIEventObserver } the {@link UIEventObserver} object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ createUIEventObserver(): UIEventObserver; /** * Double click on the specified location on the screen with the specified mouse button, and press the specified key simultaneously if necessary. * * @param { Point } p - the coordinate of the specified location. * @param { MouseButton } btnId - the button of Mouse. * @param { number } [key1] - the first keyCode,set it default 0 if null or undefined. * @param { number } [key2] - the second keyCode,set it default 0 if null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseDoubleClick(p: Point, btnId: MouseButton, key1?: number, key2?: number): Promise; /** * Long click on the specified location on the screen with the specified mouse button, and press the specified key simultaneously if necessary. * * @param { Point } p - the coordinate of the specified location. * @param { MouseButton } btnId - the button of Mouse. * @param { number } [key1] - the first keyCode,set it default 0 if null or undefined. * @param { number } [key2] - the second keyCode,set it default 0 if null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseLongClick(p: Point, btnId: MouseButton, key1?: number, key2?: number): Promise; /** * Swipe on the screen between the specified points with mouse. * * @param { Point } from - the starting point. * @param { Point } to - the ending point. * @param { number } [speed] - speed of swipe (pixels per second),the value ranges from 200 to 40000.Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseMoveWithTrack(from: Point, to: Point, speed?: number): Promise; /** * Hold down the left mouse button and drag on the screen between the specified points. * * @param { Point } from - the starting point. * @param { Point } to - the ending point. * @param { number } [speed] - speed of drag (pixels per second),the value ranges from 200 to 40000,Set it default 600 if out of range or null or undefined. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ mouseDrag(from: Point, to: Point, speed?: number): Promise; /** * Inject text on the specified location. * * @param { Point } p - the coordinate of the specified location. * @param { string } text - the text to inject. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ inputText(p: Point, text: string): Promise; } /** * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Represents a window of the ohos application,user can perform operations or query attributes on it. * * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ declare class UiWindow { /** * Get the bundle name of this {@link UiWindow}. * * @returns { Promise } the bundle name. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the bundle name of this {@link UiWindow}. * * @returns { Promise } the bundle name. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getBundleName(): Promise; /** * Get the bounds rect of this {@link UiWindow}. * * @returns { Promise } the bounds rect object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the bounds rect of this {@link UiWindow}. * * @returns { Promise } the bounds rect object. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ getBounds(): Promise; /** * Get the title of this {@link UiWindow}. * * @returns { Promise } the title value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the title of this {@link UiWindow}. * * @returns { Promise } the title value. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getTitle(): Promise; /** * Get the window mode of this {@link UiWindow}. * * @returns { Promise } the {@link WindowMode} object * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the window mode of this {@link UiWindow}. * * @returns { Promise } the {@link WindowMode} object * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ getWindowMode(): Promise; /** * Get the focused status of this {@link UiWindow}. * * @returns { Promise } the focused status * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the focused status of this {@link UiWindow}. * * @returns { Promise } the focused status * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ isFocused(): Promise; /** * Get the active status of this {@link UiWindow}. * * @returns { Promise } the actived status * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Get the active status of this {@link UiWindow}. * * @returns { Promise } the actived status * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 11 * @deprecated since 11 * @useinstead ohos.UiTest.UiWindow#isActive * @test */ isActived(): Promise; /** * Set the focused status of this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Set the focused status of this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ focus(): Promise; /** * Move this {@link UiWindow} to the specified points. * * @param { number } x The x coordinate of destination. * @param { number } y The y coordinate of destination. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Move this {@link UiWindow} to the specified points. * * @param { number } x - the x coordinate of destination, not less than 0. * @param { number } y - the y coordinate of destination, not less than 0. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ moveTo(x: number, y: number): Promise; /** * Resize this {@link UiWindow} to the specified size for the specified direction. * * @param { number } wide The expected wide of the window after resizing. * @param { number } height The expected height of the window after resizing. * @param { ResizeDirection } direction The expected direction of the window after resizing. * @returns { Promise } * @throws { BusinessError } 401 - if the input parameters are invalid. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Resize this {@link UiWindow} to the specified size for the specified direction. * * @param { number } wide - the expected wide of the window after resizing. * @param { number } height - the expected height of the window after resizing. * @param { ResizeDirection } direction - the expected direction of the window after resizing. * @returns { Promise } * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ resize(wide: number, height: number, direction: ResizeDirection): Promise; /** * Change this {@link UiWindow} into split screen mode. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Change this {@link UiWindow} into split screen mode. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ split(): Promise; /** * Maximize this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Maximize this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ maximize(): Promise; /** * Minimize this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Minimize this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ minimize(): Promise; /** * Resume this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Resume this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ resume(): Promise; /** * Close this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Close this {@link UiWindow}. * * @returns { Promise } * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @throws { BusinessError } 17000005 - if the action is not supported on this window. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ close(): Promise; /** * Get the active status of this {@link UiWindow}. * * @returns { Promise } the active status. * @throws { BusinessError } 17000002 - if the async function was not called with await. * @throws { BusinessError } 17000004 - if the window is invisible or destroyed. * @syscap SystemCapability.Test.UiTest * @atomicservice * @since 11 * @test */ isActive(): Promise; } /** * Represents a two-dimensional array of pointers on the device display, it's used to build a * multi-finger trace which can be injected with UiDriver. * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Represents a two-dimensional array of pointers on the device display, it's used to build a * multi-finger trace which can be injected with UiDriver. * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ declare class PointerMatrix { /** * Create an {@link PointerMatrix} object. * * @param { number } fingers The number of fingers. * @param { number } steps The number of steps of each finger trace. * @returns { PointerMatrix } the {@link PointerMatrix} object. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Create an {@link PointerMatrix} object. * * @param { number } fingers - The number of fingers, ranges from 1 to 10. * @param { number } steps - The number of steps of each finger trace, ranges from 1 to 1000. * @returns { PointerMatrix } the {@link PointerMatrix} object. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ static create(fingers: number, steps: number): PointerMatrix; /** * Set the point value of an element in the PointerMatrix. * * @param { number } finger The index of target finger to set. * @param { number } step The index of target step to set. * @param { Point } point The coordinate of target step to set. * @throws { BusinessError } 401 - if the input parameters are invalid. * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * Set the point value of an element in the PointerMatrix. * * @param { number } finger - the index of target finger to set. * @param { number } step - the index of target step to set. * @param { Point } point - the coordinate of target step to set. * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ setPoint(finger: number, step: number, point: Point): void; } /** * The static builder for building {@link By}object conveniently,usage example:BY.text('txt').enabled(true). * * @syscap SystemCapability.Test.UiTest * @since 8 * @deprecated since 9 * @useinstead ohos.uitest.ON * @test */ declare const BY: By; /** * The static builder for building {@link On}object conveniently,usage example:ON.text('txt').enabled(true). * * @syscap SystemCapability.Test.UiTest * @since 9 * @test */ /** * The static builder for building {@link On}object conveniently,usage example:ON.text('txt').enabled(true). * * @syscap SystemCapability.Test.UiTest * @crossplatform * @atomicservice * @since 11 * @test */ declare const ON: On; export { UiComponent, UiDriver, Component, Driver, UiWindow, ON, On, BY, By, MatchPattern, DisplayRotation, ResizeDirection, WindowMode, Point, WindowFilter, Rect, PointerMatrix, UiDirection, MouseButton, UIElementInfo, UIEventObserver };