Web Browser Commands — Aurora Script Commands

Web Browser 명령어는 Playwright 엔진을 통해 웹 브라우저를 자동화합니다. 브라우저를 열고 닫고, 페이지를 이동하고, 요소를 클릭하거나 텍스트를 입력·추출하며, JavaScript 실행과 JS 대화상자(alert/confirm/prompt) 처리까지 지원합니다. 각 명령은 브라우저 별칭(Alias) 으로 여러 세션을 구분할 수 있고, 기본 엔진은 시스템 Microsoft Edge이며 Chrome 으로 변경할 수 있습니다.

더 쉬운 방법 — Web Page Script Maker. 웹 페이지를 한 번 스캔하면 입력·선택·클릭 대상이 @Web 명령으로 자동 변환됩니다. 셀렉터와 Match type을 직접 작성하기 전에 👉 Web Page Script Maker로 스크립트 자동 생성하기를 먼저 확인해 보세요.

이 페이지는 Web Browser 카테고리의 모든 명령어가 공통으로 사용하는 입력 필드와 옵션을 정리한 것입니다. 각 명령어의 세부 표는 개별 페이지를 참조하세요.

공통 입력 항목

명령어를 선택하면 입력 항목이 자동으로 표시/숨김 처리됩니다. 모든 명령어는 아래 항목 중 일부를 공유합니다.

필드	설명
Alias	브라우저 세션 이름. 여러 브라우저를 동시에 다룰 때 구분용. 비우면 `default` 사용. 같은 Alias 로 후속 명령을 호출하면 같은 페이지를 이어서 사용합니다.
Target	명령의 대상. Match type 에 따라 셀렉터/텍스트/URL 패턴/role/label 로 해석됩니다. `[변수명]` 형식으로 Aurora 변수를 삽입할 수 있고, 옆의 `[x]` 버튼으로 변수 목록에서 선택할 수 있습니다.
`[...]` 버튼	Element picker. 디자인 타임에 누르면 브라우저에서 원하는 요소를 직접 클릭해 Target 값을 자동으로 채워줍니다. 브라우저가 떠 있지 않으면 빈 Edge 창이 자동으로 열립니다. 아래 Element picker 절 참고.
Match type	Target 을 해석하는 방식. 명령어마다 노출되는 후보가 다릅니다. 아래 Match type 절 참고.
Option 1 / 2	명령어별 부가 옵션 (State, Click type, Mode, Action 등). 각 명령어 페이지에서 상세 설명을 확인하세요.
Value	명령어별 부가 값 (Text 입력값 / 속성명 / 인덱스 / 타임아웃 등). 라벨이 명령어별로 달라집니다.
Delay	명령어 실행 후 대기 시간 (Milliseconds)
Description	명령어 설명 (선택). 스크립트 가독성을 위해 적어두면 좋습니다.

Target 작성 가이드

Target 은 선택한 Match type 의 값에 따라 다르게 해석됩니다.

