Selenium + Python

Selenium 1 (Selenium RC)

How Selenium RC Works

First, we will describe how the components of Selenium RC operate and the role each plays in running your test scripts.

RC Components

Selenium RC components are:

• The Selenium Server which launches and kills browsers, interprets and runs the Selenese commands passed from the test program, and acts as an HTTP proxy, intercepting and verifying HTTP messages passed between the browser and the AUT.
• Client libraries which provide the interface between each programming language and the Selenium RC Server.

Here is a simplified architecture diagram....

The diagram shows the client libraries communicate with the Server passing each Selenium command for execution. Then the server passes the Selenium command to the browser using Selenium-Core JavaScript commands. The browser, using its JavaScript interpreter, executes the Selenium command. This runs the Selenese action or verification you specified in your test script.

Selenium Server

Selenium Server receives Selenium commands from your test program, interprets them, and reports back to your program the results of running those tests.
The RC server bundles Selenium Core and automatically injects it into the browser. This occurs when your test program opens the browser (using a client library API function). Selenium-Core is a JavaScript program, actually a set of JavaScript functions which interprets and executes Selenese commands using the browser’s built-in JavaScript interpreter.
The Server receives the Selenese commands from your test program using simple HTTP GET/POST requests. This means you can use any programming language that can send HTTP requests to automate Selenium tests on the browser.

Client Libraries

The client libraries provide the programming support that allows you to run Selenium commands from a program of your own design. There is a different client library for each supported language.

Installation

Installation is rather a misnomer for Selenium. Selenium has a set of libraries available in the programming language of your choice.
Once you’ve chosen a language to work with, you simply need to:

• Install the Selenium RC Server.
• Set up a programming project using a language specific client driver.

Using the Python Client Driver

• Install Selenium via PIP, instructions linked at SeleniumHQ downloads page
• Either write your Selenium test in Python or export a script from Selenium-IDE to a python file.
• Run Selenium server from the console
• Execute your test from a console or your Python IDE

For details on Python client driver configuration, see the appendix Python Client Driver Configuration.

Selenium IDE 的使用

http://www.tad0616.net/modules/tad_book3/page.php?tbdsn=827



Selenium API 中文手册refer from : http://www.tad0616.net/modules/tad_book3/page.php?tbdsn=826

Commands (命令)

• Action
  對目前狀態進行操作，失敗時，停止測試
• Assertion
  檢驗是否有產生正確的值
• Element Locators
  指定HTML中的某元素
• Patterns
  用於模式匹配

1. Element Locators (元素定位器)

• id=id
  id locator 指定HTML中的唯一id的元素
• name=name
  name locator指定 HTML中相同name的元素中的第一個元素
• identifier=id
  identifier locator 首先查找HTML是否存在該id的元素, 若不存在，查找第一個該name的元素
• dom=javascriptExpression
  dom locator用JavaScript表達式來定位HTML中的元素,注意必須以"document"開頭
  例如:
  dom=document.forms['myForm'].myDropdown
  dom=document.images[56]
• xpath=xpathExpression
  xpath locator用 XPath 表達式來定位HTML中的元素,注意必須以"//"開頭
  例如：
  xpath=//img[@alt='The image alt text']
  xpath=//table[@id='table1']//tr[4]/td[2]
• link=textPattern
  link locator 用link來選擇HTML中的連接或元素
  例如:
  link=The link text
• 在没有locator前序的情况下 Without a locator prefix, Selenium uses:
  如果以"document."開頭，則預設是使用 dom locator，如果是以"//"開頭，則預設使用xpath locator,其它情況下預設以 identifier locator

2. String Matching Patterns (字符串匹配模式)

• glob:patthern
  glob模式，用萬用字元"*"代表任意長度的字元符號，"?"代表一個字元符號
• regexp:regexp
  正規表達試模式，用JavaScript 正規表達式的現式來匹配字元符號字串
