38

我目前有很多情况需要验证页面(及其所有元素)是否正确显示。WebElement的isDisplayed()方法似乎是执行此操作的合乎逻辑的方法,但是我想准确了解此方法在确定是否“显示”元素时所做的工作。javadoc没有阐明该方法的内部工作原理,并且网络上的其他信息充其量似乎是稀疏的。

如果有人能详细说明这种方法的工作原理,我将不胜感激。

4

3 回答 3

34

我相信 Selenium 可以确定一个元素是否显示。如果它不起作用,您可以提出错误和/或修复您看到的任何问题并提供补丁。

这就是该方法的作用(取自当前的Selenium 源代码):

/**
 * Determines whether an element is what a user would call "shown". This means
 * that the element is shown in the viewport of the browser, and only has
 * height and width greater than 0px, and that its visibility is not "hidden"
 * and its display property is not "none".
 * Options and Optgroup elements are treated as special cases: they are
 * considered shown iff they have a enclosing select element that is shown.
 *
 * @param {!Element} elem The element to consider.
 * @param {boolean=} opt_ignoreOpacity Whether to ignore the element's opacity
 *     when determining whether it is shown; defaults to false.
 * @return {boolean} Whether or not the element is visible.
 */
bot.dom.isShown = function(elem, opt_ignoreOpacity) {
  if (!bot.dom.isElement(elem)) {
    throw new Error('Argument to isShown must be of type Element');
  }

  // Option or optgroup is shown iff enclosing select is shown (ignoring the
  // select's opacity).
  if (bot.dom.isElement(elem, goog.dom.TagName.OPTION) ||
      bot.dom.isElement(elem, goog.dom.TagName.OPTGROUP)) {
    var select = /**@type {Element}*/ (goog.dom.getAncestor(elem, function(e) {
      return bot.dom.isElement(e, goog.dom.TagName.SELECT);
    }));
    return !!select && bot.dom.isShown(select, /*ignoreOpacity=*/true);
  }

  // Image map elements are shown if image that uses it is shown, and
  // the area of the element is positive.
  var imageMap = bot.dom.maybeFindImageMap_(elem);
  if (imageMap) {
    return !!imageMap.image &&
           imageMap.rect.width > 0 && imageMap.rect.height > 0 &&
           bot.dom.isShown(imageMap.image, opt_ignoreOpacity);
  }

  // Any hidden input is not shown.
  if (bot.dom.isElement(elem, goog.dom.TagName.INPUT) &&
      elem.type.toLowerCase() == 'hidden') {
    return false;
  }

  // Any NOSCRIPT element is not shown.
  if (bot.dom.isElement(elem, goog.dom.TagName.NOSCRIPT)) {
    return false;
  }

  // Any element with hidden visibility is not shown.
  if (bot.dom.getEffectiveStyle(elem, 'visibility') == 'hidden') {
    return false;
  }

  // Any element with a display style equal to 'none' or that has an ancestor
  // with display style equal to 'none' is not shown.
  function displayed(e) {
    if (bot.dom.getEffectiveStyle(e, 'display') == 'none') {
      return false;
    }
    var parent = bot.dom.getParentElement(e);
    return !parent || displayed(parent);
  }
  if (!displayed(elem)) {
    return false;
  }

  // Any transparent element is not shown.
  if (!opt_ignoreOpacity && bot.dom.getOpacity(elem) == 0) {
    return false;
  }

  // Any element with the hidden attribute or has an ancestor with the hidden
  // attribute is not shown
  function isHidden(e) {
    //IE does not support hidden attribute yet
    if (goog.userAgent.IE) {
      return true;
    }
    if (e.hasAttribute) {
      if (e.hasAttribute('hidden')){
        return false;
      }
    } else {
      return true;
    }
    var parent = bot.dom.getParentElement(e);
    return !parent || isHidden(parent);
  }

  if (!isHidden(elem)) {
    return false;
  }

  // Any element without positive size dimensions is not shown.
  function positiveSize(e) {
    var rect = bot.dom.getClientRect(e);
    if (rect.height > 0 && rect.width > 0) {
      return true;
    }
    // A vertical or horizontal SVG Path element will report zero width or
    // height but is "shown" if it has a positive stroke-width.
    if (bot.dom.isElement(e, 'PATH') && (rect.height > 0 || rect.width > 0)) {
      var strokeWidth = bot.dom.getEffectiveStyle(e, 'stroke-width');
      return !!strokeWidth && (parseInt(strokeWidth, 10) > 0);
    }
    // Zero-sized elements should still be considered to have positive size
    // if they have a child element or text node with positive size, unless
    // the element has an 'overflow' style of 'hidden'.
    return bot.dom.getEffectiveStyle(e, 'overflow') != 'hidden' &&
        goog.array.some(e.childNodes, function(n) {
          return n.nodeType == goog.dom.NodeType.TEXT ||
                 (bot.dom.isElement(n) && positiveSize(n));
        });
  }
  if (!positiveSize(elem)) {
    return false;
  }

  // Elements that are hidden by overflow are not shown.
  if (bot.dom.getOverflowState(elem) == bot.dom.OverflowState.HIDDEN) {
    return false;
  }

不确定它是否真的需要更多解释,评论很清楚。如果您想添加更多信息,请告诉我。

于 2013-08-06T11:09:13.120 回答
27

WebDriver 有自己的W3C 规范

关于确定可见性的部分是您所追求的。

我会警告说,“显示”是一个如此广泛的术语,因此它有很多场景。因此,很可能存在 WebDriver 不考虑的情况。

因此,重要的是,事实上至关重要的是,要记住被“展示”或“可见”的东西有很多含义。(同理一个页面满载,也有很多含义。)

还要记住 Selenium 是完全开源的。没有什么能阻止您重新签出存储库并在本地检查它。

于 2013-08-05T15:55:10.927 回答
0

根据文档 isDisplayed()方法确定是否显示WebElement并返回boolean是否显示元素。这种方法避免了必须解析元素style属性的问题。

此实现符合WebDriver Level 2 W3C 工作草案中的规范,其中提到:

尽管 WebDriver 没有定义一个原语来确定 元素视口中的可见性,但我们承认它对许多用户来说是一个重要的特性。在这里,我们提供了一种推荐的方法,它将给出元素可见性的简化近似值,但请注意,它仅依赖于树遍历,并且仅涵盖可见性检查的子集。

元素的可见性由人眼感知可见的内容引导。在这种情况下,元素的显示性与 可见性显示样式属性无关。

推荐给实现者确定元素可见性的方法最初是由 Selenium 项目开发的,它基于对元素在树中的性质和关系的粗略近似。如果元素的任何部分在视口边界内的画布上绘制,则通常认为元素是可见的。

元素显示算法是一个布尔状态,true 表示元素显示,false表示元素不显示。要计算元素的状态,请调用 Call(bot.dom.isShown, null, element). 如果这样做不会产生错误,则返回此函数调用的返回值。否则返回错误代码未知错误。

此函数通常暴露给GET具有以下 URI 模板的请求:

/session/{session id}/element/{element id}/displayed
于 2021-01-13T12:28:48.800 回答