等待視窗標題(正則)

wait_for_window 以*子字串*比對視窗標題且僅等待其*出現*;``wait_until_window_closed`` 為子字串消失。兩者都 不支援正則表達式標題或「等到使用中視窗標題符合 P」——例如等待瀏覽器分頁導覽至 r".*— Checkout$"。本功能 為 smart_waits 家族加入正則標題等待。

標題來源可注入,因此迴圈可在無真實視窗下做無頭測試。不匯入 PySide6。

無頭 API

from je_auto_control import wait_until_window_title

wait_until_window_title(r".*— Checkout$", timeout_s=20)   # 分頁已導覽
wait_until_window_title("Updating", present=False)         # 對話框消失
wait_until_window_title("Checkout", regex=False)           # 子字串模式

預設 pattern 為正則表達式(re.search);傳入 regex=False 改用純子字串比對。present=False 等待 標題*消失*。結果為 WaitOutcome``(``succeeded / reason / elapsed_s / samples_taken); title_lister 可注入以供測試。

執行器命令

AC_wait_window_title 接受 pattern 以及 present / regex / timeout_s / poll_interval_s, 並回傳 WaitOutcome dict。它以 MCP 工具 ac_wait_window_title 以及 Script Builder 中 Flow 分類下的命令 提供。