Wait for web element
페이지의 요소 또는 URL이 지정한 상태가 될 때까지 대기합니다. 자동화 안정성의 핵심 명령어입니다.
페이지의 요소 또는 URL 이 지정한 상태가 될 때까지 대기합니다. 자동화 안정성의 핵심 명령어입니다. 카테고리 공통 입력 필드는 Web Browser 명령어 개요 페이지를 참고하세요.
매개변수
| Argument | Type | Description |
|---|---|---|
| Browser alias | 텍스트 | 브라우저 세션 별칭. 비우면 default 사용. |
| Target | 텍스트 | 기다릴 대상. Match type 에 따라 CSS 셀렉터 / 보이는 텍스트 / URL 패턴(glob 가능). |
| Match type | 옵션 | URL / Text / Selector. URL 은 페이지 이동 완료를 기다리고, Text·Selector 는 element 의 상태를 기다림. |
| State | 옵션 | Visible / Hidden / Attached. URL 모드에서는 무시됨. Visible 이 기본. |
| Timeout (ms) | 숫자 | 최대 대기 시간 (millisecond). 비우면 글로벌 기본값(5000)을 사용. |
| Delay | 숫자 | 명령어 실행 후 대기 시간 (Milliseconds) |
| Description | 텍스트 | 명령어 설명 (선택). |
반환값
반환값
성공 시 1, 시간 초과 시 0.
설명
Match type=URL 인 경우 Target 에 **/dashboard** 같은 glob 패턴을 사용할 수 있습니다.
State 의 의미
Visible— DOM 에 존재하고 화면에 보이는 상태. 기본값.Hidden— DOM 에 없거나display:none/visibility:hidden으로 숨겨진 상태. "로딩 스피너가 사라질 때까지" 등에 사용.Attached— DOM 에 부착되었는지만 확인하며 가시성은 검사하지 않음.
페이지 이동·전환 직후에는 항상 이 명령으로 안정화 대기를 거는 것이 가장 안전한 자동화 습관입니다. 빠른 후속 명령이 DOM 준비 전 실행되어 실패하는 경우를 막아줍니다.
사용 예시
자주 쓰는 패턴
URL 도달 대기 : Match type=URL, Target='**/dashboard**'
요소 표시 대기 : Match type=Selector, Target='#main-content', State=Visible
로딩 스피너 사라짐 대기 : Match type=Selector, Target='.spinner', State=Hidden
텍스트 등장 대기 : Match type=Text, Target='저장되었습니다', State=Visible