• exact:string
  精確匹配模式，精確匹配整個字元符號字串，不能使用萬用字元
• 在沒有指定字元符號字串匹配前序的時候，selenium預設使字golb匹配模式

3. Select Option Specifiers (Select選項指定器)

• label=labelPattern
  透過匹配選項中的本文指定選項
  例如：label=regexp:^[Oo]ther
• value=valuePattern
  透過匹配選項中的值指定選項
  例如：value=other
• id=id
  透過匹配選項的id指定選項
  例如: id=option1
• index=index
  透過匹配選項的序號指定選項，序號從0開始
  例如：index=2
• 在沒有選項可選擇的前提的情況下，預設是匹配選項的本文

Actions

描述了字戶所會做出的操作。
Action 有兩種形式: action和actionAndWait, action會立即執行，而actionAndWait会假设需要较长时间才能得到该action的回應，而作出等待，open則是會自動處理等待時間。

• click
  click(elementLocator)
  - 點擊連結,按钮，复选和单选框
  - 如果點擊後需要等待回應，则用"clickAndWait"
  - 如果是需要经過JavaScript的alert或confirm对话框后才能继续操作，则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。

  click	aCheckbox
  clickAndWait	submitButton
  clickAndWait	anyLink

• open
  open(url)
  - 在浏览器中打开URL,可以接受相对和绝对路径两种形式
  - 注意：该URL必须在与浏览器相同的安全限定范围之内

  open	/mypage
  open	http://localhost/

• type
  type(inputLocator, value)
  - 模拟人手的输入过程，往指定的input中输入值
  - 也适合给复选和单选框赋值
  - 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本

  type	nameField	John Smith
  typeAndWait	textBoxThatSubmitsOnChange	newValue

• select
  select(dropDownLocator, optionSpecifier)
  - 根据optionSpecifier选项选择器来选择一个下拉菜单选项
  - 如果有多于一个选择器的时候，如在用通配符模式，如"f*b*",或者超过一个选项有相同的文本或值，则会选择第一个匹配到的值

  select	dropDown	Australian Dollars
  select	dropDown	index=0
  selectAndWait	currencySelector	value=AUD
  selectAndWait	currencySelector	label=Auslian D*rs

•  goBack,close
  goBack()
  模拟点击浏览器的后退按钮
  close()
  模拟点击浏览器关闭按钮
• selectWindow
  select(windowId)
  - 选择一个弹出窗口
  - 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行

  selectWindow	myPopupWindow
  selectWindow	null

• pause
  pause(millisenconds)
  - 根据指定时间暂停Selenium脚本执行
  - 常用在调试脚本或等待服务器段响应时

  pause	5000
  pause	2000

• fireEvent
   fireEvent(elementLocatore,evenName)
  模拟页面元素事件被激活的处理动作

  fireEvent	textField	focus
  fireEvent	dropDown	blur

• waitForCondition
  waitForCondition(JavaScriptSnippet,time)
  - 在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待

  waitForCondition

  var value=selenium.getText("foo"); value.match(/bar/);

  3000

• waitForValue
  waitForValue(inputLocator, value)
  - 等待某input(如hidden input)被赋予某值，
  - 会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞

  waitForValue	finishIndication	isfinished

• store,stroreValue
  store(valueToStore, variablename)
  保存一个值到变量里。
  该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量

  store	Mr John Smith	fullname
  store	$.｛title｝ $.｛firstname｝ $.｛suname｝	fullname
  store	javascript.｛Math.round(Math.PI*100)/100｝	PI
  storeValue	inputLocator	variableName

  把指定的input中的值保存到变量中
  

  storeValue	userName	userID
  type	userName	$.｛userID｝

