selenium-webdriver 简单教程

ruby环境下selenium/webdriver可以通过selenium-webdriver.gem包进行安装

gem install selenium-webdriver
 
支持语言及版本有ruby 1.8.7~1.9.2,jrbuy和rubinius
 
selenium-webdriver包含了selenium-client,在阅读的时候,要注意它们两个命名空间是在两不同的API里:
1.Selenium::WebDriver - WebDrver API
2.Selenium::Client - Selenium RC API
 
WebDrver API是继承自Selenium RC API,所以没有必要在Selenium RC API花大量的时间,我们可以直接从Selenium::WebDriver开始,并围绕两个大类:Seleniu::WebDriver:Driver和Selenium::WebDriver::Element,这是整个WebDriver API的入口。
 
API 例子:
一个简单的例子:
require "selenium-webdriver"
 
driver = Selenium::WebDriver.for :firefox
driver.navigate.to "http://www.google.com.hk"
 
element = driver.find_element(:name,'q')
element.send_keys "Hello WebDriver"
element.submit
 
puts driver.title
 
driver.quit
 
Driver 例子:
# 应用javascript
puts driver.execute_script("return window.location.pathname")
 
# 利用ruby和js获取元素
element = driver.execut_script("return document.body")
driver.execut_script("return arguments[0].tagname", element) #=> "BODY"
 
# 等待一些特殊元素的出现
wait = Selenium::WebDriver::Wait.new(:timeout=>10) # seconds
wait.until{driver.find_element(:id,"foo")}
# 注:wait在new时,可以设置三个值,分别为:timeout(默认5秒),:message(默认nil),:interval(默认0.5)
 
# 选择frame
driver.switch_to.frame "some-frame" # name或id
driver.switch_to.frame driver.find_element(:id, 'some-frame') # frame
# 注:switch_to方法不仅可以选择frame,还可以处理window,alert,comfirmation等窗口
 
# 选择回主窗口
driver.swith_to.default_content
 
Element 例子:
# 获取元素属性
class_name = element.attr
 
ibute("class")
# 判断元素是否显示
element.displayed?
 
# 获取元素在页面上的相对坐标位置
element.location
element.location.x
element.location.y
 
# 将元素滚动到视频可以显示的位置,再返回元素的相对坐标
element.location_once_scrolled_into_view
 
# 获取元素的宽和高
element.size
 
# 在元素里输入空,参看Selenium::WebDriver::Keys输入值
element.send_keys :space
element.send_keys "tet", :arrow_left, "s" #=> "test", 先输入 tet, 再输入一次左方向键,再输入s
element.send_keys [:control, 'a'], "1" #=> "1", 先输入crtl+a,再输入1
 
 
# 获取元素文本
element.text
 
 
更高级的用法(见 ActionBuilder)
driver.action.key_down(:shift).click(element).double_click(second_element).key_up(:shift).drag_and_drop(element,third_element).perform
 
 
启动chrome浏览器的方法 
1.下载ChromeDriver并运行,如图
 
2.启动chrome
driver = Selenium::WebDriver.for :remote, :url=>"http://localhost:9515"
driver.get "http://www.google.com.hk"
其它操作一样。
 
如果这样感觉比较麻烦,可以将下载的chromedriver.exe路径加载到环境变量中,就可直接用了
driver = Selenium::WebDriver.for :chrome
 
 
chrome个性化启动
profile = Selenium::WebDriver::Chrome::Profile.new
profile['download.prompt_for_download'] = false
profile['download.default_directory'] = "d:/download"
 
driver = Selenium::WebDriver.for :chrome, :profile=>profile
 
Remote应用
RomteWebDriver可以控制浏览器在不同的机器上运行,下载selenium-server-standlone-x.xx.x.jar
java -jar selenium-server-standalone.jar '启动服务
 
driver = Selenium::WebDriver.for :remote
 
默认情况下,可以启动服务运行在localhost:4444,并打开firefox。如果想连接其它机器上的服务,可以用:url选项
driver = Selenium::WebDriver.for :remote, :url=>"http://remoteserver:44444/wd/hub"
 
本机不用加/wd/hub,但远程一定要加
 
启动其它的浏览器,用:desired_capabilities选项
driver = Selenium::WebDriver.for :remote, :desired_capabilities=>:chrome
 
 
Selenium::WebDriver::Remote::Capabilities的例子
 
require "selenium-webdriver"
include Selenium
 
caps = WebDriver::Remote::Capabilities.htmlunit :javascript_enabled=>true
driver = WebDriver.for :remote, :desired_capalibities=>caps
 
 
 
修改remote服务的端口号,目前只支持firefox
 
include Selenium
 
caps = WebDriver::Remote::Capabilities.firefox (:proxy=>WebDriver::Proxy.new(:http=>"myproxyaddress:8888"))
driver = WebDriver.for :remote, :desired_capalibities=>caps
 
