/// <summary>
/// Waits, until the <see cref="IWebElement" />'s given property has met the given condition.
/// <para>Exceptions ignored until timeout: <see cref="StaleElementReferenceException" /></para>
/// </summary>
/// <param name="wait">The <see cref="WebDriverWait" /> instance, that is used to command the browser for wait.</param>
/// <param name="condition">The <see cref="Func{T,TResult}" />, that defines the condition until the browser must wait.</param>
/// <param name="propertyName">The property's name of the <see cref="IWebElement" />.</param>
/// <param name="element">The HTMLElement, that is represented by an <see cref="IWebElement" /> instance.</param>
/// <exception cref="WebDriverTimeoutException"></exception>
/// <exception cref="WebDriverException"></exception>
/// <exception cref="StaleElementReferenceException"></exception>
public static TResult UntilElementProperty <TResult>([NotNull] this WebDriverWait wait,
[NotNull] IWebElement element,
[NotNull] string propertyName, [NotNull] Func <object, TResult> condition)
{
if (wait == null)
{
throw new ArgumentNullException(nameof(wait));
}
if (element == null)
{
throw new ArgumentNullException(nameof(element));
}
if (propertyName == null)
{
throw new ArgumentNullException(nameof(propertyName));
}
if (condition == null)
{
throw new ArgumentNullException(nameof(condition));
}
wait.IgnoreExceptionTypes(typeof(StaleElementReferenceException));
wait.Message += " Waited for " +
$"({element}) element's ({propertyName}) property " +
"to meet the given condition.";
return(wait.Until(WebDriverWaitConditions.ElementProperty(element, propertyName, condition)));
}
/// <summary>
/// Waits, until the <see cref="IWebElement" />'s given property has met the given condition.
/// <para>
/// Exceptions ignored until timeout: <see cref="NoSuchElementException" />,
/// <see cref="StaleElementReferenceException" />
/// </para>
/// </summary>
/// <param name="wait">The <see cref="WebDriverWait" /> instance, that is used to command the browser for wait.</param>
/// <param name="condition">
/// The <see cref="Func{T,TResult}" />, that defines the condition until the browser must
/// wait.
/// </param>
/// <param name="propertyName">The property's name of the <see cref="IWebElement" />.</param>
/// <param name="searchContext">The <see cref="ISearchContext" /> within we search for the element.</param>
/// <param name="locator">
/// <inheritdoc cref="ISearchContext.FindElement(By)" />
/// </param>
/// <exception cref="WebDriverTimeoutException"></exception>
/// <exception cref="NoSuchElementException"></exception>
/// <exception cref="StaleElementReferenceException"></exception>
public static TResult UntilElementProperty <TResult>([NotNull] this WebDriverWait wait,
[NotNull] ISearchContext searchContext,
[NotNull] By locator, [NotNull] string propertyName, [NotNull] Func <object, TResult> condition)
{
if (wait == null)
{
throw new ArgumentNullException(nameof(wait));
}
if (searchContext == null)
{
throw new ArgumentNullException(nameof(searchContext));
}
if (locator == null)
{
throw new ArgumentNullException(nameof(locator));
}
if (propertyName == null)
{
throw new ArgumentNullException(nameof(propertyName));
}
if (condition == null)
{
throw new ArgumentNullException(nameof(condition));
}
wait.IgnoreExceptionTypes(typeof(NoSuchElementException), typeof(StaleElementReferenceException));
wait.Message += " Waited for " +
$"element's ({propertyName}) property " +
"to meet the given condition.";
return(wait.Until(WebDriverWaitConditions.ElementProperty(searchContext, locator, propertyName, condition)));
}
