ui.ui.wait
Declaration
lua
ui.wait(query [, timeout])Description
Chờ phần tử xuất hiện, nghỉ 250 ms giữa các lượt; có kiểm tra dừng. Tự thử lại khi cây đang chuyển màn hình chưa đọc đủ hoặc Accessibility tạm chưa sẵn sàng; lỗi overlay/owner dừng ngay.
Parameters
`query`: chuỗi nhãn hoặc {label, identifier, type, contains, bundle_id, index}. Nhãn mặc định khớp chính xác; index bắt đầu từ 1. `timeout`: giây, mặc định 5, phạm vi 0–60.
Return Values
`table` phần tử; `nil, error` (`timeout` khi hết thời gian).
Example
lua
local el, err = ui.wait({label="Search Facebook", type="button"}, 5)
if not el then sys.log(err) endNotes
Đọc Accessibility, tùy app/màn hình. Cache 150 ms; tối đa 128 phần tử, ngân sách đọc 700 ms. Chặn Quick Launch/hộp thoại, khóa và sai app clone. Không bật VoiceOver; phiên được khôi phục khi script/eval kết thúc.