如果是一个远程的remote服务
 
include Selenium
 
client = WebDriver::Remote::Http::Default.new
 
client.proxy = Proxy.new :http=>"proxy.org:8888"
driver = WebDriver.for :remote, :http_client=>client
 
 
Firefox
加扩展插件
在用firefox时,经常要用到firebug进行查看,启动firefox带firebug
include Selenium
 
profile = WebDriver::Firefox::Profile.new
profile.add_extension "path/firebug.xpi"
 
driver = WebDriver.for :firefox, :profile=>profile
 
使用已经存在的profile
使用一个已经存在的profile模板,可以用firefox -profilemanger把profile保存出来(这个命令在ff8上似乎无用,还要进一步验证)
 
driver = Selenium::WebDriver.for :firefox, :profile=>"my_existing_profile"
 
如果想用默认profile,可以通过 :profile=>"default"
 
或者也可以这通过profile实例来使用已经存在的和自定义的profile。此方法不能修改已经存在的profile,且只能在webdriver下使用
 
default_profile = Selenium::WebDriver::Firdfox::Profile.from_name "default"
default_profile.native_events = true
 
driver = Selenium::WebDriver.for :firefox, :profile=>default_profile
 
导出firefox profile见《Firefox 8导出profile文件》
 
Firefox个性化设置
端口号
profile = Selenium::WebDriver::Firefox::Profile.new
profile['browser.download.dir'] = 'd:\download'
profile['browser.download.folderlist'] = 2
profile['browser.helperApps.neverAsk.saveToDisk'] = "application/pdf"
 
driver = Selenium::WebDriver.for :firefox, :profile=>profile
 
用remote driver启动时,任然可以对firefox进行个性化设置
 
profile = Selenium::WebDriver::Firfox::Profile.new
profile['foo.bar'] = true
 
capabilities = Selenium::WebDriver::Remote::Capabilities.firefox :firefox_profile=>profile
driver = Selenium::WebDriver.fox :remote, :desired_capabilities=>capabilities
 
设置Firefox路径
当firfox不是安装在默认路径中时,要设定firefox的安装路径
Selenium::WebDriver::Firefox.path = "/path/to/firefox" # firefox安装路径
driver = Selenium::WebDriver.for :firefox
 
 
本地事件
本地事件在window下默认是激活的,可以设置关闭:
profile = Selenium::WebDriver::Firefox::Profile.new
profile.native_events = false # 关闭
 
driver = Selenium::WebDriver.for :firefox, :profile=>profile
 
理论上linux支持本地事件,profile.native_events = true # 开启
 
 
Opera
opera也是用remote的方法进行启动的。在开始之前,要下载selenium-server-standalone-x.xx.x.jar,并且新建环境变量SELENIUM_SERVER_JAR到本地系统中。
window: SELENIUM_SERVER_JAR=..\server-standalone.jar 
liunx: export SELENIUM_SERVER_JAR=path_to/server-standalone.jar 
 
便可以轻松的用Selenium::WebDriver启动Opera
 
driver = Selenium::WebDriver.for :opera
driver.navigate.to "http://www.baidu.com"
 
Timeouts
 
隐式等待
WebDriver可以设置隐式等待,所以在应用#find_element定位元素时,会等待元素的出现,直至NoSuchElementError的出现。
 
driver = Selenium::WebDriver.for :firefox
driver.manager.timeouts.implicit_wait = 3 # 等待3秒
 
显示等待
可以用wait类去实例化一些等待条件
 
wait = Selenium::WebDriver::Wait.new(:timeout=>3)
wait.until {driver.find_elenium(:id=>"foo").displayed?}
 
 
内部的超时
WebDriver使用了大量的HTTP的驱动(jsonWireProtocol)。Net::HTTP作为ruby的标准库使用,默认超时为60秒。如果用WebDriver#get启动一个加载时间超过60秒的页面,你会看Net::HTTP的TimeoutError错误,可以在启动浏览器之前修改timeout来改变默认超时时长。
 
client = Selenium::WebDriver::Remote::Http::Default.new
client.titmeout = 120 # 设置为120秒
driver = Selenium::WebDriver.for :temote, :http_client=>client
 
js弹出框
获取js的alert,prompt和comfirm弹出窗都是用switch_to
 
 
require "selenium-webdriver"
 
driver = Selenium::WebDriver.for :firefox
driver.navigate.to "http://mysite.com/page_with_alert.html"
 
driver.find_element(:name, 'element_with_alert_javascript').click
a = driver.switch_to.alert
if a.text == 'A value you are looking for'
  a.dismiss
else
  a.accept
end
 
 
用Curb或者自己的http client
HTTP通信内部默认使用Net::HTTP,如果有安装Curb gem就可以选择这么做
 
require "selenium/webdriver/remot/http/curb"
include Selenium
 
client = WebDriver::Remote::Http::Curb.new
driver = WebDriver.for :remote, :http_client=>client