/// <summary>
/// The <see cref="IWebElement" />'s given attribute should meet the given condition.
/// </summary>
/// <param name="searchContext">The <see cref="ISearchContext" /> within we search for the element.</param>
/// <param name="locator">
/// <inheritdoc cref="ISearchContext.FindElement(By)" />
/// </param>
/// <param name="attributeName">The attribute's name of the <see cref="IWebElement" />.</param>
/// <param name="condition">The <see cref="Func{T,TResult}" />, that defines the condition until the browser must wait.</param>
/// <exception cref="ArgumentNullException"></exception>
/// <exception cref="NoSuchElementException"></exception>
/// <exception cref="StaleElementReferenceException"></exception>
/// <exception cref="WebDriverException"></exception>
public static Func <IWebDriver, TResult> ElementAttribute <TResult>(
[NotNull] ISearchContext searchContext,
[NotNull] By locator,
[NotNull] ElementAttributeName attributeName,
[NotNull] Func <string, TResult> condition)
{
if (searchContext == null)
{
throw new ArgumentNullException(nameof(searchContext));
}
if (locator == null)
{
throw new ArgumentNullException(nameof(locator));
}
if (attributeName == null)
{
throw new ArgumentNullException(nameof(attributeName));
}
if (condition == null)
{
throw new ArgumentNullException(nameof(condition));
}
return(driver => condition(searchContext.FindElement(locator).Attributes().Get(attributeName)));
}
/// <summary>
/// Waits, until the <see cref="IWebElement" />'s given attribute 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="attributeName">The attribute's name of the <see cref="IWebElement" />.</param>
/// <param name="condition">
/// The <see cref="Func{T,TResult}" />, that defines the condition until the browser must
/// wait.
/// </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="StaleElementReferenceException"></exception>
public static TResult UntilElementAttribute <TResult>([NotNull] this WebDriverWait wait,
[NotNull] ISearchContext searchContext,
[NotNull] By locator, [NotNull] ElementAttributeName attributeName,
[NotNull] Func <string, 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 (attributeName == null)
{
throw new ArgumentNullException(nameof(attributeName));
}
if (condition == null)
{
throw new ArgumentNullException(nameof(condition));
}
return(wait.UntilElementAttribute(searchContext, locator, attributeName.AttributeName, condition));
}
/// <summary>
/// The <see cref="IWebElement" />'s given attribute should meet the given condition.
/// </summary>
/// <param name="element">The HTMLElement, that is represented by an <see cref="IWebElement" /> instance.</param>
/// <param name="attributeName">The attribute's name of the <see cref="IWebElement" />.</param>
/// <param name="condition">The <see cref="Func{T,TResult}" />, that defines the condition until the browser must wait.</param>
/// <exception cref="ArgumentNullException"></exception>
/// <exception cref="StaleElementReferenceException"></exception>
/// <exception cref="WebDriverException"></exception>
public static Func <IWebDriver, TResult> ElementAttribute <TResult>(
[NotNull] IWebElement element,
[NotNull] ElementAttributeName attributeName,
[NotNull] Func <string, TResult> condition)
{
if (element == null)
{
throw new ArgumentNullException(nameof(element));
}
if (attributeName == null)
{
throw new ArgumentNullException(nameof(attributeName));
}
if (condition == null)
{
throw new ArgumentNullException(nameof(condition));
}
return(driver => condition(element.Attributes().Get(attributeName)));
}
/// <summary>
/// Waits, until the <see cref="IWebElement" />'s given attribute 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="attributeName">The attribute's name of the <see cref="IWebElement" />.</param>
/// <param name="condition">
/// The <see cref="Func{T,TResult}" />, that defines the condition until the browser must
/// wait.
/// </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 UntilElementAttribute <TResult>([NotNull] this WebDriverWait wait,
[NotNull] IWebElement element,
[NotNull] ElementAttributeName attributeName, [NotNull] Func <string, TResult> condition)
{
if (wait == null)
{
throw new ArgumentNullException(nameof(wait));
}
if (element == null)
{
throw new ArgumentNullException(nameof(element));
}
if (attributeName == null)
{
throw new ArgumentNullException(nameof(attributeName));
}
if (condition == null)
{
throw new ArgumentNullException(nameof(condition));
}
return(wait.UntilElementAttribute(element, attributeName.AttributeName, condition));
}