• storeText, storeAttribute
  storeText(elementLocator, variablename)
  把指定元素的文本值赋予给变量

  storeText	currentDate	expectedStartDate
  verifyValue	startDate	$.｛expectedStartDate｝

  storeAttribute(.｛｝elementLocator@attributeName,variableName.｛｝)
  把指定元素的属性的值赋予给变量
  

  storeAttribute	input1@class	classOfInput1
  verifyAttribute	input2@class	$.｛classOfInput1｝

• chooseCancel.., answer..
  chooseCancelOnNextConfirmation()
  - 当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel
  - 如果没有该命令时，遇到confirm对话框Selenium默认返回true，如手动选择OK按钮一样

  chooseCancelOnNextConfirmation

  - 如果已经运行过该命令，当下一次又有confirm对话框出现时，也会同样地再次选择Cancel
  answerOnNextPrompt(answerString)
  - 在下次JavaScript弹出prompt提示框时，赋予其anweerString的值，并选择确定
  

  answerOnNextPrompt

  Kangaroo

Assertions

允許用戶去檢查目前狀態。兩種模式：Assert 和verify，當Assert失敗，則退出測試，當verify失則，測會繼續運行。

• assertLocation, assertTitle
  assertLocation(relativeLocation)
  判斷目前是在正確的頁面

  verifyLocation	/mypage
  assertLocation	/mypage

• assertTitle(titlePattern)
  檢查目前的頁面 title是否正確

  verifyTitle	My Page
  assertTitle	My Page

• assertValue
  assertValue(inputLocator, valuePattern)
  - 檢查input的值
  - 對於 checkbox或radio，如果已選擇，則值為"on",反之为"off"

  verifyValue	nameField	John Smith
  assertValue	document.forms[2].nameField	John Smith

• assertSelected, assertSelectedOptions
  assertSelected(selectLocator, optionSpecifier)
  检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同

  verifySelected	dropdown2	John Smith
  verifySelected	dorpdown2	value=js*123
  assertSelected	document.forms[2].dropDown	label=J*Smith
  assertSelected	document.forms[2].dropDown	index=0

• assertSelectOptions(selectLocator, optionLabelList)
  - 检查下拉菜单中的选项的文本是否和optionLabelList相同
  - optionLabelList是以逗号分割的一个字符串

  verifySelectOptions	dropdown2	John Smith,Dave Bird
  assertSelectOptions	document.forms[2].dropdown	Smith,J,Bird,D

• assertText
  assertText(elementLocator,textPattern)
  - 检查指定元素的文本
  - 只对有包含文本的元素生效
  - 对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本

  verifyText	statusMessage	Successful
  assertText	//div[@id='foo']//h1	Successful

• assertTextPresent, assertAttribute
  assertTextPresent(text)
  检查在当前给用户显示的页面上是否有出现指定的文本

  verifyTextPresent	You are now logged in
  assertTextPresent	You are now logged in

• assertAttribute(.｛｝elementLocator@attributeName.｛｝, ValuePattern)
  检查当前指定元素的属性的值

  verifyAttribute	txt1@class	bigAndBlod
  assertAttribute	document.images[0]@alt	alt-text
  verifyAttribute	//img[@id='foo']/alt	alt-text

• assertTextPresent, etc.
  assertTextPresent(text)
  assertTextNotPresent(text)
  assertElementPresent(elementLocator)

  verifyElementPresent	submitButton
  assertElementPresent	//img[@alt='foo']		assertElementNotPresent(elementLocator)

• assertTable
  assertTable(cellAddress, valuePattern)
  - 检查table里的某个cell中的值
  - cellAddress的语法是tableName.row.column, 注意行列序号都是从0开始

  verifyTable	myTable.1.6	Submitted
  assertTable	results0.2	13

• assertVisible, nonVisible
  assertVisible(elementLocator)
  - 检查指定的元素是否可视的
  - 隐藏一个元素可以用设置css的'visibility'属性为'hidden'，也可以设置'display'属性为'none'

  verfyVisible	postcode
  assertVisible	postcode

• assertNotVisible(elementLocator)

  verfyNotVisible	postcode
  assertNotVisible	postcode

