Selenium 中文API

概念51Testing软件测试网 v6Z+M"lE Qp

Selenium 通过命令进行驱动。Selenium 可归纳为三种“风格”：动作、辅助和断言。每一个命令调用就是下表中的一行。

动作(Actions)命令一般用于操作应用程序的状态。它们通过如”点击链接”和”选择选项”的方式进行工作。如果一个动作执行失败，或是有错误，当前的测试将会停止执行。51Testing软件测试网3En1p)s0g6X2bZ(wg

i8d|]2mU0许多动作可以被包含后缀”并等待”的方式进行调用，例如,”点击并等待”。这个后缀告知Selenium，该命令将使浏览器向服务器产生一个请求，并使得Selenium等待加载一个新的页面。

辅助(Accessors)用于检查应用程序的状态并将结果存储在变量中。例如”storeTitle”。它们同样可用于自动生成断言。51Testing软件测试网'dVVld

断言(Assertions)类似于辅助，但它们可以验证应用程序的状态是否同所期望的相一致。例如包括”确认页面标题为X”和”验证该复选框是否被勾选”。51Testing软件测试网n N%w`V4V

-F7~1qB,A
bA}0所有的Selenium断言可以被用于三种模式：”assert”, “verify”，和”waitfor”。例如，你可以”assertText”，”verifyText”，及”waitforText”。当”assert”失败时，该测试将终止。当”verify”失败时，该测试将继续执行，并将错误记入日志。这就允许了通过单条”assert”确保应用程序在正确的页面上，而通过一系列的”verify”断言测试表单上的区域值，标签等。

d(_KC:PLSo,L0“waitfor”命令用于等待某些条件变为真(可用于Ajax应用程序的测试)。如果该条件已经为真，他们将立即成功执行。反之，如果该条件不为真，则将失败并暂停测试，直到超过当前所设定的超时时间(参照后面的setTimeout动作)。51Testing软件测试网7@FM e,G3YN Gj&R1f

元素定位器(Element Locators)告诉Selenium是向HTML中的哪一个元素发送命令。许多命令需要一个如”target”属性的元素定位器。这其中包括”elementId”和”document. forms[0].element”。在接下来的部分将更详细的描述它们。

#k;D0S"gf9aNZ0D0式样(Patterns)由于多种因素被使用着，如指定一个输入域的期望值，或识别一个选择选项。Selenium支持许多类型的式样，其中包括正则表达式，所有这些将在接下来的章节中进行更详细的描述。

定义一个类用于运行Selenium命令。

2|y$g0N,un0元素定位器(Element Locators)

7R0f+Sa*l'P3ji9Q0元素定位器(Element Locators)告诉Selenium是向HTML中的哪一个元素发送命令。一个定位器的格式如下：

:e ih0M9f&O0       locatorType = argument51Testing软件测试网F!?G0X1f2[{

我们支持如下写法用于定位元素：

WO1[ bU-]0·identifier=id :根据指定的@id属性选择元素。如果没有匹配的值，则选择第一个@name属性为id的元素。(参照后面)51Testing软件测试网N!^W"WcO uk

VE c@ f^]$A0·id=id :根据指定的@id属性选择元素。

,oo&A;f5LjO8]0·name=name :选择第一个根据指定的@name所查找到的元素。

    〇　username

    〇  name=username51Testing软件测试网\bH9R G~"G
b4c0h+T

5aKDK8NzdH0这里的name可以作为可选项跟在一个或多个元素过滤器的后面，通过空格进行分隔。如果没有指定过滤类型，则假定为value。51Testing软件测试网
e7{8wev(}

4Vqb'h{s w(qrb0    〇  name=flavour value=chocolate

·dom=javascriptExpression: 通过检测指定字符串查找元素。这使得你可以通过 JavaScript贯穿HTML文档对象。注意在这个字符串中返回值不是必须的；仅仅只需要确保这条语句是你块中的最后一条。51Testing软件测试网(J*?QBm6IE

aNnYA-u)Z7[0    〇  dom=document.forms[´myForm´].myDropdown51Testing软件测试网!a+k ?:q_z4i%X

}s tD+m-z0       〇  dom=document.images[56]51Testing软件测试网lX5GL#B

       〇  dom=function foo() { return document.links[1];}; foo();

·xpath=xpathExpression: 通过XPath 表达式定位元素。51Testing软件测试网$}F[y5c[0qyPB

TAcs)y*m3ds0    〇  xpath=//img[@alt=´The image alt text´]

    〇  xpath=//table[@id=´table1´]//tr[4]/td[2]

H)ct}
N6Ec0    〇  xpath=//a[contains(@href, ´#id1´)]

    〇  xpath=//a[contains(@href, ´#id1´)]/@class

$n@/DNZD0    〇  xpath=(//table[@class=´stylee´])//th[text()=´theHeaderText´]/../td51Testing软件测试网'_o-|*g7[
j$\`7C ]

}9]7W9I+L
nRp0    〇  xpath=//input[@name=´name2´ and @value=´yes´]51Testing软件测试网xR.c cD9D

!NN wNQNn0    〇  xpath=//*[text()=″right″]51Testing软件测试网8cu'B+N5_^I)u Je

x0Gj3|0QV8~0·link=textPattern: 选择所包含的文字匹配指定式样的链接(锚)。

~8zQi5Fs.L0k"n0    〇  link=The link text

zQ/_\ WT'q G _W0·css=cssSelectorSyntax: 通过css选择器选择元素。请查询 CSS2 选择器，CSS3 选择器以获得更多信息。在下载下来的selenium core package中的selenium test suite 里的TestCssLocators test ,你同样可以查看到使用例子。

    〇  css=a[href=″#id3″]51Testing软件测试网+`7En Rd-E.nf"\

       〇  css=span#firstChid + span51Testing软件测试网c@a8Q%Gz{-x

q0oeC[&qc k0当前css选择过滤器支持所有的css1,css2,css3,除了css3中一些虚拟类(:nth-of-type,:nth-last-of- type,:first-of-type,:last-of-type,:only-of- type,:visited,:hover,:active,:focus,:indeterminate)以及虚拟元素(::first- line,::first-letter,::selection,::before,::after)。51Testing软件测试网a}j
T'm|D\h!L

]OX^6R6|"Bj"]0如果没有一个显式的前缀，Selenium使用以下默认写法：

·dom,用于开头为″document.″的定位器

pIK5]'w6G0·xpath,用于开头为″//″的定位器

·identifier，其他

k:|/|Z&C#R|B0元素过滤器(Element Filters)51Testing软件测试网9ulN~-c-OjCYB lP

~:zsk/fl0元素过滤器可以同选择器一起使用，从一堆候选元素中进行筛选。它们当前仅使用于’name’元素选择器。

sV'HI(Q"c)k/J4I_0过滤器看起来更像是选择器，也就是：51Testing软件测试网+br'\3IR5o}

       filterType=argument

"m2K6?{,S:r{
J0 

KWqys.X0所支持的元素过滤器为：

