Method FindElements

dotnet/src/webdriver/RelativeBy.cs:87–118

Finds all elements matching the criteria. An object to use to search for the elements. A of all WebElements matching the current criteria, or an empty list if nothing matches. If <paramref name="cont

(ISearchContext context)

    /// matching the current criteria, or an empty list if nothing matches.</returns>
    /// <exception cref="ArgumentException">If <paramref name="context"/> is not <see cref="IJavaScriptExecutor"/> or wraps a driver that does.</exception>
    public override ReadOnlyCollection<IWebElement> FindElements(ISearchContext context)
    {
        IJavaScriptExecutor js = GetExecutor(context);
        Dictionary<string, object> parameters = new Dictionary<string, object>();
        Dictionary<string, object> filterParameters = new Dictionary<string, object>();
        filterParameters["root"] = GetSerializableObject(this.root);
        filterParameters["filters"] = this.filters;
        parameters["relative"] = filterParameters;
        object? rawElements = js.ExecuteScript(wrappedAtom, parameters);

        if (rawElements is ReadOnlyCollection<IWebElement> elements)
        {
            return elements;
        }

        // De-serializer quirk - if the response is empty then the de-serializer will not know we're getting back elements
        // We will have a ReadOnlyCollection<object>

        if (rawElements is ReadOnlyCollection<object> elementsObj)
        {
            if (elementsObj.Count == 0)
            {
#if NET8_0_OR_GREATER
                return ReadOnlyCollection<IWebElement>.Empty;
#else
                return new List<IWebElement>().AsReadOnly();
#endif
            }
        }

        throw new WebDriverException($"Could not de-serialize element list response{Environment.NewLine}{rawElements}");
    }

    /// <summary>
    /// Locates an element above the specified element.