• Editable, non-editable
  assertEditable(inputLocator)
  检查指定的input是否可以编辑

  verifyEditable	shape
  assertEditable	colour

• assertNotEditable(inputLocator)
  检查指定的input是否不可以编辑
• assertAlert
  assertAlert(messagePattern)
  - 检查JavaScript是否有产生带指定message的alert对话框
  - alert产生的顺序必须与检查的顺序一致
  - 检查alert时会产生与手动点击'OK'按钮一样的效果。如果一个alert产生了，而你却没有去检查它，selenium会在下个action中报错。
  - 注意：Selenium 不支持 JavaScript 在onload()事件时 调用alert();在这种情况下，Selenium需要你自己手动来点击OK.
• assertConfirmation
  assertConfirmation(messagePattern)
  - 检查JavaScript是否有产生带指定message的confirmation对话框和alert情况一样，confirmation对话框也必须在它们产生的时候进行检查
  - 默认情况下，Selenium会让confirm() 返回true, 相当于手动点击Ok按钮的效果。你能够通过chooseCancelOnNextConfirmation命令让confirm()返回false.同样 地，如果一个cofirmation对话框出现了，但你却没有检查的话，Selenium将会在下个action中报错
  - 注意：在Selenium的环境下，confirmation对话框框将不会再出现弹出显式对话框
  - 注意：Selenium不支持在onload()事件时调用confirmation对话框，在这种情况下，会出现显示confirmatioin对话框，并需要你自己手动点击。
• assertPrompt
  assertPrompt(messagePattern)
  - 检查JavaScript是否有产生带指定message的Prompt对话框
  - 你检查的prompt的顺序Prompt对话框产生的顺序必须相同
  - 必须在verifyPrompt之前调用answerOnNextPrompt命令
  - 如果prompt对话框出现了但你却没有检查，则Selenium会在下个action中报错

  answerOnNextPrompt	Joe
  click	id=delegate
  verifyPrompt	Delegate to who?

Parameters and Variables

参数和变量的声明范围由简单的赋值到JavaScript表达式赋值。
Store，storeValue 和storeText 为下次访问保存值。
在Selenium内部是用一个叫storeVars的map来保存变量名。

• Variable Substitution 变量替换
  提供了一个简单的方法去访问变量,语法 $.｛xxx｝

  store	Mr	title
  storeValue	nameField	surname
  store	$.｛title｝ $.｛suname｝	fullname
  type	textElement	Full name is: $.｛fullname｝

• JavaScript Evaluation JavaScript赋值
  你能用JavaScript来构建任何你所需要的值。
  这个参数是以javascript开头，语法是 javascript.｛'with a trailing'｝。
  可以通过JavaScript表达式给某元素赋值。

  store	javascript.｛'merchant'+(new Date()).getTime()｝	merchantId
  type	textElement	javascript.｛storedVars['merchantId'].toUpperCase()｝

Labview - automation detect VISA resource and then dial to server.

利用printf 寫script

printf '%s#!/bin/bash\nwl ver\n' > txbf_on.sh

root@www ~]# printf '列印格式' 實際內容
選項與參數：
關於格式方面的幾個特殊樣式：
       \a    警告聲音輸出
       \b    倒退鍵(backspace)
       \f    清除螢幕 (form feed)
       \n    輸出新的一行
       \r    亦即 Enter 按鍵
       \t    水平的 [tab] 按鍵
       \v    垂直的 [tab] 按鍵
       \xNN  NN 為兩位數的數字，可以轉換數字成為字元。
關於 C 程式語言內，常見的變數格式
       %ns   那個 n 是數字， s 代表 string ，亦即多少個字元；
       %ni   那個 n 是數字， i 代表 integer ，亦即多少整數位數；
       %N.nf 那個 n 與 N 都是數字， f 代表 floating (浮點)，如果有小數位數，
             假設我共要十個位數，但小數點有兩位，即為 %10.2f 囉！

