EmailFieldElement

​

Overview

​

Component Tag

​

Extends

• TextFieldElement

​

Inherited Interfaces

• HasValidationPropertiesElement - Validation state and error messages
• HasInputFieldElement - Value, label, helper text, and styling
• HasPrefixElement - Prefix slot content
• HasSuffixElement - Suffix slot content
• HasClearButtonElement - Clear button functionality
• HasPlaceholderElement - Placeholder text
• HasAllowedCharPatternElement - Character input restrictions
• HasThemeElement - Theme variants
• FocusableElement - Focus and blur operations
• HasAriaLabelElement - ARIA label support
• HasEnabledElement - Enabled/disabled state
• HasTooltipElement - Tooltip text

​

Constructor

public EmailFieldElement(Locator locator)

​

Factory Methods

​

getByLabel (Page)

public static EmailFieldElement getByLabel(Page page, String label)

​

Example

EmailFieldElement emailField = EmailFieldElement.getByLabel(page, "Email");
emailField.setValue("[email protected]");
emailField.assertValid();

​

getByLabel (Locator)

public static EmailFieldElement getByLabel(Locator locator, String label)

​

Inherited Methods

• getMinLength() - Get minimum length
• setMinLength(int min) - Set minimum length
• assertMinLength(Integer min) - Assert minimum length
• getMaxLength() - Get maximum length
• setMaxLength(int max) - Set maximum length
• assertMaxLength(Integer max) - Assert maximum length
• getPattern() - Get validation pattern
• setPattern(String pattern) - Set validation pattern
• assertPattern(String pattern) - Assert validation pattern

• getValue() - Get current value
• setValue(String value) - Set field value
• clear() - Clear the value
• assertValue(String value) - Assert value matches

• assertValid() - Assert field is valid
• assertInvalid() - Assert field is invalid
• assertErrorMessage(String message) - Assert error message text
• getErrorMessageLocator() - Get error message locator

• clickClearButton() - Click the clear button
• isClearButtonVisible() - Check if clear button is visible
• assertClearButtonVisible() - Assert clear button is visible
• assertClearButtonNotVisible() - Assert clear button is not visible

• getPlaceholder() - Get placeholder text
• setPlaceholder(String placeholder) - Set placeholder text
• assertPlaceholder(String placeholder) - Assert placeholder matches

• focus() - Focus the field
• blur() - Blur the field
• getTabIndex() - Get tab index
• assertIsFocused() - Assert field has focus
• assertIsNotFocused() - Assert field does not have focus

• getLabel() - Get label text
• assertLabel(String label) - Assert label text
• getLabelLocator() - Get label locator

• getHelperText() - Get helper text
• assertHelperHasText(String text) - Assert helper text
• getHelperLocator() - Get helper locator

​

Complete Example

@Test
public void testEmailFieldValidation() {
    // Find email field by label
    EmailFieldElement emailField = EmailFieldElement.getByLabel(page, "Validated Email");
    emailField.assertVisible();
    emailField.assertHelperHasText("This field is required.");
    
    // Test invalid email
    emailField.setValue("not-an-email");
    emailField.assertInvalid();
    emailField.assertErrorMessage("Please enter a valid email address");
    
    // Test valid email
    emailField.setValue("[email protected]");
    emailField.assertValid();
    emailField.assertValue("[email protected]");
}

@Test
public void testEmailFieldInteractions() {
    EmailFieldElement emailField = EmailFieldElement.getByLabel(page, "Email");
    emailField.assertVisible();
    
    // Check placeholder and prefix
    emailField.assertPlaceholder("[email protected]");
    emailField.assertPrefixHasText("@");
    
    // Test clear button
    emailField.assertClearButtonNotVisible();
    emailField.setValue("[email protected]");
    emailField.assertClearButtonVisible();
    emailField.clickClearButton();
    emailField.assertValue("");
}