Commands
focus-application
Bring a specific application window to the foreground.
Description
The focus-application command brings a specific application window to the foreground. This ensures that subsequent commands interact with the correct application during a test.
Arguments
| Argument | Type | Description |
|---|---|---|
name | string | The name of the application to focus. This should match the application’s display name. |
Example usage
Protips
- Ensure the application name matches the exact name displayed in your operating system’s task manager or application switcher.
- Use this command at the start of a test or before interacting with an application to avoid focus-related issues.
Gotchas
- If the specified application isn’t running, the command will fail. Ensure the application is open before using this command.
- On macOS, the application name is case-sensitive.
Notes
- The
focus-applicationcommand is useful for multi-application workflows where you need to switch between different apps during a test. - Supported on both Windows and macOS environments.