Tài liệu RunMacro
Tạo robot đầu tiên, rồi tiến xa theo nhu cầu.
Hướng dẫn rõ ràng từng bước để tạo, chạy và cải thiện robot cho công việc máy tính lặp lại.
Lệnh thoát vòng lặp ngay lập tức (Break) trong RunMacro
Lệnh Break thoát ngay lập tức khỏi vòng lặp đang chạy (While, For Each, Loop) và chuyển quyền thực thi xuống sau End Loop.
Điều kiện cần#
- Lệnh Break phải nằm bên trong một khối vòng lặp hợp lệ (Loop, While hoặc For Each).
- Thường được bao bọc bởi một khối điều kiện IF để quyết định thời điểm ngắt.
Chế độ hỗ trợ#
- Chế độ Desktop
- Chế độ Browser
- RunMacro Runner
Chức năng này làm gì#
Lệnh Thoát vòng lặp (Break) lập tức kết thúc vòng lặp gần nhất đang chứa nó (áp dụng cho Loop N lần, While, hoặc For Each). Khi gặp lệnh Break, toàn bộ các bước còn lại trong vòng lặp bị bỏ qua và quyền điều khiển kịch bản được chuyển ngay tới dòng lệnh đầu tiên nằm phía sau lệnh End Loop (hoặc End If của vòng lặp cũ). Lệnh này là giải pháp chuẩn mực để ngắt vòng lặp sớm mà không cần nhảy nhãn Goto phức tạp.
Hình ảnh & video#

Khi nào nên dùng#
- Tìm kiếm trong danh sách: khi đã tìm thấy mục tiêu (ảnh, dòng chữ, dữ liệu) thì thoát vòng lặp để tiếp tục bước sau.
- Gặp lỗi nghiêm trọng trong một lượt lặp và cần ngừng toàn bộ tiến trình lặp để bảo vệ an toàn dữ liệu.
- Khi điều kiện dừng khẩn cấp được thỏa mãn trong thân vòng lặp While hoặc For Each.
Khi nào không nên dùng#
- Chỉ muốn bỏ qua lượt lặp hiện tại để sang lượt tiếp theo (hãy dùng lệnh Continue).
- Thoát khỏi macro con quay về macro cha (hãy dùng lệnh Goto File A).
Các bước cấu hình#
- Xác định vị trí kiểm tra điều kiện thoát bên trong thân vòng lặp.
- Đặt lệnh điều kiện (ví dụ: IF hoặc lệnh Tìm kiếm Hình ảnh).
- Bên trong nhánh đúng của điều kiện, thêm lệnh Điều khiển luồng › Thoát vòng lặp (Break).
- Lưu kịch bản. Khi điều kiện thỏa mãn, lệnh Break sẽ đưa luồng chạy ra ngoài vòng lặp.
Giải thích từng tùy chọn#
Kết quả mong đợi#
Vòng lặp dừng ngay lập tức tại vị trí gọi Break và kịch bản chạy tiếp các lệnh phía sau khối vòng lặp.
Ví dụ thực tế#
Ví dụ: Dò tìm file trong danh sách và dừng khi tìm thấy#
- Vòng lặp For Each duyệt từng dòng file.
- Lệnh IF kiểm tra: nếu {item} == "TARGET_ID".
- Bên trong IF: thêm lệnh Thoát vòng lặp (Break).
- Sau End Loop: thông báo đã tìm thấy mục tiêu thành công.
Giới hạn và trường hợp lỗi#
- Lệnh Break chỉ có tác dụng trong phạm vi luồng thực thi cục bộ; không thể ngắt các tiến trình nền độc lập.
- Nếu cấu trúc khối lặp bị lỗi cú pháp thiếu End Loop, runner sẽ không xác định được đích nhảy an toàn.
Mẹo & lỗi thường gặp#
Thông tin kiểm chứng#
commands/control_flow.py