value=valuePattern51Testing软件测试网6h4u!s+F${O-q-J!wl

         匹配元素时基于它们的值进行匹配。这在对一堆相似命名的关联按钮的筛选中显得尤其有用。51Testing软件测试网9XR1Q.y2i:p%W

index=index

        选择单个元素基于其在列表中的位置(从0开始)。51Testing软件测试网?1O Ol'M |*lZ

8Z"X%EBub*N:IlV0字符串匹配 式样51Testing软件测试网;Y Mj0| q#a

Pm1n(c5UZ0s7R6y?0有各种各样的式样语法可用于匹配字符串值：51Testing软件测试网n0M$j|5a$m,w5~@]

S%r"n4yb'v0L0·glob:pattern: 用″glob″去匹配一个字符串。″Glob″是一种用于命令行shells的代表性的有限正则表达式语法。在一个glob式样中, ″*″代表任意序列字符集，而″?″则代表任意单个字符。Glob式样匹配整个字符串。51Testing软件测试网*HPa:h^r3]I

M/T#zR@${0·regexp:regexp: 使用正则表达式匹配字符串。可使用所有的JavaScript正则表达式。51Testing软件测试网dg*[juD)O&T

@0aYpS/@&C+_u0如果没有指定式样前缀，Selenium假定其为″glob″式样。51Testing软件测试网yK.j4{A.i&Cg

%Q!`C0Z;{Y-V
G0Selenium Actions51Testing软件测试网Ms0\*pn3Y1A%mG

+`(y't&W,@3?"k"[?:e0addLocationStrategy (strategyName, functionDefinition)

&gxvVXm$t0  为selenium定义一个新的函数用于定位页面上的元素。例如，如果你定义了一个方法″foo″,并运行了click(″foo=blah″ )，我们将运行你的函数，传递给你字符串″blah″，并点击该函数所返回的元素，如果返回为null，则抛出一个″Element not found″的错误。我们将给该函数传递三个参数。

@$l@ zp9m Z$| r B/x0    ·locator: 用户传递过来的字符串51Testing软件测试网&{\8{BWRCiWr

4b)?P9G,rx0    ·inWindow: 当前所选中的窗体

    ·inDocument: 当前所选中的文档

如果未找到相应的元素，则函数必须返回一个null。

'pZT?'O0参数：

Zw/O$v u8q6Sf f3`0·strategyName – 定义的方法名；只能使用字母[a-zA-Z],不能包含空格或其他标点符号。

8x fD3v r0·functionDefinition – 在JavaScript函数中的一个定义body的字符串。

9ne8a
q(E0如：return inDocument.getElementById(locator);

addSelection (locator, optioLocator)

c(u:M2G1t0W0为通过使用选择定位器，在一个可多选元素中所选择的集合添加一个selection。@查看#doSelect关于选择定位器的细节。51Testing软件测试网$Y?T|)_

参数：51Testing软件测试网#k@4v@Z8O#L0R Ke

5r6w^oJ1ZI&m0·locator – 用于指定一个多选框的元素定位器

'h Y)qx)X+\aHcU!Y2r0·optionLocator – 一个选择定位器(默认为标签)51Testing软件测试网 p@:W;{ jD

7[(Hu3A B'lr7b0allowNativeXpath (allow)

.iEhdHQ[r0指定Selenium是否使用XPath的本地浏览执行(如果有可用的本地版本);如果传递的值为″false″，我们将使用pure- JavaScript. xpath 库。使用pure-JS xpath库可以提高xpath元素定位器在不同浏览器中的一致性，但其执行速度将大大低于本地执行。51Testing软件测试网!L\iIi o*_)i%[!^

]/NW-I;ac6y0参数：

:N2FB9_5gd L S0·allow – Boolean,true意味着我们更愿意使用本地XPath;false则意味着我们将只使用JS XPath51Testing软件测试网5x&kl-|%^'t_c?

9~7Ae${X6Z1O@7sU0altKeyDown()51Testing软件测试网W ~rKZ/?x(J

y+K)R9Iw(LZcr0按下alt键并保持其按下状态，直到doAltUp()被调用或一个新的页面被加载。

9y @2j&?zg-s'p4}C0altKeyUp()51Testing软件测试网.vw'Guxe&z8h K$I

释放alt键

:y E}#o/G
S^0answerOnNextPrompt (answer)

ahA8H.f0mU4O0通知Selenium返回下一次JavaScript. prompt[window.prompt()]所指定的回答字符串。51Testing软件测试网;O(G k*YH/DF{

#zo;NhC.QZ\0参数：51Testing软件测试网1\F3OM'c3a{0o\k%j@

  ·answer – 对弹出的提示所给与的回答

assignId (locator,identifier)51Testing软件测试网$H#q1dTL#_

临时为指定元素设定一个″id″属性，使你可以在将来使用其ID，以代替缓慢且更复杂的XPath。该ID将在页面重载后消失。51Testing软件测试网[*A~#}-FKq u

*HA0TL3cQS5k}0参数：51Testing软件测试网;[*z'fG(S$@,q`

.j8S)V8Xr:R4{lsj{~0    ·locator – 指向某个元素的元素定位器

  ·identifier – 为指定元素作为ID使用的字符串

break()51Testing软件测试网!ZU1W|5v,\F

'P S/s/YF0暂停当前正在进行的测试，并等待用户按下继续按钮。这个命令对于调试非常有用，但使用时要特别小心，因为他将强制暂停自动化测试，直到用户手动操作。51Testing软件测试网{-]G+H ~*w|N

y4Pk-@(^0w$JW1{J0check(locator)51Testing软件测试网,q)vme'sm&H!w

勾选一个关联性按钮(checkbox/radio)

参数：

  ·locator – 一个元素定位器

lK&I;e(lW0chooseCancelOnNextConfirmation()

默认情况下， Selenium的重载window.confirm()函数将返回true，等同于用户手动点击OK;执行该命令后，下一次调用 confirm()将返回false，等同于用户手动点击了Cancel。Selenium对后来的确认动作将继续使用默认行为，自动返回 true(OK),除非/直到你为每个确认动作明确的调用此命令。

hWiw| zS-H0chooseOkOnNextConfirmation()

撤销调用chooseCancelOnNextConfirmation的效果。注意，Selenium的重载window.confirm()函数通常将自动返回true，等同于用户手动点击OK，因此你没有必要使用此命令，除非由于某种原因使你在下一次确认动作前不得不改变你先前的想法。在任意确认动作后，Selenium对后来的确认动作将继续使用默认行为，自动返回true(OK),除非/直到你为每个确认动作明确的调用 chooseCancelOnNextConfirmation()。51Testing软件测试网1m%j p%oQ9Z

click(locator)

rU+yx0L p]O0点击一个链接、按钮、多选框或单选框。如果该点击事件导致了新的页面加载(如同链接通常所作的)，将调用waitForPageToLoad。

dYOf7{ lE"H0参数：

  ·locator -一个元素定位器

clickAt(locator,coordString)51Testing软件测试网%N%Hx!S"k

点击一个链接、按钮、多选框或单选框。如果该点击事件导致了新的页面加载(如同链接通常所作的)，将调用waitForPageToLoad。51Testing软件测试网{@4}t8@1]I

参数：

"O\2C}J
C!U2Q `k0  ·locator -一个元素定位器51Testing软件测试网v+o,fZ2Y

*Z4pb }#s(DO\Y0·coordString – 指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)51Testing软件测试网2F)K-Z Q*y [XJ

kFC*S&|0close()

模拟用户点击弹出窗体或表单标题栏上的″关闭″按钮。51Testing软件测试网!S@Uts K

EIu"Xs-Ho0controlKeyDown()

按下control键并保持其按下状态，直到doControlUp()被调用或一个新的页面被加载。

K/zN,xr*m0controlKeyUp()

x:A{^eWB0释放control键51Testing软件测试网1_Q?,d;y,V

*f \@-F|a0createCookie(nameValuePair,optionsString)

创建一个新的cookie，除非你清楚的指定该cookie的路径，否则其路径和域将与当前测试的页面相同。51Testing软件测试网@(dt\0z9zx.]3QZ+l

"UpFt3e0参数：

.yn*L8j,Z3u9P0  ·nameValuePair – 该cookie的名称和值，使用如下格式″name=value″

·optionsString – 该cookie的选项。当前支持的选项包括’path’和’max_age’。optionsString的格式为”path=/path/,max_age=60”。选项的顺序无关紧要。51Testing软件测试网q-al-P3kL t'sT

deleteCookie(name,path)

删除指定路径下的该名称cookie。51Testing软件测试网r8t9P;DF

&\3fPX T0参数：51Testing软件测试网!HX5@,h8\

B)T*}&o8?0uI0    ·name – 被删除cookie的名称

·path – 被删除cookie的路径属性51Testing软件测试网,n,Hs3[3~^cX:}

'c@tzKs0doubleClick(locator)51Testing软件测试网
V BU+]D

d7^Th$L6I0双击一个链接、按钮、多选框或单选框。如果该双击事件导致了新的页面加载(如同链接通常所作的)，将调用waitForPageToLoad。51Testing软件测试网x {g:ty(A+b i

参数：

  ·locator - 一个元素定位器

.|X9J6m7bM0doubleClickAt(locator,coordString)

双击一个链接、按钮、多选框或单选框。如果该双击事件导致了新的页面加载(如同链接通常所作的)，将调用waitForPageToLoad。

psrs,t$R2f4Px0参数：51Testing软件测试网 };q]QNw0N!oA

n lw }q-h0  ·locator - 一个元素定位器51Testing软件测试网[ W0b"o~k%c Q

#W$f"EL0g {\0·coordString – 指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)51Testing软件测试网 sA C7`*A$?4NgOd.X

dragAndDrop(locator,movementsString)51Testing软件测试网:i|"g*E*B/@:k

拖动元素一定的距离并放下

参数：

`$Xr?w/_o{0    ·locator - 一个元素定位器51Testing软件测试网XS7JM m\Z

  ·movementsString – 从当前位置到指定位置的像素偏移量，如,”+70,-300”

dragAndDropToObject(locatorOfObjectToBeDragged,locatorOfDragDestinationObject)51Testing软件测试网\Z Ss?,Q ~

拖动元素到另一元素

参数：

    ·locatorOfObjectToBeDragged – 被拖动的元素

·locatorOfDragDestinationObject – 被拖动的元素将拖向的元素的坐标 (如，其最中心像素)51Testing软件测试网/D0O)y R:BBk

s#E[h2C'E0Dragdrop(locator,movementsString)

不建议 – 用dragAndDrop 代替

参数：

    ·locator - 一个元素定位器51Testing软件测试网V;T8\)m8?`&a

·movementsString – 从当前位置到指定位置的像素偏移量，如,”+70,-300”

Echo(message)

打印指定消息到你的Selenese 表的第三个表单元。有利于调试。51Testing软件测试网&Ck!m.s{U
J4?

参数：

    ·message – 要打印的消息51Testing软件测试网'{(E9BH4\#\6pZA)Y

fireEvent(locator,eventName)

j(p1PI$PQ["X'}0明确地模拟一个事件，触发”onevent”响应句柄。

参数：

    ·locator - 一个元素定位器51Testing软件测试网/f+V6Pe D-Ji!E

8\v-rE2u-|1aJ
E0    ·eventName – 事件名，如”focus” 或”blur”

eYCqH4w0getSpeed()51Testing软件测试网!k$f.dXR8@

获取执行速度(也就是，获取接下来的每一个selenium操作的延迟豪秒长度)。默认情况下，是不会有延迟的。也就是延迟为0毫秒。参照setSpeed。

s%s,tkvce l0goBack()51Testing软件测试网{r3X \9iE\

M_ ^#ss-e%C0模拟用户点击其浏览器上的”back”按钮51Testing软件测试网-]5C_s/uv
s x H

f%p"n%cRc"P0highlight(locator)51Testing软件测试网k2NIJY"IG1H5D

1?$P'K,f$Y4w}+~_0暂时将指定元素的背景色改变为黄色。有利于调试。51Testing软件测试网:KE$Wm5Fe'aa(L%N$^

参数：

L6w&wf$r*l)u0    ·locator - 一个元素定位器

F(c%|S^2R
~ Qt0keyDown(locator,keySequence)51Testing软件测试网 E*mP"RYF6S

模拟用户按下一个键(除了还没释放的)51Testing软件测试网v\4gC%F2A2mbD@*w

参数：

'P_q nu7\'v;Gx0    ·locator - 一个元素定位器

    ·keySequence – 可以是个字符串(“/”后跟随要被按下键的数字键码，通常是该键的ASCII值)，或是个单字符，如“w“, “/119“。

keyPress(locator,keySequence)

模拟用户按下和释放一个键。

参数：51Testing软件测试网T|.O w.HYK
e9nH(\

    ·locator - 一个元素定位器

Q3fKMjx g V0    ·keySequence – 可以是个字符串(“/”后跟随要被按下键的数字键码，通常是该键的ASCII值)，或是个单字符，如“w“, “/119“。

keyUp(locator,keySequence)51Testing软件测试网&T:I6cl+AJ

}-m9T#?/U0模拟用户释放一个键。

参数：

    ·locator - 一个元素定位器

`3_$^*y0AI0    ·keySequence – 可以是个字符串(“/”后跟随要被按下键的数字键码，通常是该键的ASCII值)，或是个单字符，如“w“, “/119“。

metaKeyDown()51Testing软件测试网&c1pE5r8{#I

ovgxf7k0按下meta键并保持其按下状态，直到doMetaUp()被调用或一个新的页面被加载。

metaKeyUp()51Testing软件测试网L-Z%V\*G p+U8]|k

释放meta键

5Z:DWa|0mouseDown(locator)

模拟用户在指定元素上按下鼠标按钮(除了还没释放的)。51Testing软件测试网y8z3D g)b N8X-j

参数：51Testing软件测试网4{(o6pcs2q

    ·locator - 一个元素定位器

mouseDownAt(locator,coordString)51Testing软件测试网hm-NAlA)m'k(iyM @

8K1j6HQ}Jerb0模拟用户在指定位置上按下鼠标按钮(除了还没释放的)。

参数：

    ·locator - 一个元素定位器51Testing软件测试网 h&P
]0pE.]

·coordString -指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)51Testing软件测试网M:e(o:@,]

mouseMove(locator)

模拟用户在指定元素上按下鼠标按钮(除了还没释放的)。

参数：

    ·locator - 一个元素定位器

mouseMoveAt(locator,coordString)51Testing软件测试网"V,\(V9W'orUXU

模拟用户在指定位置上按下鼠标按钮(除了还没释放的)。

参数：51Testing软件测试网,WC$\&BO

    ·locator - 一个元素定位器

pH%`LtU:I(^Y&O0·coordString -指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

mouseOut(locator)51Testing软件测试网Od1K]v"A

_#qN"hoda$A(X]-i0模拟用户从指定元素上移开鼠标指针。51Testing软件测试网+cSuJx3b4~|

8t"q*]]K!\ob0参数：

    ·locator - 一个元素定位器51Testing软件测试网5b,Yd"k8{#B&z!I9s'A5^

m[#~2m6}3[vpn3S0mouseOver(locator)

模拟用户鼠标滑过指定元素。

gq?{(l!v2zQ0参数：

u'q4h-dO'tT-d0    ·locator - 一个元素定位器

mouseUp(locator)

模拟用户在指定元素上释放鼠标按钮时发生的事件(也就是，停止保持按钮按下)。51Testing软件测试网:dVq2M9\%_

$d/W_g
vyr0参数：51Testing软件测试网_"}
vxB)| C

)T]jN(P0?txQmO1m0    ·locator - 一个元素定位器51Testing软件测试网#n6~G_._

mouseUpAt(locator,coordString)51Testing软件测试网Vm)j6yi6s4u

模拟用户在指定元素上释放鼠标按钮时发生的事件(也就是，停止保持按钮按下)。

参数：51Testing软件测试网x U|,lR8HQN

    ·locator - 一个元素定位器51Testing软件测试网;C'uy(C.pwG[1t'u

4dj:FRX _/r0·coordString -指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

\%IwYv0w0open(url)51Testing软件测试网Y-c~[l7J%Y+}

Sm_BO JOe,O0在测试框架中打开一个URL，可以为相对和绝对URLs。”open”命令将等待页面加载完成才继续进行，也就是明确的指名”并等待”后缀。注意：由于浏览器安全策略(相同来源方针)这个URL必须和当前运行的HTML在相同的域。如果你不得不在另一个域打开一个URL，则需要用Selenium服务在另一个域去打开一个新的浏览器会话。

参数：

    ·url – 要打开的URL,可以为空

    ·windowID – 要选择窗体的JavaScript. window ID

d
PsSY/V#E0pause(waitTime)

等待指定时间(以毫秒为单位)51Testing软件测试网B"}7z'n5wD.J`:eA

参数：51Testing软件测试网;pi.? a(P{%xm

?!Y dQ#v2S c JQ0    ·waitTime – 要睡眠的时间(以毫秒为单位)

%R e7D$YM
f1y$u0refresh()51Testing软件测试网(C)V^wkM6r ~

模拟用户点击浏览器上的”Refresh”按钮。

removeAllSelections(locator)51Testing软件测试网PjoV+B| xBz

取消所有可多选元素的选择状态。

;oLh pz%u.a0[vJ0参数：51Testing软件测试网 x/X)F2`p)d\#l

7?f~R.k0    ·locator – 一个用于识别多选框的元素定位器

#t O
O X2p0removeSelection(locator,optionLocator)51Testing软件测试网q/S meS1o

从用选项定位器进行筛选的多选元素的筛选集合中移除一个集合。@在#doSelect中查看选项定位器的详细信息。

参数：51Testing软件测试网LLQbTBxt

lu)k"x,AG5S2a0    ·locator – 一个用于识别多选框的元素定位器51Testing软件测试网,[\C'i&{;ui

k}|3N/g3x0    ·optionLocator – 一个选项定位器(默认为一个标签)

runScript(script)51Testing软件测试网 x BA7yP,@JK

在当前测试窗体的body中创建一个新的”script”标签，并在body中添加指定的命令文本。用这种方式执行脚本，通常可以比使用 Selenium的”getEval”方式更简易的进行调试。要注意的是，由这种脚本标签所抛出的异常不受Selenium管理，因此当该脚本有可能会抛出异常时，你需要用try/catch块将其包含起来。

    ·script. – 需要执行的JavaScript 片段

o(LK)z$ZD&A&VD'T0select(selectLocator,optionLocator)51Testing软件测试网};t0D/]&u d N

y Q:Jmb'`0用选项选择器从一个下拉框中选择一个选项。

选项选择器提供不同的方法从一个HTML选择元素中识别选项。(例如：选择一个指定选项，或断言一个满足某种规范的选项)有许多种形式的选择选项定位器。51Testing软件测试网}4c ~"L'sfh k8r

    ·label=labelPattern: 基于其标签匹配选项，如其有效文本。(默认)

ts
f*G4_]+N0      〇 label=regexp:^[Oo]ther

    ·value=valuePattern: 基于其值匹配选项。51Testing软件测试网:r W]-wQ

      〇 value=other51Testing软件测试网X;jZ].J0k5E

7h&T8HA!RJ9V*[0    ·id=id: 基于其id匹配选项。

7D^:ObtY)Lo]cF0      〇 id=option1

Uz:E$PA2t'_ t1u)V0    ·index=index: 基于其索引匹配选项(从0开始)。51Testing软件测试网zn4RS,s4Mu d:E2[B

p"j[!LnG-wB\0      〇index=251Testing软件测试网`
u[3v3[

如果没有为选项定位器提供前缀，则默认匹配为标签行为。51Testing软件测试网^,bl;go5}!et

参数：

    ·selectLocator – 一个用于识别下拉菜单的元素定位器51Testing软件测试网o#mZ%S\

$}(~#I%La{;ev0    ·optionLocator – 一个选项选择器(默认为标签)51Testing软件测试网 IP/T7]uV&I&g|

selectFrame(locator)

)EM-Q+S~iH0dh/|{0在当前窗体中选择一个框架(你可以多次调用这个命令用于选择嵌套框架)。要选择父框架，用”relative=parent”作为定位器；要选择顶级框架，用”relative=top”。你同样可以通过基于0的索引号选择框架；用”index=0”选择第一个框架，或者用”index=2”选择第三个框架。51Testing软件测试网s n+o!B7UiK

你同样可以直接使用一个DOM表达式来识别你要的框架。像这样：dom=frames[“main”].frames[“subframe”]

参数：

    ·locator – 一个用于识别框架或子框架的元素定位器

c8E8vl'V2})A1f0selectWindow(windowID)

选择一个弹出窗体；一旦一个弹出窗体被选中，所有的命令将指向该窗体。要再次选择主窗体，将对象设定为null。

注意：window的内在JavaScript的”name”属性和被给与的window文档(通常是你实际看到的，作为最终用户，在窗体的标题栏上)的”title”之间有一个很大的不同。”name”对于最终用户通常是不可见的；它是作为第二个参数”windowName”传递给 JavaScript函数window.open(url,windowName,windowFeatures,replaceFlag)(被 Selenium截取)。

xu ~D k2@Wz;h/B0Selenium有许多方法用于查找被”windowID”参数所提及的窗体对象。

:q+c~!ve r/jI(i01.)    如果windowID为null，(或是字符串”null”)，则假定为用户是提交给由浏览器最初实例化的窗体。51Testing软件测试网q*n'} JZuZ!l

2.)    如果”windowID”参数的值是当前应用窗体的一个JavaScript变量名，则假定该变量包含一个由调用JavaScript. window.open()函数所产生的返回值。

r)IH:g)ZE03.)    另外，selenium looks in a hash it maintains that maps string names to window “names”.51Testing软件测试网QP4K0ZYi p

4.)    如果失败了，我们将循环遍历所有已知的窗体以便试图找出适合的”title”。由于”title”不是必须唯一，因此可能会产生一些非期望的行为。51Testing软件测试网1{l2G:W$z ~%H

/X:[ x2y)jaW$~0如果很难判定你所要操作的窗体的名称，你可以查看为识别通过window.open(被Selenium截取)所打开窗体的名称时所产生的selenium 日志消息。在每个窗体被打开时，你通常可以看到如下信息：51Testing软件测试网I%V}@.L{)|z

B h\ @/pS0debug: window.open call intercepted; window ID (你可以用于 selectWindow()) is “myNewWindow”

Z$g7gk:o0在某些情况，Selenium会无法截取window.open的调用(例如，如果该调用发生在”onLoad”事件之间或之前)。(该BUG标记为SEL-339)。在这些情况，你可以使用Selenium的openWindow命令强制Selenium去通告打开窗体的名称，使用一个空 (blank) url，像这样：openWindow(“”,”myFunnyWindow”)。51Testing软件测试网GIl?k(F,F!V

%Z\9Zk;S'bL Ze0参数：51Testing软件测试网2Y]#t/sXDR

    ·windowID – 要选择窗体的JavaScript 窗体ID51Testing软件测试网3X%pl.V,T

O:j$qY5d0SB(|n J g
]0setBrowserLogLevel(logLevel)

设定浏览器方日志信息级别；在此级别之下的日志信息将被丢弃。有效的日志级别字符串有：”debug”，”info”，”warn”，”error”，或”off”。要查看浏览器日志，在GUI模式下打开日志窗口，或在Selenium RC中将浏览器端记入日志设定为enable。51Testing软件测试网+t.k`l3v

v$hq0`u2s0参数：51Testing软件测试网Z"C8oA)@/]#wF

    ·logLevel – 以下之一：”debug”，”info”，”warn”，”error”，或”off”51Testing软件测试网'H5oQz/U ~+M

,jp7]4RXJ0setCursorPosition(locator,position)51Testing软件测试网V3`I Hf+B,e

+sco.`7N.g,n0将文本光标移动到被给与的输入元素或文本域的指定位置。若指定元素不是一个可输入元素或文本域，该方法将失败。

!U}/Z%SN-rB0参数：

{ zlQ%d#X1c0    ·locator – 一个指向输入元素或文本域的元素定位器

$^`0iBl0E/E0    ·position – 该范围的光标数字位置；position如果设定为0，则为该范围域的最开始位置，你同样可以将光标设定为-1以移动到该范围域的最末端。51Testing软件测试网M5J] ns _9FE4W

setMouseSpeed(pixels)

配置在dragAndDrop 命令执行期间，”mousemove”事件时的像素数字(默认为10)。

将这个值设定为0，意味着我们将向从开始位置到结束位置的每一个像素发送一个”mousemove”事件；那将会非常缓慢，且可能导致某些浏览器将该JavaScript强制设定为超时。51Testing软件测试网N(IRhh

如果该鼠标速度大于两个拖动对象间的距离，我们将只向开始位置和结束位置发送一个”mousemove”事件。51Testing软件测试网H,pG'El.@3W7b/i

G"M(sp%w-n"F0参数：51Testing软件测试网!o
\&|3je!['op[h[-M

    ·pixels – 两个“mousemove”事件间的像素间隔

setSpeed(value)51Testing软件测试网[Uo'x.ek p2dI j

设定执行速度(也就是说，设定将要执行的每条selenium操作间的毫秒延迟间隔长度)。默认情况下，没有延迟，也就是延迟为0毫秒。51Testing软件测试网Z#[MbM/a-~

+S@7e-A!X)W,K"w'{0参数：51Testing软件测试网#Z-H6v7E'`,G(I

    ·value – 在操作后的暂停毫秒数

setTimeout(timeout)51Testing软件测试网.Lsi^B"eg

指定Selenium等待动作完成的等待时间。

cLl%U#m5P9V{u
Z0需要等待的动作包括”open”和”waitFor*”。51Testing软件测试网-Z2^6t!qW9plC\-E

k
j BHy E1GP)_/b~0默认超时为30秒。51Testing软件测试网/x,|j6XCF

参数：51Testing软件测试网e9hP&SR

    ·timeout – 以毫秒为单位，超过后该命令将返回错误。51Testing软件测试网v8Q&W ]7bu8UPl

shiftKeyDown()

pQ#L1E9ff_W0按下shift键，并保持按下状态，直到doShiftUp()被调用或一个新的页面被加载。

shiftKeyUp()

释放shift键。51Testing软件测试网'do1V1?V2F9gz

0y&@&Wny.Kg0store(expression,variableName)

该命令是存储表达式的同义词。

参数：

A-w@\ s0    ·expression – 要存储的值51Testing软件测试网7R/fU6Ip)H

dPq$Hd$l(I7[S0    ·variableName – 用于存储结果的变量名51Testing软件测试网(w(OWS H;\;R4tb

0pf({d*YD(Ny0submit(formLocator)

提交给指定表单。这对于没有提交按钮的表单特别有用，如，简单输入的”search”表单。51Testing软件测试网]({F+H,C'_8_
z[

参数：

LeA_(i/jl+bmk0    ·formLocator – 一个指向你要提交的表单的元素定位器51Testing软件测试网w6tK3LM
X3d[i_$Q*n:h

type(locator,value)

)|\%ef'|ttJ0设定一个输入域的值，如同你输入进去一样。51Testing软件测试网2R|f(pq"e8VC"U

vJ'L\'ab9Mcs'Y0其同样可用于单选框，多选框等。在这些情况，value应为选项选择时的值，而不是有效文本。

参数：51Testing软件测试网I'P(e(a?

    ·locator – 一个元素定位器

    ·value – 要录入的值51Testing软件测试网xDY.WpB6zB

jH6z ]C5Z'E0typeKeys(locator,value)51Testing软件测试网/O:d4EKIN2q

模拟在指定元素上的按键事件，如同是你一个键一个键敲上去一样。51Testing软件测试网+b\*@*[2J

比起为指定字符串的每个字符调用keyDown,keyUp,keyPress方法，这个函数要方便的多；其对于需要明确按键事件的动态UI组件(如自动完成的combo box)同样有用。

不同于简单的”敲打”命令——将指定值直接强制赋给页面，该指令可能有，也可能没有任何效果，即时在敲打按钮通常会有效的情况下。例如，如果你在一个表单元素上使用”typeKeys”，你可能可以，也可能不可以看到看到你在该区域录入的效果。

在有些时候，你可能不得不使用简单的”type”命令去设定域的值，然后用”typeKeys”命令去发送按键事件以告知你所录入的值。51Testing软件测试网3v'M/[nRD

参数：51Testing软件测试网1[CS;D[&b)B

    ·locator – 一个元素定位器51Testing软件测试网$|F~ og)Y4A

u`Y
k;M0    ·value – 要录入的值

uncheck(locator)

KH GZQ YV%kn0取消选中一个关联性按钮(checkbox/radio)51Testing软件测试网Qu2~b+N,bE?O I

参数：51Testing软件测试网 }Y4R(e;p

    ·locator – 一个元素定位器

waitForCondition(script,timeout)

重复执行指定JavaScript片段直到其值为”true”。

该片段可以有多行，但只考虑其最后一行的结果。

[yyj&\QV0要注意：默认情况下，该片段会在运行者的测试窗体运行，而不是在你的应用程序窗体。要得到你的应用程序窗体，你可以使用JavaScript片段selenium.browserbot.getCurrentWindow()，然后让你的JavaScript在那运行。51Testing软件测试网 pQw9K,cvE5N

{[l|K"] F{6Q0参数：51Testing软件测试网7j[d%O(A~

v"L5y?&W3v/d5_7H0    ·script. – 要运行的JavaScript片段

8qs$n.Xr.i+mQ#k0    ·timeout –以毫秒为单位，超过后该命令将返回错误。

waitForFrameToLoad(frameAddress,timeout)

等待一个新的框架加载。51Testing软件测试网x:y%Gg0N8~

?8\ Zy*`V2w0Selenium通常会持续跟踪新页面和框架的加载状态，当其第一次注意到页面加载完成，将会设定一个”newPageLoaded”标志。

查看waitForPageToLoad获得更多信息。51Testing软件测试网v)Vj(cF3saf'@
KT_

参数：

q.|(H mu5KH/d0    ·frameAddress – 服务端的框架地址51Testing软件测试网w9xQtd@ shq,X"M-s

    ·timeout - 以毫秒为单位，超过后该命令将返回错误。

S$Q,y_z z0waitForPageToLoad(timeout)

+L~)_,s?0等待一个新的页面加载。51Testing软件测试网GQuVh

你可以使用此命令以代替”AndWait”后缀，”clickAndWait”，”selectAndWait”，”typeAndWait”等(仅在JS API中有效)。

E&i8B!l|KC3Yb!wv0Selenium通常会持续跟踪新页面的加载状态，当其第一次注意到页面加载完成，将会设定一个”newPageLoaded”标志。当此标志变为 false后再运行其他Selenium命令。因此，如果你要等待一个页面加载完成，当一个Selenium命令导致一个页面加载后就需立即开始等待。

bqee1oST0参数：51Testing软件测试网o9hYA%r6f

    ·timeout - 以毫秒为单位，超过后该命令将返回错误。51Testing软件测试网qq4BFsa?O@L

T#q$c-RMZ)T0waitForPopUp(windowID,timeout)

等待一个弹出窗体出现和加载。

BW r$C O,X3kz0参数：51Testing软件测试网5ark1m2Q8ZF

    ·windowID – 将出现窗体的JavaScript 窗体ID51Testing软件测试网
sL"\t$i/GR*SD

    ·timeout - 以毫秒为单位，超过后该命令将返回错误。

+R"u}mT~;p0windowFocus()

cmHLS0将焦点赋给当前选择窗体51Testing软件测试网UG xJa8F1{ _?n2`

reyb'c/Cne*]0windowMaximize()

#v[7ghc6f)h3g[l0重新设定当前窗体大小为全屏51Testing软件测试网v+}N%li

;fn g#\2l'dBx)_0Selenium Accessors51Testing软件测试网1C7ES/g;@w

assertErrorOnNext(message)

1? pP"qM{?-S0告诉Selenium在下一个命令执行时期待有错误。

参数：51Testing软件测试网kF|.?#Sx,s3Gz#l

    ·message – 我们所期望的错误信息。如果出现不正确的错误信息，该命令将失败。

同断言相关联，自动生成：51Testing软件测试网t1k }9XBa

    ·assertNotErrorOnNext(message)51Testing软件测试网(|.Q;?u
] tB T

)sO,_2w0U8o:_}v*G_0    ·verifyErrorOnNext(message)

9yW0ng.J0sm0    ·verifyNotErrorOnNext(message)51Testing软件测试网 dM1p3W:_ R2r

    ·waitForErrorOnNext(message)

    ·waitForNotErrorOnNext(message)

? }1UtHnR$l)y_8d0assertFailureOnNext(message)

告诉Selenium在下一个命令执行时期待有失败。51Testing软件测试网t W%`G$CQ!q5Y

参数：

AT.gR/K0    ·message – 我们所期望的失败信息。如果出现不正确的失败信息，该命令将失败。

%nZy"q-j)F/h#M!v/I0同断言相关联，自动生成：51Testing软件测试网$B$y8F } \R

jC8@ t6N`d]0    ·assertNotFailureOnNext(message)

  ·verifyFailureOnNext(message)51Testing软件测试网h/}Uc3a

  ·verifyNotFailureOnNext(message)

,fN
PzG4?!?^1T0  ·waitForFailureOnNext(message)

  ·waitForNotFailureOnNext(message)51Testing软件测试网}ZG$^`;y

$xC-S_&^_-Mpu7fX0assertSelected(selectLocator,optionLocator)51Testing软件测试网/Ms
]2m {6e7h+o

9Z0@p5RvJ N$f0验证从下拉框中选择的选项满足选项指定器。

d`j%E8rM:j!}0注意，不赞成使用该命令；你应该使用assertSelectedLabel, assertSelectedValue, assertSelectedIndex,或assertSelectedId进行代替。

pN
y P+n|9}0查看选择命令获取更多关于选择定位器的信息。

参数：

    ·selectLocator - 一个用于识别下拉菜单的元素定位器51Testing软件测试网d&?'Wf PH? f3i

    ·optionLocator – 一个选项定位器，代表性的就是一个选项标签(如”John Smith”)

同断言相关联，自动生成：51Testing软件测试网"z!qa @%U%B&\

Q.u.N%x9I0    ·assertNotSelected(selectLocator,optionLocator)51Testing软件测试网S3n/L~}\#]

  ·verifySelected(selectLocator,optionLocator)51Testing软件测试网 k_3^:Au_,ww

  ·verifyNotSelected(selectLocator,optionLocator)

8Pv jvK4_v B1}M+a%r0  ·waitForSelected(selectLocator,optionLocator)51Testing软件测试网#d"aI
_K$U~q

  ·waitForNotSelected(selectLocator,optionLocator)51Testing软件测试网*dnx,h6Nc$U

storeAlert(variableName)

,p-\0`hv+M0返回在之前动作所产生的JavaScript警告消息，如果没有警告将失败。

得到一个警告同手动点击OK有着相同的效果。如果产生了一个警告，而你并不去得到/验证它，那么下一个Selenium动作将失败。51Testing软件测试网?q&cW4JV5JT!W

|$[s0Qj V[0注意：在Selenium中，JavaScript警告将不会弹出一个可见的警告对话框。51Testing软件测试网?:xd\I6H

注意：Selenium不支持在页面的onload()事件句柄中所产生的JavaScript警告。在这种情况下，将会生成一个可见的对话框，Selenium将被悬停直到手动点击OK。51Testing软件测试网Q[,t7`L

Returns:

  最近JavaScript的警告消息51Testing软件测试网7K(N a,q._%PM i}x u?

#EoIw"M5h H[-`0同断言相关联，自动生成：51Testing软件测试网\6w9g#[`;~\9RI:]3R

    ·assertAlert(pattern)51Testing软件测试网"L/a om2["wfq

  ·assertNotAlert(pattern)

  ·verifyAlert(pattern)51Testing软件测试网-wmr c/L l"x]

  ·verifyNotAlert(pattern)

/zE-FV$b&qo)[ A0  ·waitForAlert(pattern)51Testing软件测试网i8NHi*Rf

  ·waitForNotAlert(pattern)51Testing软件测试网}%Pw,e']|

storeAllButtons(variableName)

返回页面上所有按钮的ID集。

如果被给与的按钮没有ID，则将在结果数组中显示为””。51Testing软件测试网&zs8h3U+d1AO3}

Returns:51Testing软件测试网!N+l)n"@*g+M

&p(Js/^0V!f%x^#b3R`0  页面上所有按钮的ID集。51Testing软件测试网y9|;H$i KD7Xh y

同断言相关联，自动生成：

y$C'M4o8m3L;Z5u0    ·assertAllButtons(pattern)

VS fS5H;{9c&_0    ·assertNotAllButtons(pattern)

    ·verifyAllButtons(pattern)

`+K8y(e0}&P0    ·verifyNotAllButtons(pattern)

    ·waitForAllButtons(pattern)

3KzPNiB0    ·waitForNotAllButtons(pattern)51Testing软件测试网"Xw0xC(fT*F+m7s6_

&D4}V\$D0storeAllFields(variableName)51Testing软件测试网[Un-tB

返回页面上所有可输入域的ID集。

'n(k}:EVD$d0如果被给与的域没有ID，则将在结果数组中显示为””51Testing软件测试网#qO[;W AH'K.E

Returns:51Testing软件测试网v-Z9Y6Ig I9W5r:z

  页面上所有域的ID集。51Testing软件测试网
u%}baFqT6b!]

8E M
r
vRRu D0同断言相关联，自动生成：

    ·assertAllFields(pattern)51Testing软件测试网~Kd p L3aFY)c

eh7\E,?8I*o0    ·assertNotAllFields (pattern)

    ·verifyAllFields (pattern)51Testing软件测试网bob"_.] vl"rou

eH MO {#d't-mA0    ·verifyNotAllFields (pattern)

    ·waitForAllFields (pattern)

-GsLTCv0    ·waitForNotAllFields (pattern)51Testing软件测试网vF zvQ]9H&x

storeAllLinks(variableName)51Testing软件测试网,xR
z@6u2in;o:?U

C(x6FAJS)jw0返回页面上所有链接的ID集。51Testing软件测试网eY,lPbw`

如果被给与的链接没有ID，则将在结果数组中显示为””

Y$y"n6r;?y0Returns:

  页面上所有链接的ID集。51Testing软件测试网lvq2l,[3w

同断言相关联，自动生成：

e;^ Ipj"pn!K?0    ·assertAllLinks(pattern)

"d)YJz/\O5s/`5J&o0    ·assertNotAllLinks (pattern)

#F?1GR!_P3q/K0    ·verifyAllLinks (pattern)51Testing软件测试网8nN;{b'r

    ·verifyNotAllLinks (pattern)

#X,i|.E.bi0    ·waitForAllLinks (pattern)51Testing软件测试网&`\.~$j B;c0mn$p

J0W3T!kG;r.\j3k0    ·waitForNotAllLinks (pattern)51Testing软件测试网 c wcy,T.X/J+AbX$F[

storeAllWindowIds(variableName)51Testing软件测试网ao Z&^V

)H)p{:D+BDrG}f[0返回所有浏览器已知的窗体ID集。

Returns:51Testing软件测试网1w(Q'?/P:l@oA

  所有浏览器已知的窗体ID集。51Testing软件测试网)l+oa![*c$I

v/xr6em'FwwE0同断言相关联，自动生成：51Testing软件测试网Lg.nZ9W

W8g*y~dVIjv1E0    ·assertAllWindowIds (pattern)51Testing软件测试网 LYyhV\D"v'tb

  ·assertNotAllWindowIds (pattern)51Testing软件测试网Bj8k tB/B

  ·verifyAllWindowIds (pattern)

^#QX&Q4qH0  ·verifyNotAllWindowIds (pattern)51Testing软件测试网7^%PR'_V"\9k{

  ·waitForAllWindowIds (pattern)

6L0]Y"M^T0  ·waitForNotAllWindowIds (pattern)51Testing软件测试网&R a6_+zVT5@

storeAllWindowNames(variableName)51Testing软件测试网5H;um6P|b VG4A

qCt(lB^^0返回所有浏览器已知的窗体名称集。51Testing软件测试网b$UO3xL^+J

Returns:

%j-W
N'Mr4Z4F(yP-]0  所有浏览器已知的窗体名称集。51Testing软件测试网p_qH#Kbe

S__3j5b@B.S4np0同断言相关联，自动生成：

    ·assertAllWindowNames (pattern)

k1wiK+`4w\5m6T0  ·assertNotAllWindowNames (pattern)

3w8k
`&j'sf.m0  ·verifyAllWindowNames (pattern)51Testing软件测试网s!v L%S]Q:@S)gP!N0S

  ·verifyNotAllWindowNames (pattern)

p~Wi)S|"\ cG]0  ·waitForAllWindowNames (pattern)

  ·waitForNotAllWindowNames (pattern)51Testing软件测试网s2Y"N hgriFv

storeAllWindowTitles(variableName)

+W2A @ x`"j s0返回所有浏览器已知的窗体标题集。

Returns:51Testing软件测试网e-z*hsL9S@

  所有浏览器已知的窗体标题集。51Testing软件测试网6tzz/V5B*]y)z

uZ1O9Z;U1`1V0p/a+Y0同断言相关联，自动生成：51Testing软件测试网-y%~t'Pr(yk

Hy
B _)d"I0    ·assertAllWindowTitles (pattern)

  ·assertNotAllWindowTitles (pattern)

  ·verifyAllWindowTitles (pattern)51Testing软件测试网tj Jy}Wx

  ·verifyNotAllWindowTitles (pattern)

  ·waitForAllWindowTitles (pattern)

l5giB'ld A0^0  ·waitForNotAllWindowTitles (pattern)51Testing软件测试网2c1S)sD
K.P$r7T

!xRA.{4}`[`3KR0storeAttribute(attributeLocator,variableName)

获得一个元素属性值。

CP
_1U^'u;j3GO%y0参数：51Testing软件测试网rs!LBy2~

    ·attributeLocator – 由@符号开头，后跟随属性名，如”foo@bar”

3c-Z#X&I&dr4eR0    ·variableName – 用于存储结果的变量名。51Testing软件测试网;AcbS*g]2z{I

%gK2[h#[&X F0Returns:51Testing软件测试网FNrV)P#X A|V

`}OZZT0  指定属性的值51Testing软件测试网2aQ [{J@)k

同断言相关联，自动生成：51Testing软件测试网)Nb^0jwL h!sS wt/F

    ·assertAttribute (attributeLocator, pattern)51Testing软件测试网'XEhJ4{,hH-[!j+Z&H

  ·assertNotAttribute (attributeLocator, pattern)51Testing软件测试网f
wRCs G,x_

,y MU,FR\$j3w0  ·verifyAttribute (attributeLocator, pattern)

  ·verifyNotAttribute (attributeLocator, pattern)51Testing软件测试网%J
t*b2}!P-B&Z6{tX&l

n
qwuvB5e3g0  ·waitForAttribute (attributeLocator, pattern)

  ·waitForNotAttribute (attributeLocator, pattern)51Testing软件测试网8C F)UO(e5WM r

storeAttributeFromAllWindows(attributeName,variableName)

返回所有已知窗体的某些属性的每一个实例。

参数：

l7XG-]
F%cx1oY| q0    ·attributeName – 窗体某属性的名称51Testing软件测试网8pZ*t'JW

    ·variableName - 用于存储结果的变量名。51Testing软件测试网S0cv-n;z9U0}%@*LU-t

Returns:

  从所有已知窗体获得的该属性的数值集。51Testing软件测试网0xt%r*P(`
f2E j~7J

同断言相关联，自动生成：

$`ofEJ0    ·assertAttributeFromAllWindows (attributeName, pattern)

  ·assertNotAttributeFromAllWindows (attributeName, pattern)51Testing软件测试网:]#J)b
xzIEA3a Con

1pZ U:V??*Y0  ·verifyAttributeFromAllWindows (attributeName, pattern)51Testing软件测试网9l Obp"hk\

  ·verifyNotAttributeFromAllWindows (attributeName, pattern)

Yzf%[RKT4M0  ·waitForAttributeFromAllWindows (attributeName, pattern)51Testing软件测试网P7{H2T1{ AOH

  ·waitForNotAttributeFromAllWindows (attributeName, pattern)

storeBodyText(variableName)51Testing软件测试网nkf ScW

W$J'T9CT,O6NM0获取页面上所有文本。

m;lm m`0Returns:51Testing软件测试网e_$J.`I

  页面上所有文本51Testing软件测试网1| Zq9VZJ,Xi"|

同断言相关联，自动生成：51Testing软件测试网9B@8s9H5_X'{

Mw%QiaY#V8Z"Lb0    ·assertBodyText (pattern)

  ·assertNotBodyText (pattern)51Testing软件测试网l{9tJU d8d

7DT|.~f"l/R ]S0  ·verifyBodyText (pattern)51Testing软件测试网0F3_%w&XA:D*d
IN

~:nY B2u.Fd0  ·verifyNotBodyText (pattern)51Testing软件测试网 `g L
w`/])V*[7@

X'mu!jrhGW*b4ZDT0  ·waitForBodyText (pattern)51Testing软件测试网]dAn$[j2Qc#?

  ·waitForNotBodyText (pattern)51Testing软件测试网'if!s0WP*kk

storeConfirmation(variableName)51Testing软件测试网C3N0Qnw9OE`)\1t

w3Fp]6AZF0返回在之前动作所产生的JavaScript确认消息。51Testing软件测试网;fm7g;sF,\i'gi

默认情况下，confirm函数将返回true，同手动点击OK有着相同的效果。这可以通过之前执行chooseCancelOnNextConfirmation命令改变。如果产生了一个确认，而你并不去得到/验证它，那么下一个Selenium动作将失败。

注意：在Selenium中，JavaScript确认将不会弹出一个可见的对话框。

_,G M9mfx-@0注意：Selenium不支持在页面的onload()事件句柄中所产生的JavaScript警告。在这种情况下，将会生成一个可见的对话框，Selenium将被悬停直到手动点击OK。

Returns:

  最近JavaScript的确认消息

dN3V] J0同断言相关联，自动生成：

    ·assertConfirmation (pattern)

  ·assertNotConfirmation (pattern)51Testing软件测试网gYX vZ.f}J
W$?

$j/z!jAH2e,?/YI0  ·verifyConfirmation (pattern)51Testing软件测试网x[5T0`~

+tP@ O{O;yo~%OF0  ·verifyNotConfirmation (pattern)51Testing软件测试网9O&o:T&T`D

j M8\&jF0  ·waitForConfirmation (pattern)51Testing软件测试网-|,y)_"V@%j

kG&CI-f"Y3Q0  ·waitForNotConfirmation (pattern)

storeCookie(variableName)51Testing软件测试网!E%Qw.Vh0oh

返回当前测试下当前页面的所有cookies51Testing软件测试网-D(@%~+p(Cj0[

Returns:51Testing软件测试网-I7F2~W9s1q:N _;vz

  当前测试下当前页面的所有cookies51Testing软件测试网j5Q)b/ps8QC5@;i"V9vi

yn.mw2I2V;GX0同断言相关联，自动生成：51Testing软件测试网T*js#v\$^

!E,T,D `%l ]k3zU'h0    ·assertCookie (pattern)

-Uz`.I)K0  ·assertNotCookie (pattern)

  ·verifyCookie (pattern)

  ·verifyNotCookie (pattern)

pA+u.f9~(s0  ·waitForCookie (pattern)

~)Ze@1H{4{0  ·waitForNotCookie (pattern)51Testing软件测试网,h5HDY&mo3o

storeCursorPosition(locator,variableName)51Testing软件测试网!g-bE jrT

返回所给与的输入元素或文本域的文本光标位置。51Testing软件测试网5G `'Xhc!aF

要注意，这并不在所有的浏览器中有效。

#v(D|([Jjc|d0特别指出，如果光标/选择已经被JavaScript所清除，该命令将尝试返回光标所在的最后位置，即使光标已经不在该页面。这被归档为SEL-243。51Testing软件测试网 r9Z+vjV.c

如果指定元素不是一个可输入元素或文本域，或没有光标在此元素上，该方法将失败。51Testing软件测试网Dz2F#j RWI*V*P"_n

参数：

    ·locator – 一个指向输入元素或文本域的元素定位器51Testing软件测试网rCc!D9tC"n

    ·variableName - 用于存储结果的变量名。

@[{WZ%vH l]%n'?0Returns:

josgeY0  在该域中的光标数字位置51Testing软件测试网2VHb!m#g!o2? G^e

同断言相关联，自动生成：51Testing软件测试网1iF5P7S0w)p:[r

m-c'@3FuvS0    ·assertCursorPosition (locator,pattern)51Testing软件测试网@6A0D-y*rc+q

  ·assertNotCursorPosition (locator,pattern)51Testing软件测试网0D0\c(FZV

  ·verifyCursorPosition (locator,pattern)

  ·verifyNotCursorPosition (locator,pattern)

  ·waitForCursorPosition (locator,pattern)

  ·waitForNotCursorPosition (locator,pattern)51Testing软件测试网O,BW0?#_hG#fztD L
E

storeElementHeight(locator,variableName)

b&},Ab:G$c$S0返回元素的高度

参数：

    ·locator – 一个指向元素的元素定位器51Testing软件测试网fabY}9n6V1e

1{d[4M+rf5t2a:R0    ·variableName - 用于存储结果的变量名。51Testing软件测试网!B'F/|T u8Wl

Returns:

2{\m| p @ L0  元素的高度51Testing软件测试网M%pfZ/n$M

同断言相关联，自动生成：51Testing软件测试网l w9v6mBu

mG?(x0gz$}KG0    ·assertElementHeight (locator,pattern)

6]s3M;\c `k(y0  ·assertNotElementHeight (locator,pattern)51Testing软件测试网a'E f(L7OwP+O4J

iutAo%V3[xy0  ·verifyElementHeight (locator,pattern)51Testing软件测试网E#zD ats G

$l0A6d TDu0  ·verifyNotElementHeight (locator,pattern)

  ·waitForElementHeight (locator,pattern)

e!`U9U~0  ·waitForNotElementHeight (locator,pattern)51Testing软件测试网#am(}$|.F BN7PNW

storeElementIndex(locator,variableName)51Testing软件测试网*wLO~!F,m@P

获取元素相对于其父元素的索引(从0开始)。注释节点和空文本节点将被忽略。51Testing软件测试网/}wTwh`.`i

参数：51Testing软件测试网G[8b
pI @_+PY

#a"h)_({,[4|A&U}0    ·locator – 一个指向元素的元素定位器

"w'p1wu!P0    ·variableName - 用于存储结果的变量名。51Testing软件测试网7?7O8G;C_ n:}4_k

sho?5`'\ apvr9|0Returns:

  元素相对于其父元素的索引(从0开始)51Testing软件测试网de0G"HOKI

0SNJ^x)Yx0同断言相关联，自动生成：51Testing软件测试网+^"Yus;D%DI7v

)Y#XJb4z)v0    ·assertElementIndex (locator,pattern)51Testing软件测试网
SdgOQ3Uym

&J ^m(fC`0  ·assertNotElementIndex (locator,pattern)51Testing软件测试网{6r&j\0`S2xT

  ·verifyElementIndex (locator,pattern)51Testing软件测试网 U6eM+Ui+@J/?+z!p2T'C6f:J

  ·verifyNotElementIndex (locator,pattern)

  ·waitForElementIndex (locator,pattern)51Testing软件测试网E5o2k5xH^ i

  ·waitForNotElementIndex (locator,pattern)

-guF K*aA3IL0storeElementPositionLeft(locator,variableName)

返回元素的水平位置51Testing软件测试网.Nj.^,VM^'r

TKZ(c#g4H,j |yW0参数：51Testing软件测试网,p"c8yHvR

    ·locator – 一个指向元素的元素定位器或元素本身51Testing软件测试网XQ+X4yD\

Qd\1].L0    ·variableName - 用于存储结果的变量名。51Testing软件测试网9SM2PQ;I-t

Returns:51Testing软件测试网7i[/A"y_m.p~

  到框架边缘的像素。

同断言相关联，自动生成：

+e2Z]'Ni9sa H0    ·assertElementPositionLeft (locator,pattern)51Testing软件测试网K)X udV6h!f)\M

^^8@ v,rq0  ·assertNotElementPositionLeft (locator,pattern)51Testing软件测试网`BU,eo

  ·verifyElementPositionLeft (locator,pattern)

r?s8M&z'huEn0  ·verifyNotElementPositionLeft (locator,pattern)51Testing软件测试网 Yt9_'lX
I2s:~%?#Z+~

IX1T;FQxVD0  ·waitForElementPositionLeft (locator,pattern)51Testing软件测试网%b}9GHdj Y%n

%u8F#SJdLJ0  ·waitForNotElementPositionLeft (locator,pattern)

storeElementPositionTop(locator,variableName)51Testing软件测试网}7O,D1U;K

_#tQ"V \0返回元素的纵向位置

参数：51Testing软件测试网5h)T4q5x t?

5~
o'G(ub0    ·locator – 一个指向元素的元素定位器或元素本身

    ·variableName - 用于存储结果的变量名。51Testing软件测试网7v1fr6P@Z&o/W

Returns:

  到框架边缘的像素。51Testing软件测试网*l/}c"`0R!Q_

E,F,czB,Tk0同断言相关联，自动生成：51Testing软件测试网R;NBMJ TOX7_#e

    ·assertElementPositionTop (locator,pattern)51Testing软件测试网r[XC&T:v["e

  ·assertNotElementPositionTop (locator,pattern)51Testing软件测试网+Zh"}t$^LM
I r

  ·verifyElementPositionTop (locator,pattern)

mM9m#nOX }c1J0  ·verifyNotElementPositionTop (locator,pattern)51Testing软件测试网X!H!SO-K@!W

w-e0t/jq!VK0  ·waitForElementPositionTop (locator,pattern)

sC SqU0  ·waitForNotElementPositionTop (locator,pattern)

9?'m
?`$IwnT0storeElementWidth(locator,variableName)

返回元素的宽度

)Kt$R-_@;t3k|ieS6V0参数：51Testing软件测试网0kIw4i+aT

    ·locator – 一个指向元素的元素定位器

    ·variableName - 用于存储结果的变量名。

v&\@f8Ebza0Returns:51Testing软件测试网%l?U8|O
Q@ V(I't

9I#w X3yc0  元素的宽度(以像素为单位)51Testing软件测试网Li1zUyM0R[ l

9P5WR,s(Hi"^E0同断言相关联，自动生成：51Testing软件测试网`3\\zX8OL

    ·assertElementWidth (locator,pattern)51Testing软件测试网E Gsb,@

e?Dn+`;p%p0  ·assertNotElementWidth (locator,pattern)51Testing软件测试网HLiL{CN

a&u0TK]5Y9DA]Db0  ·verifyElementWidth (locator,pattern)

  ·verifyNotElementWidth (locator,pattern)51Testing软件测试网)C,w.u$@3n

  ·waitForElementWidth (locator,pattern)

nv!s2q5Fj0  ·waitForNotElementWidth (locator,pattern)

storeEval(script,variableName)

获得指定JavaScript片段执行后的值。该片段可以有多行，但只返回最后一行的值。要注意到，默认情况下，该片段将在”selenium”对象本身的上下文中运行，因此其将提交给Selenium对象。用window将窗体提交给你的应用程序，如：

window.document.getElementById(‘foo’)

4Q2WcwITUc0如果你不得不在你的应用程序页面使用一个定位器提交一个单元素，你可以用this.browserbot.findElement(“id=foo”)，这里”id=foo”就是你的定位器。51Testing软件测试网n%j:JHf!F

参数：

1p D5T c E$F-V!LX0    ·script. – 要运行的JavaScript51Testing软件测试网.R)AJ z\`

9D ukEa Y0    ·variableName - 用于存储结果的变量名。51Testing软件测试网)g-o'[.X!Lat0PjfV

IQ7sG[%t0Q?0Returns:51Testing软件测试网7v9{#{l-h

  片段执行后的值

同断言相关联，自动生成：51Testing软件测试网}BV5s Dq\

    ·assertEval (script,pattern)51Testing软件测试网%nJ] fS9r'tK

  ·assertNotEval (script,pattern)

[lZ*T I*_$m0  ·verifyEval (script,pattern)51Testing软件测试网
d.?'z xCreH

  ·verifyNotEval (script,pattern)

.F]1Ryv_r7qrZZ0  ·waitForEval (script,pattern)

  ·waitForNotEval (script,pattern)51Testing软件测试网*c ^K)yi v

C {hcb0storeExpression(expression,variableName)51Testing软件测试网-DIO&{(X3LzP-d#u6X

s*j3M7b+\%k`0返回指定表达式。

由于JavaScript的预处理机制使其显得非常有用。它可以用于生成如assertExpression和waitForExpression命令。51Testing软件测试网!yK(B[{

;y y,B#]~9f'`*w0参数：

    ·expression – 要返回的值51Testing软件测试网9CY se|*O|nP'EN

    ·variableName - 用于存储结果的变量名。

Returns:51Testing软件测试网({ E1r J\7d6tRE&k2Z7]

t:eO`U'_9b9L.~7lNp0  通过的值51Testing软件测试网F-U K-i;A/o`H

4{q!}X q5w*b0同断言相关联，自动生成：51Testing软件测试网zYmC;E,H"e9f

    ·assertExpression (expression,pattern)

  ·assertNotExpression (expression,pattern)

  ·verifyExpression (expression,pattern)

8k+Rqde~4k#c0  ·verifyNotExpression (expression,pattern)51Testing软件测试网*@8a&T7x"B

2|b{Y;N0  ·waitForExpression (expression,pattern)

ol)f|XC3L0  ·waitForNotExpression (expression,pattern)

V4x!{
P y@N(Y0storeHtmlSource(variableName)51Testing软件测试网)z@:O9Djy1AD

返回”html”标签间的整个HTML源代码。51Testing软件测试网4VY xs@%k;a
](]2Ix&u

%w-]0iZ\y
s#k.A0Returns:

9O[5OPt3W6C0  整个HTML源代码51Testing软件测试网|sa)z2ai;P

p7s[ d.Y&|0同断言相关联，自动生成：

2Xf q!Sb:k#[^/c0    ·assertHtmlSource (pattern)51Testing软件测试网yl2V$\(k2Ei

  ·assertNotHtmlSource (pattern)51Testing软件测试网X_m\G"d

  ·verifyHtmlSource (pattern)

[Y"?%XD4SlB0  ·verifyNotHtmlSource (pattern)

(N L{ \ c&i0  ·waitForHtmlSource (pattern)51Testing软件测试网vS]8o9f.yI

;MJS)G{o6al3C U0  ·waitForNotHtmlSource (pattern)

8~q.D6]!X ^n4f0storeLocation(variableName)51Testing软件测试网?~_tSLP

%r$G)} `"X$Gt0取得当前页面的绝对路径51Testing软件测试网 |rFd(px

Returns:

  当前页面的绝对路径

1|+`}^%W5K0同断言相关联，自动生成：51Testing软件测试网-ve&sRe

    ·assertLocation (pattern)51Testing软件测试网/_`)d'n;C'EG9{'uK

BC z}*Qj0  ·assertNotLocation (pattern)

  ·verifyLocation (pattern)51Testing软件测试网 k+X"JD;RIn

*N.YBHL5g.l8M,E0  ·verifyNotLocation (pattern)

{ L-] r8Cm ]-T0  ·waitForLocation (pattern)

  ·waitForNotLocation (pattern)

storeMouseSpeed(variableName)

返回在dragAndDrop 命令执行期间，”mousemove”事件时的像素数字(默认为10)

2I[-Ht@b
u![F m0Returns:51Testing软件测试网 \\sen0bJw8C

[mTX V.gc0  dragAndDrop 命令执行期间，”mousemove”事件时的像素数字(默认为10)

7A$QS,v*@$q0同断言相关联，自动生成：51Testing软件测试网*Zjj(JpY$YNNQ

    ·assertMouseSpeed (pattern)51Testing软件测试网,[1G3h)O%p:\B

U4~v6C
Up0  ·assertNotMouseSpeed (pattern)51Testing软件测试网Wj(j!Kc

0k7om6v!Y&\0  ·verifyMouseSpeed (pattern)51Testing软件测试网bXb^x6C k1z

'\9@v:Yu(jM.\0  ·verifyNotMouseSpeed (pattern)

q5g8AQn-@*?Ip0  ·waitForMouseSpeed (pattern)

j1E sgZp Q_0  ·waitForNotMouseSpeed (pattern)51Testing软件测试网%d4A \W6j;?D

v1r.M-P$s0l9^f2~0storePrompt(variableName)51Testing软件测试网S9^+e5}%O/w]B e R(Uy

返回在之前动作所产生的JavaScript问题提示消息。

/F9m/aq
j(~hx0要成功挂起问题提示需要先运行answerOnNextPrompt命令。如果产生了一个问题提示，而你并不去得到/验证它，那么下一个Selenium动作将失败。51Testing软件测试网_7U?T {z`;`P

NXk;Bx(YS M,M#uB0注意：在Selenium中，JavaScript确认将不会弹出一个可见的对话框。51Testing软件测试网2rpZ4G&a7m VJ0S

注意：Selenium不支持在页面的onload()事件句柄中所产生的JavaScript问题提示。在这种情况下，将会生成一个可见的对话框，Selenium将被悬停直到手动点击OK。51Testing软件测试网8Nnbd'k

#KM3`6uA'] }0Returns:51Testing软件测试网?z,L@8kD

  最近JavaScript的问题提示消息51Testing软件测试网 iP2r4v3S&d#R `0bO*E

Z]2~2k7A0同断言相关联，自动生成：

1\xH|%tOq h({L(o0    ·assertPrompt (pattern)

l[Ff,Rm+{I%m0  ·assertNotPrompt (pattern)

  ·verifyPrompt (pattern)51Testing软件测试网i` n*F&_| d_0~|T,B/J

  ·verifyNotPrompt (pattern)51Testing软件测试网XG!X'r*]ntjF

/Z2p%~w/z??PI0  ·waitForPrompt (pattern)51Testing软件测试网Nni*]a

*Gf'zYY'z3]K0  ·waitForNotPrompt (pattern)

*p+DO%_e;l0storeSelectedId(selectLocator,variableName)51Testing软件测试网?1D1om.F4O1fN

获取从指定选择元素中选择的选项元素ID。

2Z&s ]+E*BX[q[0参数：

    ·selectLocator - 一个用于识别下拉菜单的元素定位器

5MF#|:L$s a:a$}J0    ·variableName - 用于存储结果的变量名。51Testing软件测试网p1R1E Z%i#}B4iY1{3B

'R!pq4c:n3b.p}0Returns:51Testing软件测试网/ld S
A$A

4[QlV&XUs0  从指定选择元素中选择的选项元素ID51Testing软件测试网ET i%V-}\5AF

同断言相关联，自动生成：

kPNJ9u!U6w}Z0    ·assertSelectedId (selectLocator,pattern)

N u7[&kd \+Wc0  ·assertNotSelectedId (selectLocator,pattern)51Testing软件测试网,bh5Rz&y

[ {C0J{{0  ·verifySelectedId (selectLocator,pattern)51Testing软件测试网&J!y4l/drJ-wR&s#B

  ·verifyNotSelectedId (selectLocator,pattern)

  ·waitForSelectedId (selectLocator,pattern)

Gj+O k_0[o:|M0  ·waitForNotSelectedId (selectLocator,pattern)

storeSelectedIds(selectLocator,variableName)51Testing软件测试网/HN}"fC K/~n]#]

x5r2d i_ ai0从指定选择或多选元素中获取选择的选项元素ID集。51Testing软件测试网*j
P"p_;wn.n

.TN}v3\z7qsG0参数：

:FW3~~T5UtW*l%E^0    ·selectLocator - 一个用于识别下拉菜单的元素定位器

+nM!^(K5af^ u5p0    ·variableName - 用于存储结果的变量名。51Testing软件测试网/\&ZKR9]*xK*ek0l

r!rq&k*K1v \0Returns:51Testing软件测试网+N0H6yz4qi0Vn+C

  从指定选择或多选元素中选择的选项元素ID集合数组

同断言相关联，自动生成：51Testing软件测试网-T7~ mHI
C ^^

-\ azs.b7{Pf4j0    ·assertSelectedIds (selectLocator,pattern)51Testing软件测试网2pe)m6BxA

7y1fr$x6d G0  ·assertNotSelectedIds (selectLocator,pattern)

6a9Ww0Z8^'Z0  ·verifySelectedIds (selectLocator,pattern)

o8I
hN SAT f0  ·verifyNotSelectedIds (selectLocator,pattern)

  ·waitForSelectedIds (selectLocator,pattern)

  ·waitForNotSelectedIds (selectLocator,pattern)

,GUovG1N0storeSelectedIndex(selectLocator,variableName)

z/q$~,U?n6E0o)cD0从指定的选择元素中获取被选项索引(从0开始)。

!aX!q9J6`zU8q e0参数：51Testing软件测试网5ep4{,`w/Bvw {Y.~

\{ X8qB e0    ·selectLocator - 一个用于识别下拉菜单的元素定位器51Testing软件测试网%ohA+m#N9E

    ·variableName - 用于存储结果的变量名。51Testing软件测试网C8jj;L o0O;o2B8^

.m^B*q"h0Returns:

L@6Ui&P r0k$R~1u0  从指定选择元素中选择的选项元素索引

#\hY.X'G0同断言相关联，自动生成：51Testing软件测试网%yk)b/f#ft.{

    ·assertSelectedIndex (selectLocator,pattern)

xC)VgJ.C
K8L:]m6Q0  ·assertNotSelectedIndex (selectLocator,pattern)

  ·verifySelectedIndex (selectLocator,pattern)

  ·verifyNotSelectedIndex (selectLocator,pattern)51Testing软件测试网,L$F&}+}2w*juI

  ·waitForSelectedIndex (selectLocator,pattern)

  ·waitForNotSelectedIndex (selectLocator,pattern)

2j{Am0^]Nx8g0storeSelectedIndexs(selectLocator,variableName)51Testing软件测试网2q+zUb^

/pd(j.CUnT0从指定的选择或多选元素中获取被选项索引(从0开始)集。51Testing软件测试网2b{{+]+rZci9s

参数：

    ·selectLocator - 一个用于识别下拉菜单的元素定位器51Testing软件测试网fRY&XT?8o,m

d9t-SY:n+?Z0    ·variableName - 用于存储结果的变量名。

Returns:51Testing软件测试网(b9{nr"d'z+htr

f/FOf4n:`gQ0  从指定选择或多选元素中选择的选项元素索引集合数组51Testing软件测试网+s3@e$E`%^i^

同断言相关联，自动生成：

7^[_"rTQ0    ·assertSelectedIndexs (selectLocator,pattern)

  ·assertNotSelectedIndexs (selectLocator,pattern)

3\%F B\i(O#Va0  ·verifySelectedIndexs (selectLocator,pattern)51Testing软件测试网Ki
Y q1go%k i.@

'uy:qi \ y0A0  ·verifyNotSelectedIndexs (selectLocator,pattern)

h|mopT&}0  ·waitForSelectedIndexs (selectLocator,pattern)

{!Uy\o w0  ·waitForNotSelectedIndexs (selectLocator,pattern)

storeSelectedLabel(selectLocator,variableName)51Testing软件测试网W z lId

从指定的选择元素中获取所选择的选项标签(可见文本)。

参数：

    ·selectLocator - 一个用于识别下拉菜单的元素定位器

    ·variableName - 用于存储结果的变量名。

Returns:

h&t-b)a0f jK7]*hh0所选择的选项标签51Testing软件测试网\8Ti.CT9S:CI'b

:eK$OUe+h+OPP0同断言相关联，自动生成：51Testing软件测试网8al~I1_#O_

7k2E2j$YD{:G:R)YW0    ·assertSelectedLabel (selectLocator,pattern)51Testing软件测试网ZI9u)J,U*~

&|n3aJKFFn0  ·assertNotSelectedLabel (selectLocator,pattern)

  ·verifySelectedLabel (selectLocator,pattern)

&e/d pJ`2b/x0  ·verifyNotSelectedLabel (selectLocator,pattern)

  ·waitForSelectedLabel (selectLocator,pattern)

^&hYZUWU0  ·waitForNotSelectedLabel (selectLocator,pattern)

rTv"ZXt;o*q0storeSelectedLabels(selectLocator,variableName)51Testing软件测试网P(Q6w1Q@:e%R K2^ W'| b

从指定的选择或多选元素中获取所选择的选项标签(可见文本)。

U3F*WK!DJ)gk ~0参数：51Testing软件测试网m sk4_QN9Dx z am

    ·selectLocator - 一个用于识别下拉菜单的元素定位器51Testing软件测试网t2H2N3K
o:G#C%w l7{v

#Y
a0@ vn3qC0    ·variableName - 用于存储结果的变量名。51Testing软件测试网t1P6sZ`]`

1?|p8l:fk f7G
P5|qO0Returns:

所选择的选项标签

6s+b.on)eNKb0同断言相关联，自动生成：51Testing软件测试网 J,\D!}P#I
EqT._

    ·assertSelectedLabel (selectLocator,pattern)51Testing软件测试网'N!V2Wn \#|(k0\)V!`

vy)u@}Di
`o0  ·assertNotSelectedLabel (selectLocator,pattern)51Testing软件测试网4M%UQ(qsQPC

g"@,c-saW7?!P0  ·verifySelectedLabel (selectLocator,pattern)

  ·verifyNotSelectedLabel (selectLocator,pattern)51Testing软件测试网#Q*I%y~ke|Gv%b1x

;S ]I,i.uE0  ·waitForSelectedLabel (selectLocator,pattern)51Testing软件测试网Z0OJvr:QzQ/@2{

Xv)kk a0  ·waitForNotSelectedLabel (selectLocator,pattern)51Testing软件测试网]8O H&X` z]f3B

storeSelectedValue(selectLocator,variableName)

-j
B wM3b ~E7M-p0从指定的选择元素中获取所选择的选项值(值属性)。51Testing软件测试网T$le q*?8Q"?

参数：51Testing软件测试网%D{o'CUtF(@.h.Y

$o*G3uZkF$V8q0    ·selectLocator - 一个用于识别下拉菜单的元素定位器51Testing软件测试网,LG(E1I:N;@1Tg

    ·variableName - 用于存储结果的变量名。51Testing软件测试网/M&Mh2MFW

UK!dZ8pp|K X0Returns:

所选择的选项值

'k@)E)v#G'Rc*DYE0同断言相关联，自动生成：

)a|)l7wj'M#Pl0    ·assertSelectedValue (selectLocator,pattern)

rJOH,Z\{0  ·assertNotSelectedValue (selectLocator,pattern)

6BB3o!|C3CL!r0  ·verifySelectedValue (selectLocator,pattern)

+Ur7t z9H `tf0  ·verifyNotSelectedValue (selectLocator,pattern)

  ·waitForSelectedValue (selectLocator,pattern)

Z0bwr2@0  ·waitForNotSelectedValue (selectLocator,pattern)51Testing软件测试网wJ6f#u0]"D1aD qt

zcw!f2yp0storeSelectedValues(selectLocator,variableName)

从指定的选择或多选元素中获取所有所选择的选项值(值属性)。51Testing软件测试网-p9`pK!Z9fVg

:q[km'[ PD0参数：

    ·selectLocator - 一个用于识别下拉菜单的元素定位器51Testing软件测试网$O!g~^v

8PvY
osvg*o(O0    ·variableName - 用于存储结果的变量名。

:i1m9k-J
g9B ^!vX0Returns:51Testing软件测试网KC%f7w*PK8u{Gnp

所有所选择的选项值数组

同断言相关联，自动生成：51Testing软件测试网*Mq@i@6yi-F

    ·assertSelectedValues (selectLocator,pattern)51Testing软件测试网fSF]/l(E1gt$f

w2dOJ:g0  ·assertNotSelectedValues (selectLocator,pattern)51Testing软件测试网JlH(D(i~

2?+Y [hUL
u3Q0  ·verifySelectedValues (selectLocator,pattern)51Testing软件测试网q2o |jr @*G:F

  ·verifyNotSelectedValues (selectLocator,pattern)51Testing软件测试网"A9s`*V i e

  ·waitForSelectedValues (selectLocator,pattern)

  ·waitForNotSelectedValues (selectLocator,pattern)51Testing软件测试网/M5AV'Kv/I'j

storeSelectOptions(selectLocator,variableName)

获取指定选择下拉框的选项标签。

~Sh
lP-R$h&]0D|0参数：51Testing软件测试网apN,Q%mLZ

;jN,KM!nJ0    ·selectLocator - 一个用于识别下拉菜单的元素定位器

    ·variableName - 用于存储结果的变量名。

Returns:51Testing软件测试网Fx;Ifn!bE8P%F

g\_n9u(|2W0指定选择下拉框的选项标签数组51Testing软件测试网 xb.dhO1]]

e%Z lp`;xFm7p!eb0同断言相关联，自动生成：51Testing软件测试网;O IK5W OP"Eg

6YWxf,{&T0    ·assertSelectedOptions (selectLocator,pattern)51Testing软件测试网0{juC F}Y)_%E8P%A

  ·assertNotSelectedOptions (selectLocator,pattern)51Testing软件测试网5YF7zn.n}R

2A4U9tg&Xt/FR0  ·verifySelectedOptions (selectLocator,pattern)51Testing软件测试网^$t9b;M@!S7`Q

'Rp5F%ht5w*Z?"S0  ·verifyNotSelectedOptions (selectLocator,pattern)51Testing软件测试网eZwF"?[PC

  ·waitForSelectedOptions (selectLocator,pattern)51Testing软件测试网W w K@'nu

)R xL*MJ*\;h0O4| l0  ·waitForNotSelectedOptions (selectLocator,pattern)

9gU+s@q5V |Go+w0storeTable(tableCellAddress,variableName)

{+\C^9ky&`*c"s0从某个表的单元格中获取文本。单元格地址语法如tablelocator.row.column，这里的row和column从0开始。

,hG9C"q$u&O0参数：51Testing软件测试网gW$w({E7T u

    ·tableCellAddress – 一个单元格地址，如”foo.1.4”

dc0^7F%mJ.X0    ·variableName -用于存储结果的变量名。51Testing软件测试网#n3V\\9h%W

m6r5V\b#p2Q0Returns:

  从指定单元格取出的文本51Testing软件测试网"s~I'O]{4K

同断言相关联，自动生成：51Testing软件测试网1b]3qg9l V

ThIBd.Eu-|0    ·assertTable (tableCellAddress,pattern)51Testing软件测试网'SI$EZ%`TEM-Q

}f
E(nT7r"B1}&j|0  ·assertNotTable (tableCellAddress,pattern)

  ·verifyTable (tableCellAddress,pattern)51Testing软件测试网/F5Q+V9WN9t[c`

  ·verifyNotTable (tableCellAddress,pattern)

  ·waitForTable (tableCellAddress,pattern)51Testing软件测试网Zv_{v(md6C4D

  ·waitForNotTable (tableCellAddress,pattern)

{;b2vq[6xV bp0storeText(locator,variableName)

获取元素的文本。这对任何包含文本的元素都有效。该命令即可以用于如火狐浏览器的textContent，也可以用于如IE浏览器的innerText——显示给用户的。51Testing软件测试网1l@4qXX

参数：

    ·locator - 一个元素定位器

    ·variableName - 用于存储结果的变量名。

IpT4l?w!U
U![w0Returns:

  元素的文本

%s8P:C Oi{(Oj0同断言相关联，自动生成：51Testing软件测试网"f9i.i:|M

/{0@9fx,g8]!Sz[0    ·assertText (locator,pattern)

F&{ KDVqa.HN0  ·assertNotText (locator,pattern)51Testing软件测试网+Jt!Gbhy:tO

  ·verifyText (locator,pattern)

  ·verifyNotText (locator,pattern)51Testing软件测试网&n4\.T
M?b)p

+p;]SoF;d0  ·waitForText (locator,pattern)

CN,DYjJ9Zk0  ·waitForNotText (locator,pattern)51Testing软件测试网:xlbyuO~k[,p

8}pnA[1L;['X"}5M0storeTitle(variableName)

获取当前页面的标题。51Testing软件测试网6oS6t&t$G8G*?

Gq!o[G`kV0Returns:51Testing软件测试网%rQ4vNZ*CX

  当前页面的标题。

0t-kJ%?|d5X,IY0同断言相关联，自动生成：

MUM h;mT0    ·assertTitle (pattern)

  ·assertNotTitle (pattern)51Testing软件测试网!h%N5L L` \"I9@x_ A

  ·verifyTitle (pattern)51Testing软件测试网(ux+w-\~#VpAe

"weLG*{Q D0  ·verifyNotTitle (pattern)51Testing软件测试网&MBO{$s

f4L_-A f.]0  ·waitForTitle (pattern)51Testing软件测试网uFg-}/_0C

  ·waitForNotTitle (pattern)

storeValue(locator,variableName)

获得一个输入域(或任何包含value参数的元素)的值(已去除空格)。对于checkbox/radio元素，其值为”on”还是”off”依赖于该元素是否被选中。

8mJ9h e,C8u!G0参数：51Testing软件测试网RSm3f&WB

4K
af$g#`0    ·locator - 一个元素定位器51Testing软件测试网w{\E
G

D KSHlk z0    ·variableName - 用于存储结果的变量名。

Returns:51Testing软件测试网4j&SZREu'r

  元素值，对于checkbox/radio元素则为”on/off”

同断言相关联，自动生成：51Testing软件测试网#`$Z A'V}ko

&rg#_6^"b(E0    ·assertValue (locator,pattern)51Testing软件测试网.f HH+h'Xk

0sI/EcOE"M]0  ·assertNotValue (locator,pattern)

  ·verifyValue (locator,pattern)

  ·verifyNotValue (locator,pattern)51Testing软件测试网 zkfA.]DM6o

  ·waitForValue (locator,pattern)51Testing软件测试网:e%N`d/hc,PL-^

  ·waitForNotValue (locator,pattern)

storeWhetherThisFrameMatchFrameExpression(currenFrameString,target,variableName)

;C3~A1W s&S0确定当前框架是否包含该运行代码。

这对于代理注入代码模式非常有用，这些代码在每个浏览器框架和窗体中运行，有时selenium server需要识别当前是哪个框架。这种情况下，当测试调用selectFrame，该程序将被每个框架调用以指出哪个框架被选择。被选择的框架将返回 true，而其他将返回false。51Testing软件测试网+eR1}m[ O

参数：

    ·currenFrameString – 开始框架

s
?#N*rE0    ·target – 新框架(也许与当前框架相关联)

^WZh@0    ·variableName -用于存储结果的变量名。51Testing软件测试网9w|d3O\$VFk

Returns:51Testing软件测试网-h#v$y,[Jz!t

Ymxh:[9Q4R0  如果新框架为该代码的窗体，返回true

6|E;{+dinE_0同断言相关联，自动生成：51Testing软件测试网0Z3])sz_

    ·assertWhetherThisFrameMatchFrameExpression (currenFrameString, target)

  ·assertNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)51Testing软件测试网 Q}"Jw/?(GN

  ·verifyWhetherThisFrameMatchFrameExpression (currenFrameString, target)51Testing软件测试网k.QOU.e7NI6g RN

&R*p[m!W/N6E&H0  ·verifyNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)51Testing软件测试网3N*V,~T0`/d3ICN

ww
W6ep4T\]0  ·waitForWhetherThisFrameMatchFrameExpression (currenFrameString, target)51Testing软件测试网smEhY

  ·waitForNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)51Testing软件测试网B X@mk[-g!l

storeWhetherThisWindowMatchWindowExpression(currenWindowString,target,variableName)51Testing软件测试网Hql-K/]-tZ

确定当前窗体是否包含该运行代码。51Testing软件测试网2Z9?v1V9Z]i

这对于代理注入代码模式非常有用，这些代码在每个浏览器框架和窗体中运行，有时selenium server需要识别当前是哪个窗体。这种情况下，当测试调用selectWindow，该程序将被每个窗体调用以指出哪个窗体被选择。被选择的窗体将返回true，而其他将返回false。

参数：51Testing软件测试网V$R f/X*U)q%c*^ yI

2v?x\lR,j0    ·currenFrameString – 开始窗体51Testing软件测试网
Y3H"E6IkqcI(P:K6p

N@ L
t|{0Nc0    ·target – 新窗体(也许与当前窗体相关联，如，”_parent”)

A c-K'j9N`0    ·variableName - 用于存储结果的变量名。

|k
MY0G8g;I.s0Returns:51Testing软件测试网o`,}6qt%uG

$IzN[5Z0  如果新窗体为该代码的窗体，返回true

同断言相关联，自动生成：51Testing软件测试网_&B%b(xR8C6s @.O

    ·assertWhetherThisWindowMatchWindowExpression (currenWindowString, target)

+}/Lv*]5wNCe0  ·assertNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)51Testing软件测试网P|D%n/fM2L!Ij(C

  ·verifyWhetherThisWindowMatchWindowExpression (currenWindowString, target)51Testing软件测试网A'R2Z,F-D

5vN+W{K|-P QD0  ·verifyNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·waitForWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·waitForNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)51Testing软件测试网3jn
e`b

storeXpathCount(xpath,variableName)

~j|'k7U }"_0返回匹配指定xpath的节点数，如”//table”将给出表的个数。

GE^"W-`9l-}(s5@0参数：51Testing软件测试网N&OhB2YSmd

·xpath – 要计算的xpath表达式。不要用’count()’函数将该表达式包含起来，我们将自动帮你作这件事。

    ·variableName - 用于存储结果的变量名。51Testing软件测试网 m%Y$W+@W

(eyY
R#t8w0Returns:

  匹配指定xpath的节点数51Testing软件测试网:q4x*Ir,?ZG5|

p/Lv@7pn0同断言相关联，自动生成：

{}u*z)Q8pW0L+?7u0    ·assertXpathCount (xpath, pattern)

7gmzv5HTx6`mYk-z.Y0  ·assertNotXpathCount (xpath, pattern)51Testing软件测试网UVF\;Yb-FNH

3d E xMZ f"B2}b7D:n0  ·verifyXpathCount (xpath, pattern)

j-T$Vm*J&k$O TaE0  ·verifyNotXpathCount (xpath, pattern)51Testing软件测试网 _1Dk0Z,H A(mR

KjL C\,_R0  ·waitForXpathCount (xpath, pattern)

,gx%lM[0  ·waitForNotXpathCount (xpath, pattern)51Testing软件测试网r#lj5}fU

4],g9Fg~c^3GM0storeAlertPresent(variableName)51Testing软件测试网&DW$NI0}

n'r~S3gr/p5Xc@0发生警告了?51Testing软件测试网+v&K#L7uyV ]6a Y6G

该函数永远不会抛出异常51Testing软件测试网D%GpO8cSc

Returns:51Testing软件测试网.d+AN&t;gN?1iM\QP

  如果有警告返回true

q)VHJ_FK0同断言相关联，自动生成：51Testing软件测试网*o;W5u)N+@Uk)b5~;KQ

    ·assertAlertPresent ()

  ·assertNotAlertPresent ()

vR,E1hs0  ·verifyAlertPresent ()51Testing软件测试网"[j3^n*fd{

  ·verifyNotAlertPresent ()51Testing软件测试网%aB{7m ayGK:e
G

)`1P4K.e4E0  ·waitForAlertPresent ()

6?lC&T;FS0  ·waitForNotAlertPresent ()51Testing软件测试网8M#`kVYSr-H9Qb

/Ln
QFfn'tl0storeChecked(locator,variableName)51Testing软件测试网"X2u
a$xfE|5@5nX

获取一个关联性按钮(checkbox/radio)是否被勾选。如果指定元素不存在或不是一个关联性按钮，将失败。

1^tz
M:dt"n)Hc)]0参数：51Testing软件测试网igV)q!u1^U1O

    ·locator– 一个执行checkbox或radio按钮的元素定位器51Testing软件测试网$`S-j'MF6BM X&i

y(mJ j ?_.i,]0    ·variableName - 用于存储结果的变量名。

Returns:

  如果该checkbox被勾选，返回true,否则返回false

同断言相关联，自动生成：51Testing软件测试网7^#r$M7eZ

    ·assertChecked (locator)

7F-jNXD3W$|.n0Hg0  ·assertNotChecked (locator)51Testing软件测试网:C&Rc a(X X

5Y'l^v.ke0  ·verifyChecked (locator)51Testing软件测试网:L6p"T!t@2Y8FU{

-wL$C"v5|#fF&_0  ·verifyNotChecked (locator)

XeGPX:W0  ·waitForChecked (locator)51Testing软件测试网r'D5b!m [ Y3C
J

ot]"VU)?rb,~m)x0  ·waitForNotChecked (locator)

storeConfirmationPresent(variableName)51Testing软件测试网mB6TiA@

H"A/f0LU*[Y)MB Dq0confirm()被调用了？

T@7w$|e fg)uP:h0该函数永远不会抛出异常

Returns:

  如果有一个未决的确认返回true

'i8})qkhL }0同断言相关联，自动生成：51Testing软件测试网v,iQ$pr?(QR%j

    ·assertConfirmationPresent ()51Testing软件测试网q8N#O:q N&O(X h

  ·assertNotConfirmationPresent ()

  ·verifyConfirmationPresent ()51Testing软件测试网 ae4SV:I^A!uq

%Qy2UwAl
n0V%Z0  ·verifyNotConfirmationPresent ()

-f8u#M1?4\"A8h0  ·waitForConfirmationPresent ()51Testing软件测试网-~^` k2@
jj

]q%U(L#D-I:x1N4g)t0  ·waitForNotConfirmationPresent ()51Testing软件测试网f"T,??e gw

Ly$T2Kh9k'c
E0storeEditable(locator,variableName)51Testing软件测试网QH"xkHQ,HY

判定指定的输入元素是否为可编辑，且ie没有被禁用。如果指定元素不为一个可输入元素，该函数将失败。51Testing软件测试网&zyu*~/c2R

\MyK^t^-C%qNm0参数：

    ·locator – 一个元素定位器51Testing软件测试网s]LK2?|`

3D4^,I3ybp0    ·variableName - 用于存储结果的变量名。

U-?^@m7W0Returns:

2z:^ v_l+M:e0  如果输入元素可编辑返回true，否则返回false

d!j#[gQx ca3_/~0同断言相关联，自动生成：

    ·assertEditable (locator)51Testing软件测试网&V_(A+`.Dl+?b

#RF0|]y;_8z/UU0  ·assertNotEditable (locator)51Testing软件测试网}*{eJ&z|(s
`'t

aD;L:a }+p1q0  ·verifyEditable (locator)

lw*y3`
J0  ·verifyNotEditable (locator)

  ·waitForEditable (locator)51Testing软件测试网8IDp!u,G9|c_

jr r)[[0  ·waitForNotEditable (locator)51Testing软件测试网h$]v(d'}.C

9a-R4u8Z9Nv7ttK0storeElementPresent(locator,variableName)

%v Ie"O(_0验证指定元素在页面上。51Testing软件测试网,jV6e|#J7\*^-~,F*Iw

参数：51Testing软件测试网|4QW2a7Z2]#z-zN4uo vd

    ·locator – 一个元素定位器

#Fy:jc4W ]d0    ·variableName - 用于存储结果的变量名。

^ AP }e\'Ai0Returns:51Testing软件测试网%E
Na
H)|T

  如果该元素出现返回true，否则返回false

T%i5iT&[4^#s0同断言相关联，自动生成：51Testing软件测试网8T$v9]m ttN

    ·assertElementPresent (locator)

  ·assertNotElementPresent (locator)51Testing软件测试网)r(K{7EBg_

9|P7Be3]m.v0  ·verifyElementPresent (locator)

S.ZH]%r.Kq9c7T0  ·verifyNotElementPresent (locator)51Testing软件测试网3v5b;s6C.y^!ff}

  ·waitForElementPresent (locator)51Testing软件测试网 m-E.MB&gt"`

~6y[?Q1W8j}0  ·waitForNotElementPresent (locator)51Testing软件测试网S9F:b'dI-P

#ie"j)X(]0storeOrdered(locator1,locator2,variableName)51Testing软件测试网G-t]0HPw3Z

检查这两个元素是否有相同的父级，且在DOM中为顺序亲属。两个相同元素将不考虑顺序。51Testing软件测试网UISiM#^d'x

rI3JlJn#m
q0参数：

|5@ g
bP+J\)}(|}0    ·locator1 – 指向第一个元素的元素定位器

    ·locator2 – 指向第