sed 可以直接修改檔案的內容

直接修改檔案內容(危險動作)你以為 sed 只有這樣的能耐嗎？那可不！ sed 可以直接修改檔案的內容呢！而不必使用管線命令或資料流重導向！ 不過，由於這個動作會直接修改到原始的檔案，所以請你千萬不要隨便拿系統設定檔來測試喔！ 我們還是使用你下載的 regular_express.txt 檔案來測試看看吧！

範例六： 利用 sed 將 regular_express.txt 內每一行結尾若為 . 則換成 ! [root@www ~]# sed -i 's/\.$/\!/g' regular_express.txt # 上頭的 -i 選項可以讓你的 sed 直接去修改後面接的檔案內容而不是由螢幕輸出喔！ # 這個範例是用在取代！請您自行 cat 該檔案去查閱結果囉！ 範例七： 利用 sed 直接在 regular_express.txt 最後一行加入『# This is a test』 [root@www ~]# sed -i '$a # This is a test' regular_express.txt # 由於 $ 代表的是最後一行，而 a 的動作是新增，因此該檔案最後新增囉！

sed 的『 -i 』選項可以直接修改檔案內容，這功能非常有幫助！舉例來說，如果你有一個 100 萬行的檔案，你要在第 100 行加某些文字，此時使用 vim 可能會瘋掉！因為檔案太大了！那怎辦？就利用 sed 啊！透過 sed 直接修改/取代的功能，你甚至不需要使用 vim 去修訂！很棒吧！


總之，這個 sed 不錯用啦！而且很多的 shell script 都會使用到這個指令的功能～ sed 可以幫助系統管理員管理好日常的工作喔！要仔細的學習呢！

iTest 4.1 新版上市！

面對即將來臨的 2011 年，我們很高興宣布 iTest 4.1 新版上市！

iTest 4.1增加了許多新功能和模組，這些新增功能將大幅精進用戶們在測試時，相關 testbed 與自動化的範疇！加上新推出的 Fanfare iCentral 產品的結合，更讓用戶原有的測試數據報表得以提升到更高的層次。以下分別針對 iTest 4.1 與 iCentral 1.0 主要新功能作綱要介紹：

iTest 4.1 Highlights:

Web Services module：
現在透過 SOAP 或 RESTful 等 Web 服務，用戶可經由應用程式的 API 來對企業用軟體 (EMS, OSS/BSS 等) 直接進行測試與自動化。

VNC module：
這是全新的模組，讓用戶可以針對各種作業系統進行視窗化控制 (OS-related controls)，Windows, Mac, 或 Linux 等均可支援。透過此項功能，用戶可將案例範疇大幅度擴展，可進行更複雜的測試，譬如 triple play testing, VOIP testing, VPN connection tests 等。

VMware vSphere module：
強大的 VMware 也可納入到自動化測試內了，透過這個新推出的模組，用戶可以整合 VMware 到案例內，不論是 Create, retrieve, update, delete, start, stop 等動作都可操作，是相當便利的模組！

Test Report Diff feature：
提供快速比對測試案例的異同，可雙邊顯示，方便用戶找出差異處做進階處理。

Plus... 更多更多的模組強化功能也都放在新版本 4.1 內，舉凡 Java Swing, Virtual Testbed (VTB), iTestRT, reporting enhancements... 您還在等什麼呢？

Fanfare iCentral Highlights:

兼容 iTest 4.1：
iCentral 可轉換既有的 iTest 測試結果到您的決策工具內，提供最佳資訊給測試與管理高層。

Web-based 儀表版：
版本 1.0 含括 web-based 儀表版功能，可協助用戶整合並組織其測試數據，藉以分析得知產品測試後的涵蓋率、測試分組項目的現況，以協助研判產品發行是否就緒。

用戶更新訊息

