Library

Selector

Selector

Exact Match Filters

Methods that filter found elements by requiring an exact match on a specific property - text content, value, attribute, href, src, or placeholder.

Methods that filter found elements by requiring an exact match on a specific property - text content, value, attribute, href, src, or placeholder.

Match methods narrow the set of elements returned by the primary locator (CSS, XPath, etc.). MatchText requires the element's visible text to equal the provided string exactly. MatchValue requires the element's value attribute to match. MatchAttribute requires a specific attribute to match. MatchHRef requires the href attribute to match. MatchSrc requires the src attribute to match. MatchPlaceholder requires the placeholder attribute to match. All comparisons are case-sensitive by default.

TIP

Match methods require the full value to equal the filter string exactly. Use the Contains variants (ContainsText, ContainsAttribute, etc.) when you only know part of the value.

Examples

GPAL Fluent: High-level fluent C# API

//Multiple Match methods can be chained on a single selector - all conditions must be satisfied for an element to pass. Match methods are applied after the primary locator finds its initial candidate set.

// Find the exact 'Submit' link (not 'Submit Form' or 'Submit Order') var exactLink = GPAL.Selector .WithCSS("a") .MatchText("Submit"); // Match by attribute value var specificInput = GPAL.Selector .WithCSS("input") .MatchAttribute("data-type=email"); // Match by href (find a specific link) var docLink = GPAL.Selector .WithCSS("a") .MatchHRef("/documentation");

On this page

Selector
Exact Match Filters
  • Examples