Selenium定位元素

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


     

   selenium.Click("id=login");

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

    open /mypage
     
    open    http://localhost/
     

   selenium.Open("/");

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

    type nameField    John Smith
    typeAndWait  textBoxThatSubmitsOnChange    newValue

selenium.Type("id=UserName", userName);

  • 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()
    模拟点击浏览器的后退按钮

   selenium.GoBack();

  • close()
    模拟点击浏览器关闭按钮

selenium.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(.{}[email protected],variableName.{)
    把指定元素的属性的值赋予给变量

    storeAttribute [email protected]  classOfInput1
    verifyAttribute [email protected] $.{classOfInput1}

storeAttribute  target: aa@bb存储元素  value: 变量    存储aa的bb值到变量中

String taskName = selenium.GetAttribute("[email protected]");
Console.WriteLine(taskName);

将id为minblogBody的defvalue值存储到taskName中,并打印taskName

storteText  

target://*[@id=‘ul_80185794-3209-4e6b-8cea-af39348c5cdd‘]/li[1]/span[6]/a[1]

value:bind

echo

${bind}

将路径为target里的值保存在bind变量中,并输出bind的值。

  • 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
     

selenium.IsTextPresent("beisen:分享测试01")

  • assertAttribute(.{}[email protected]{, ValuePattern)
    检查当前指定元素的属性的值

    verifyAttribute [email protected] 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()}

      来源: <http://sariyalee.iteye.com/blog/1743350>

时间: 2024-10-31 09:44:51

Selenium定位元素的相关文章

[Python 应用: 爬虫] Selenium 定位元素方法

本文内容摘自:https://selenium-python.readthedocs.io/locating-elements.html 定位元素有很多种方式,你可以选择适合你使用情况的.Selenium 提供如下几种定位元素的方式: find_element_by_id find_element_by_name find_element_by_xpath find_element_by_link_text find_element_by_partial_link_text find_eleme

selenium 定位元素

findElement()方法:当开始寻找符合指定条件的元素时,它将查询整个DOM,然后返回第一个找到的匹配元素. By id:通过元素ID属性定位元素//driver.findElement(By.id("XXXX")); By name: 通过元素Name属性定位元素//driver,findElement(By.name("XXXX")); By className:通过元素classname属性定位元素//driver.findElement(By.clas

python+selenium 定位元素

一.安装python1.配置环境变量c:\python27:C:\Python27\Scripts2.验证pyton是否可用,在cmd里面输入python没报错就行 二.安装selenium库4.安装selenium:在cmd里面,输入:pip install selenium 三.对应于webdriver中的定位方法分别是: driver.find_element_by_name()--最常用,简单 driver.find_element_by_id()--最常用,简单 driver.find

Selenium 定位元素的8种方法介绍

简介 我们在做web自动化测试时,最根本的就是操作页面上的元素,首先我们要能找到这些元素,然后才能操作这些元素.工具或代码无法像我们测试人员一样用肉眼来分辨页面上的元素.所以我们依据元素来定位它们. 一.查看页面元素 用谷歌浏览器打开百度首页(按键F12),或者点击右上角>更多工具>开发者工具,就可以看到整个页面的html代码了 二.方法介绍 1.id定位: find_element_by_id() from selenium import webdriverimport timedriver

selenium 定位元素方式大全

starts-with 顾名思义,匹配一个属性开始位置的关键字 contains 匹配一个属性值中包含的字符串 text() 匹配的是显示文本信息,此处也可以用来做定位用 eg //input[starts-with(@name,'name1')]     查找name属性中开始位置包含'name1'关键字的页面元素 //input[contains(@name,'na')]         查找name属性中包含na关键字的页面元素 <a href="http://www.baidu.c

selenium定位元素的八种方法

web driver提供了八种元素定位的方法: id, name, class name, tag name, link text, partial link text, xpath, css selector 如百度首页,百度一下按钮的元素信息 <input type="submit" id="su" value="百度一下" class="bg s_btn"> 百度首页新闻的页面的元素信息 <a href

selenium定位元素提示‘元素不可见’问题解决方法

最近在使用selenium的过程中发现有元素能够在页面中查找到,但是pycharm中运行时始终报错element not visible,于是使用如下方法成功解决问题. 1.driver.find_element_by_xpath("").is_displayed() 首先使用is_displayed()方法查看这个元素,发现返回的是False,说明该元素不可见.2.浏览器中查看到该元素没有什么不可见的属性,那么再往上找,发现父元素中有一个dispaly:none.3.通过js语句修改

pythonGUI自动化:selenium定位元素方式及元素动作

单个元素 1. 通过id定位:wd.find_element_by_id() 2. 通过name定位:wd.find_element_by_name() 3. 通过class定位:wd.find_element_by_class_name() 4. 通过tag定位:wd.find_element_by_tag_name() 5. 通过link定位:wd.find_element_by_link_text() 6. 通过partial_link定位:wd.find_element_by_parti

Selenium定位不到指定元素原因之iframe(unable to locate element)

浏览过程中,图片中的内容可能太小,无法看清,可以>右键>在新标签中打开 Outline 项目原因,需要用selenium实现模拟登陆.模拟上传文件,自然就需要模拟点击[上传]按钮: 模拟点击之前需要通过selenium提供的“方法”去定位到要点击的元素: 模拟登陆过程中,全程都可以定位到需要点击的元素,但登陆后需要定位点击[上传]按钮时问题来了: 元素明明在那放着,就是定位不到,这个问题困扰了一下午还没解决,最终走到了iframe这个一步,才得以解决. 什么是iframe 解决问题之前很有必要