•合法用戶請立即下載最新的 iTest 4.1：所有合法的用戶均可以從廣聯科技取得最新的版本與說明文件！

•尚未購買軟體更新執照的用戶：您還在使用舊版的 iTest 嗎? 該更新您手邊的版本囉，立即享受新版本的強大與便捷！

•線上教學： 歡迎任何想瞭解 Fanfare 軟體功能的朋友們，透過 Fanfare 論壇所提供的線上教學站台獲取您想知悉的一切，請連上 Fanfare Learning Center (也可經由 iTest HELP 功能連上本網站).

•iTest Lite 試用版：還沒購買的客戶想親身感受 iTest 的魅力嗎? 歡迎到 iTest Lite 申請試用!

關於 Fanfare

WinRunner.

Mercury WinRunner為您的企業提供強大的企業級的功能和迴歸測試工具。WinRunner自動記錄、驗證和重覆測試用戶的操作行為，確保應用部署後萬無一失地展開業務流程，並保證其可靠性。
主要功能：
1.輕鬆建立測試(Create Test Easily) 用WinRunner建立一個測試腳本，您只需紀錄一個標準的業務流程，例如下一張訂單或建立一個新的廠商帳戶。
2.插入檢查點(Insert Checkpoints) 在紀錄測試的過程中，您可插入檢查點，在找尋潛在錯誤的同時，比較預測和實際的測試結果。在插入檢查點後，WinRunner會收集一套性能標準，在測試運作時對其一一驗證。WinRunner能讓您使用幾種不同類型的檢查點，包括文字，GUI，bitmaps和資料庫。例如公司的Logo是否出現在指定位置等等驗證。
3.強化測試(Enhance Tests) 為了徹底全面測試一個應用系統，您需要了解當以不同的資料帶入時，它是如何運作的。透過WinRunner的DataDriverTM Wizard，將一個已紀錄的業務流程轉化為一個資料驅動程式，來反應許多個使用者的操作行為。WinRunner另一個能加強測試質量的特色是Function GeneratorTM--- 一種能快速且可靠地為您的測試增加功能的工具，使用Function Generator，您可以從目錄列表裡選擇一個功能加到您的測試中以提高測試能力，而不必知道功能或參數的名稱。
4.執行測試(Run Tests) 當WinRunner執行測試時，它會自動操作應用系統，就如同真實使用者根據業務流程執行著每一個步驟。
5.分析結果(Analyze Results) WinRunner互動式報表工具能提供詳盡的易讀報告，列出在測試中發現的錯誤及其位置，幫助您解釋分析測試結果。
6. 維護測試(Maintain Tests) 過了一段時間後，開發人員會對應用系統做進一步的修改，此時就必須進行額外的測試。然而有了WinRunner，您不必應用系統改變一次，就得重新進行一個新的測試。WinRunner可讓您建立可重複使用的測試，這樣一來可大大的節省時間和資源
優點特色：
WinRunner可以提供給您的企業應用系統以下優勢： >> 通過自動執行重複任務，減少了測試時間。 >> 通過在不同應用環境中使用同一測試工具，優化測試流程。 >> 測試腳本可針對不同需求修改並重複利用，大幅增加測試投資報酬率（ROI）。
適用平台：
Client-Server • Windows applications (Win32) • Visual Basic • Java • ActiveX Web技術 • HTML • DHTML • JavaScript Browsers • Internet Explorer • Netscape • AOL 企業應用 • Oracle • PeopleSoft • Siebel • Baan 作業平台 • Windows XP • Windows 2000 • Windows 98 • Windows NT • Windows ME Programming 環境 • PowerBuilder • Oracle Developer • Delphi • Centura • VisualAge Smalltalk • Forte • Janus Grids Terminal Emulators • 3270 • 5250 • VT100 伺服器技術 • Oracle • Microsoft • IBM • ODBC 語言 • 歐洲語言 • 日語 • 中文（繁體和簡體） • 韓語