Handle web dialog — Web Browser Commands

JavaScript 대화상자(alert / confirm / prompt) 처리를 위한 일회성 핸들러를 등록합니다. 카테고리 공통 입력 필드는 Web Browser 명령어 개요 페이지를 참고하세요.

매개변수

Argument	Type	Description
Browser alias	텍스트	브라우저 세션 별칭. 비우면 `default` 사용.
Expected message	텍스트	비교할 대화상자 메시지의 부분 문자열 (선택). 일치하지 않으면 dialog 를 자동 Dismiss 합니다.
Action	옵션	`Accept` (OK/확인) / `Dismiss` (취소).
Prompt response	텍스트	`prompt()` 응답 문자열. `Accept` 시에만 사용됩니다.
Delay	숫자	명령어 실행 후 대기 시간 (Milliseconds)
Description	텍스트	명령어 설명 (선택).

반환값

성공 시 1, 실패 시 0 (핸들러 등록 자체에 대한 결과).

설명

이 명령은 dialog 가 뜬 뒤 처리하는 것이 아니라, "다음에 dialog 가 뜨면 어떻게 처리할지" 를 미리 등록(pre-arm) 하고 즉시 반환합니다. 핸들러는 일회성(one-shot) 으로, 첫 dialog 한 번을 처리한 후 자동 해제됩니다.

이 명령은 dialog 를 트리거할 명령(Click web element 등) 보다 반드시 먼저 호출해야 합니다. dialog 가 이미 뜬 뒤에 등록하면 처리되지 않습니다.

매칭 규칙

Expected message 가 비어있으면 모든 dialog 와 매칭됩니다.
값이 있으면 dialog 본문에 해당 문자열이 포함될 때만 매칭됩니다 (대소문자 무시).
매칭에 실패하면 Action 과 무관하게 자동으로 Dismiss 됩니다 — 의도와 다른 dialog 가 먼저 떠도 흘려보내는 안전 기본값입니다.

Dialog 종류별 Accept / Dismiss 동작

Dialog 종류	Accept (확인)	Dismiss (취소)
alert	OK 클릭 (단순히 닫힘)	OK 클릭 (alert 는 취소 버튼 없음)
confirm	OK → JS `true` 반환	Cancel → JS `false` 반환
prompt	OK + Prompt response 입력값 반환	Cancel → `null` 반환

사용 예시

confirm 다이얼로그를 자동으로 OK 처리

1. Handle web dialog  : Action=Accept, Expected message=''
2. Click web element  : Target='삭제'    // 이 클릭이 confirm 을 띄움
3. Wait for web element : Target='삭제되었습니다'

prompt 다이얼로그에 응답 입력

1. Handle web dialog  : Action=Accept, Prompt response='2026-05-13', Expected message='날짜'
2. Click web element  : Target='날짜 설정'