appium-android-driver
Version:
Android UiAutomator and Chrome support for Appium
26 lines • 1.23 kB
TypeScript
/**
* Executes a shell command on the device via ADB.
*
* This method runs an arbitrary shell command on the Android device and returns
* the output. The command is executed using `adb shell` with the specified
* command and arguments.
*
* Requirements:
* - The adb_shell feature must be enabled
*
* @param command The shell command to execute (e.g., 'pm', 'dumpsys', 'getprop').
* @param args Optional array of command arguments.
* @param timeout The maximum time in milliseconds to wait for command execution.
* Defaults to 20000ms (20 seconds).
* @param includeStderr If `true`, returns both stdout and stderr in an object.
* If `false` or undefined, returns only stdout as a string.
* @returns If `includeStderr` is `true`, returns `{ stdout: string, stderr: string }`.
* Otherwise, returns the command output as a string.
* @throws {errors.InvalidArgumentError} If `command` is not a string.
* @throws {Error} If the command execution fails or times out.
*/
export declare function mobileShell<T extends boolean>(command: string, args?: string[], timeout?: number, includeStderr?: T): Promise<T extends true ? {
stdout: string;
stderr: string;
} : string>;
//# sourceMappingURL=shell.d.ts.map