Match type	Target 작성 예시
URL	이동 후 도달할 URL 패턴 — `Wait for web element` 에서만 사용. glob 가능: `/dashboard`, `https://www.google.com/search?q=*` 등. State 입력은 무시됩니다.
Text	보이는 텍스트의 부분 일치 (대소문자 무시). 예: `로그인`, `확인`. 정확 일치가 필요하면 Selector 모드로 `text="로그인"` 형식 사용.
Selector	CSS 셀렉터. 예: `#login-btn`, `.search-input`, `form > button`. XPath 도 `xpath=//button[contains(text(),"확인")]` 형태로 사용 가능.
Role	ARIA role 이름. `button`, `link`, `textbox`, `checkbox` 등. 이름(name)도 함께 지정하려면 `role
Label	`<label>` 텍스트로 연결된 폼 요소(input/select/textarea) 찾기. 예: `이메일`, `비밀번호`. 폼 자동화에서 가장 안정적인 방법입니다.

CSS attribute selector [name="q"] 의 대괄호는 Aurora 가 변수로 인식하려고 하므로 id / class / text= / nth-of-type 사용을 권장합니다.

Element picker (`[...]` 버튼)

Target 옆의 [...] 버튼을 누르면 브라우저에서 element picker 가 활성화되어, 원하는 요소를 직접 클릭해서 Target 값을 자동으로 채워줍니다.

동작 흐름

버튼 클릭 → 해당 Alias 의 브라우저가 떠 있지 않으면 빈 Edge 창이 자동으로 열립니다 (Visible 모드, about:blank).
브라우저에서 원하는 페이지로 직접 이동(주소 입력 또는 링크 클릭)한 뒤, 마우스를 움직이면 빨간 외곽선으로 element 가 강조됩니다.
원하는 element 를 클릭하면 결과가 산출됩니다.
취소 — Esc 키를 누르거나 빈 영역을 클릭하면 취소되고 Target 값은 변하지 않습니다.
완료 — Aurora 다이얼로그가 자동으로 앞으로 나타나고, Target 필드에 결과가 채워지며 커서가 Target 필드에 위치합니다.

Match type 별로 반환되는 값

선택된 Match type	Picker 가 반환하는 값
URL	Element 클릭 없이 즉시 현재 페이지의 URL 을 반환 (예: `https://www.google.com/`). `about:blank` 상태라면 안내 메시지가 표시되니, 먼저 원하는 페이지로 이동한 뒤 다시 `[...]` 를 눌러주세요.
Text	클릭한 element 의 가시 텍스트 (innerText, 200자까지). 예: `로그인`, `Google 검색`.
Selector	우선순위에 따른 짧은 CSS 셀렉터를 자동 산출 — (1) 안전한 id 가 있고 유일하면 `#id`, (2) 텍스트 element 면 `text="..."`, (3) 클래스 조합으로 유일하면 `.class1.class2`, (4) 모두 실패하면 `div.foo:nth-of-type(2) > a.bar` 같은 체인.
Label	폼 요소면 `<label for=...>` 텍스트 → 부모 `<label>` 텍스트 → `aria-label` → `placeholder` 순으로 시도. label 요소 자체는 자신의 innerText.
Role	`role

Match type 명령어별 지원

각 명령어가 노출하는 Match type 후보는 다릅니다.

명령어	지원 Match type
Wait for web element	URL / Text / Selector
Click web element	Text / Selector / Role / Label
Set text on web element	Selector / Label
Get text from web element	Selector / Text

주요 옵션 값의 의미

명령어마다 노출되는 옵션이 다릅니다. 자주 사용되는 옵션의 의미는 다음과 같습니다.

옵션	값과 의미
State (Wait)	`Visible` — DOM 에 있고 보이는 상태 (기본). / `Hidden` — DOM 에 없거나 숨겨진 상태 ("로딩 스피너가 사라질 때까지" 등). / `Attached` — DOM 에 부착만 되어 있어도 통과.
Click type (Click)	`Left click` (좌클릭) / `Right click` (우클릭) / `Double click` (더블 클릭).
Mode (Set text)	`Replace + Enter` — 비우고 입력 후 Enter (검색창). / `Replace only` — 비우고 입력만. / `Append + Enter` — 이어 입력 후 Enter. / `Append` — 이어 입력만.
Engine (Open)	`Edge` — 시스템 Microsoft Edge (기본, 추가 설치 불필요). / `Chrome` — 시스템 Google Chrome.
Mode (Open)	`Visible` — 창을 화면에 표시. / `Headless` — 창 없이 백그라운드 실행 (배치 작업용).
Action (Navigate)	`Goto` — 지정 URL 로 이동. / `Reload` — 새로고침. / `Back` — 뒤로. / `Forward` — 앞으로.
Wait until (Navigate)	`load` — load 이벤트까지. / `domcontentloaded` — DOMContentLoaded 까지 (빠름). / `networkidle` — 네트워크 잠잠해질 때까지 (SPA 에 적합).
Select by (Select item)	`By name` — `<option>` 의 보이는 텍스트로. / `By index` — 0 부터 시작하는 정수 인덱스.
Action (Handle dialog)	`Accept` — OK/확인. / `Dismiss` — 취소.

권장 자동화 패턴

페이지 이동 후 안정화 대기. 페이지가 바뀐 직후에는 반드시 Wait for web element 로 안정화 대기를 거치세요. 빠른 후속 명령이 DOM 준비 전 실행되어 실패하는 경우를 막아줍니다.

Click 후 화면 전환 — 곧바로 Wait for web element 또는 Navigate(Wait until) 로 안정화.
JS 대화상자 처리 — Handle web dialog 는 dialog 가 발생하기 전에 미리 등록해야 합니다. 예: Handle web dialog (Accept) 등록 → 그 다음 Click (이 클릭이 confirm 을 띄움) 순서.
여러 세션 — 동시에 여러 브라우저를 다룰 때는 Alias 를 구분하세요 (예: main, admin).
결과 받기 — Get text from web element 와 Run web script 의 결과는 측정 값(measurement) 에 저장되어, 이후 [측정값변수] 형식으로 다른 명령어에서 참조 가능합니다.

명령어 목록

이 카테고리에 속한 명령어 전체 목록은 사이드바에서 확인할 수 있습니다.