我目前有很多情况需要验证页面(及其所有元素)是否正确显示。WebElement的isDisplayed()
方法似乎是执行此操作的合乎逻辑的方法,但是我想准确了解此方法在确定是否“显示”元素时所做的工作。javadoc没有阐明该方法的内部工作原理,并且网络上的其他信息充其量似乎是稀疏的。
如果有人能详细说明这种方法的工作原理,我将不胜感激。
我目前有很多情况需要验证页面(及其所有元素)是否正确显示。WebElement的isDisplayed()
方法似乎是执行此操作的合乎逻辑的方法,但是我想准确了解此方法在确定是否“显示”元素时所做的工作。javadoc没有阐明该方法的内部工作原理,并且网络上的其他信息充其量似乎是稀疏的。
如果有人能详细说明这种方法的工作原理,我将不胜感激。
我相信 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;
}
不确定它是否真的需要更多解释,评论很清楚。如果您想添加更多信息,请告诉我。
根据文档 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