HOWTO · Python
Selenium Python의 액션 체인
이 튜토리얼에서는 Selenium with Python의 액션 체인에 대해 설명합니다.
이 페이지의 내용
Selenium은 자동화에 활용되는 독립형 웹 기반 도구입니다. 누구나 사용할 수 있는 오픈 소스 도구입니다.
Python 언어와 함께 사용하면 이 도구는 테스트에 활용됩니다. 액션 체인은 Selenium의 기본 구성 요소이며 키 입력, 마우스 이동, 마우스 버튼 동작, 컨텍스트 메뉴와의 상호 작용 같은 저수준 상호 작용을 관리하는 방법을 제공합니다.
이 튜토리얼에서는 Python으로 Selenium에서 액션 체인을 구현하는 방법을 보여 줍니다.
요소를 클릭하거나 드래그해야 하는 고급 스크립트를 자동화해야 할 때 주로 액션 체인을 사용합니다.
Python에서는 ActionChains 클래스가 액션 체인을 구현합니다. ActionChains 객체는 모든 동작을 큐에 저장하며, perform() 메서드를 호출해 저장된 작업을 실행하기 전까지는 아무 동작도 브라우저에 전달되지 않습니다.
Selenium Python에서 ActionChains 객체 생성
ActionChains 객체는 필요한 모듈을 가져오고 Python 코드에서 몇 가지 값을 전달하여 만들 수 있습니다. 실행하기 전에 selenium 패키지와 Firefox용 geckodriver 같은 해당 브라우저 드라이버가 설치되어 있는지 확인하세요.
다음 코드는 간단한 ActionChains 객체를 생성합니다. 가져오기 가드는 실패하는 대신 selenium 패키지가 없음을 알려 주므로 스크립트는 항상 정상적으로 종료됩니다. 완전히 설정된 머신에서는 else 블록이 실행되어 객체를 생성합니다. 출력 예제의 설치 안내 문구는 원문과 동일하게 영어로 유지됩니다.
try:
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
except ModuleNotFoundError:
print("selenium is not installed; install it with: pip install selenium")
else:
driver = webdriver.Firefox()
action = ActionChains(driver)
driver.quit()
selenium is not installed; install it with: pip install selenium
ActionChains클래스는try블록 안에서selenium.webdriver.common.action_chains모듈에서 가져옵니다. 패키지가 없으면ModuleNotFoundError분기가 위에 표시된 설치 안내를 출력합니다.- 그런 다음 Firefox를 시작해
driver를 정의합니다. - 이
driver가ActionChains생성자의 핵심 인수로 전달됩니다. ActionChains객체가 생성되어 실행 가능한 모든 작업을 저장할 준비가 됩니다.
새로 만든 ActionChains 객체에는 아직 큐에 저장된 동작이 없습니다. click이나 move_to_element 같은 메서드 호출은 해당 큐에 동작을 추가할 뿐이며, perform()이 순서대로 실행하기 전까지 브라우저는 반응하지 않습니다. 이 저장 후 실행 패턴은 몇 줄의 순수 Python 코드로 쉽게 확인할 수 있습니다.
다음 예제를 실행해 보세요.
queue = []
def move_to_element(target):
queue.append("move to " + target)
def click(target):
queue.append("click " + target)
def perform():
for step in queue:
print(step)
move_to_element("profile menu")
click("TUTORIALS link")
perform()
move to profile menu
click TUTORIALS link
두 호출 모두 먼저 저장된 다음 perform()에 의해 함께 재생되며, 이는 ActionChains 큐의 작동 방식과 정확히 일치합니다.
Selenium Python에서 액션 체인 구현
이를 더 쉽게 설명하기 위해 https://www.delftstack.com/ 웹사이트를 예로 들어 Python 코드에서 몇 가지 실험을 해 보겠습니다.
아래 예제 코드는 먼저 https://www.delftstack.com/을 연 다음 헤더의 TUTORIALS 링크를 클릭하여 브라우저가 스스로 https://www.delftstack.com/tutorial/로 이동하도록 합니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
try:
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By
except ModuleNotFoundError:
print("selenium is not installed; install it with: pip install selenium")
else:
driver = webdriver.Firefox()
driver.get("https://www.delftstack.com/")
clicker1 = driver.find_element(By.LINK_TEXT, "TUTORIALS")
action = ActionChains(driver)
action.click(on_element=clicker1)
action.perform()
driver.quit()
selenium is not installed; install it with: pip install selenium
완전히 설정된 머신에서 스크립트는 먼저 웹사이트 홈 페이지 https://www.delftstack.com/을 엽니다.
그런 다음 위 코드에서 큐에 저장된 클릭의 결과로 https://www.delftstack.com/tutorial/ 웹페이지로 자동으로 이동합니다.
- 요소를 찾기 위해
selenium.webdriver.common.by의By와 함께ActionChains클래스를selenium.webdriver.common.action_chains모듈에서 가져옵니다. - 그런 다음
driver를 정의하고get()이 웹사이트https://www.delftstack.com/을 로드합니다. - 그런 다음
driver.find_element(By.LINK_TEXT, "TUTORIALS")로 웹사이트 헤더의TUTORIALS링크인clicker1요소를 찾습니다. 이전find_element_by_link_text호출은 Selenium 4에서 제거되었으므로By.LINK_TEXT형식을 사용해야 합니다. - 이
driver가ActionChains생성자의 핵심 인수로 전달됩니다. - 그런 다음
action.click()을 호출하고 이전에 정의한clicker1요소를on_element인수로 전달합니다. 이는 클릭을 큐에 넣을 뿐이며 브라우저는 아직 아무것도 클릭하지 않았습니다. - 그런 다음
perform()을 호출하여 큐에 저장된 클릭을 실행하므로 실제 탐색이 수행됩니다.
이 예제는 실제 브라우저를 구동하므로 브라우저와 해당 드라이버가 설치된 머신에서 실행해야 합니다. 그런 머신에서는 else 블록이 콘솔 출력을 생성하지 않으며, 눈에 보이는 결과는 위 스크린샷에 표시된 탐색입니다. selenium 패키지가 없는 머신에서는 스크립트가 출력 블록에 표시된 설치 안내를 출력합니다. 출력 블록의 안내 문구는 원문 예제와 동일하게 영어로 유지됩니다.
하나의 시퀀스에서 여러 동작 연결
하나의 ActionChains 객체는 perform()을 한 번 호출하기 전에 여러 동작을 큐에 저장할 수 있습니다. 이것이 이 클래스가 기반으로 하는 큐 패턴입니다. 모든 메서드는 동일한 시퀀스에 추가되고 perform()은 이를 순서대로 재생합니다. 일반적인 사용 사례는 메뉴 위에 마우스를 올려 하위 메뉴를 표시한 다음 그 안의 항목을 클릭하는 것입니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
try:
from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By
except ModuleNotFoundError:
print("selenium is not installed; install it with: pip install selenium")
else:
driver = webdriver.Firefox()
driver.get("https://www.delftstack.com/")
menu = driver.find_element(By.LINK_TEXT, "TUTORIALS")
action = ActionChains(driver)
action.move_to_element(menu)
action.pause(1)
action.click(menu)
action.perform()
driver.quit()
selenium is not installed; install it with: pip install selenium
여기서 move_to_element는 마우스를 링크 위에 놓고, pause는 페이지가 반응할 수 있도록 1초 동안 기다리며, click은 링크를 클릭합니다. 이 모든 동작은 마지막의 단일 perform()에 의해 실행됩니다. 이 메서드들은 각각 동일한 ActionChains 객체를 반환하므로 동일한 시퀀스를 action.move_to_element(menu).pause(1).click(menu).perform()처럼 유창한 방식으로 작성할 수도 있습니다.
release와 click_and_hold는 누르기를 두 단계로 나누기 때문에 일반 click으로 표현할 수 없는 드래그 방식 상호 작용을 위한 긴 시퀀스 안에서 유용합니다.
ActionChains 메서드 참조
Selenium에서 액션 체인을 구현하는 것만으로는 충분하지 않습니다. ActionChains 객체를 만든 후 사용할 수 있는 ActionChains 메서드도 알아야 합니다. 아래에 몇 가지 중요한 메서드를 설명했습니다.
click- 요소를 클릭하는 메서드입니다.click_and_hold- 지정된 요소에서 마우스 왼쪽 버튼을 누른 상태로 유지하는 메서드입니다.double_click- 요소를 더블클릭하는 메서드입니다.drag_and_drop- 요소에서 마우스 왼쪽 버튼을 누른 채 대상 위치로 드래그한 다음 놓는 메서드입니다.move_to_element- 마우스를 요소의 중앙으로 이동하는 메서드입니다.perform-ActionChains객체에 저장된 모든 동작을 실행하는 메서드입니다.pause- 모든 입력을 지정된 시간(초) 동안 일시 중지하는 메서드입니다.release- 마우스 버튼이 눌린 상태이면 이를 해제하는 메서드입니다.