google/EarlGrey
EarlGrey
EarlGrey is an iOS UI automation test framework that enables writing and running automated tests simulating real user interactions. It provides a synchronized test execution engine that automatically waits for animations, network requests, and run-loop states to complete before performing test actions or assertions, producing stable and repeatable results across test runs.
The framework distinguishes itself through out-of-process interaction handling, managing system alerts and app switching during tests, and a pixel-level visibility checker that verifies UI elements are actually visible and interactable by comparing screenshots for pixel-level differences rather than just checking hierarchy presence. It also includes a remote method invocation bridge that allows test code to access application objects and state directly, and a screenshot-based element matching capability that identifies UI elements by capturing and comparing pixel data.
EarlGrey supports running tests from the terminal using standard build tools like xcodebuild, and provides capabilities for simulating taps and swipes through app-level touch events after confirming element visibility. The framework can be integrated with the standard iOS test runner for command-line execution.
Features
- iOS UI Automation Tests - Provides a complete iOS UI automation test framework with synchronization, visibility checks, and system alert handling.
- App Internal Queries - Accesses application objects and state directly from test code using remote method invocation.
- Visibility Checkers - Verifies UI element visibility by comparing screenshots for pixel-level differences before interaction.
- Visibility Verifications - Implements pixel-level screenshot comparison to verify UI element visibility before interaction.
- Test-to-App Bridges - Provides a remote method invocation bridge for test code to access application objects and state directly.
- Test Process Interaction Brokers - Manages system alerts and app switching during automated iOS UI tests from an external process.
- Pixel-Level Visibility Matchers - Checks element visibility using pixel-level analysis rather than just hierarchy presence.
- Pixel-Level Visibility Verifications - Verifies UI element visibility by comparing screenshots for pixel-level differences before performing actions.
- System Alert Handlers - Provides out-of-process system alert interception and dismissal during iOS UI test execution.
- App Idle Synchronizations - Waits for animations, network requests, and queues to finish before each test action for stable results.
- iOS UI Automation Frameworks - Ships a complete iOS UI automation test framework with synchronization, visibility checks, and system alert handling.
- User Interaction Simulation - Simulates realistic taps and swipes via app-level touch events after confirming element visibility.
- UI Stability Waits - Waits for animations, network requests, and queues to finish before each interaction for consistent results.
- System UI Cross-App Interactions - Performs out-of-process actions like handling system alerts and switching between apps during tests.
- Synchronization Engines - Automatically waits for animations, network requests, and queues before performing test actions.
- Test Idling Resources - Monitors animation, network, and run-loop states to defer test actions until the application becomes idle.
- Remote App State Queries - Provides an interface to access application objects and state from test code using remote method invocation.
- App Idle Waiters - Waits for the app to become idle before performing actions or assertions by tracking UI, network, and animation states.
- Out-of-Process Touch Simulations - Ships out-of-process touch injection that simulates taps and swipes from the test runner process.
- Screenshot-Based Element Matchers - Identifies UI elements by capturing and comparing pixel data instead of relying on accessibility identifiers.
- Testing and Automation - iOS UI automation test framework by Google.
- Testing Frameworks - iOS UI automation framework.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
