# wait(for:toEqual:timeout:) Waits a specified amount of time for a property value to equal a specified value. ``` @MainActor @preconcurrency func wait(for keyPath: KeyPath, toEqual expectedValue: V, timeout: TimeInterval) -> Bool where V : Equatable ``` ## Parameters `keyPath` The observed property on an [`XCUIElement`](/documentation/XCUIAutomation/XCUIElement). `expectedValue` The desired value, which must conform to `Equatable`. `timeout` The length of time in seconds to wait for the observed property to equal the expected value. ## Discussion This method returns if the timeout expires before the observed property equals the expected value. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)