IntegerFieldElement

Playwright element wrapper for Vaadin integer fields

Overview

The IntegerFieldElement class is a Playwright wrapper for the <vaadin-integer-field> component. It provides methods to interact with integer input fields, including min/max/step constraints and step controls.

Component Tag

<vaadin-integer-field>

Extends

• AbstractNumberFieldElement

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

locator · Locator · required

The Playwright locator for the <vaadin-integer-field> element

public IntegerFieldElement(Locator locator)

Factory Methods

getByLabel (Page)

Get an integer field by its accessible label. Uses ARIA role spinbutton.

page · Page · required

The Playwright page

label · String · required

The accessible label of the integer field

public static IntegerFieldElement getByLabel(Page page, String label)

Example

IntegerFieldElement integerField = IntegerFieldElement.getByLabel(page, "Quantity");
integerField.setValue("123");
integerField.assertValue("123");

getByLabel (Locator)

Get an integer field by its accessible label within a scope.

locator · Locator · required

The locator to search within

label · String · required

The accessible label of the integer field

public static IntegerFieldElement getByLabel(Locator locator, String label)

Methods

getStep

Get the current step value.

public Integer getStep()

Returns: The step as an Integer, or null if not set

setStep

Set the step value.

step · int · required

The step to apply

public void setStep(int step)

assertStep

Assert the step attribute matches the expected value.

step · Integer

The expected step, or null to assert no explicit step is set

public void assertStep(Integer step)

getMin

Get the current minimum value.

public Integer getMin()

Returns: The minimum as an Integer, or null if not set

setMin

Set the minimum value.

min · int · required

The minimum to apply

public void setMin(int min)

assertMin

Assert the min attribute matches the expected value.

min · Integer

The expected minimum, or null to assert no explicit minimum is set

public void assertMin(Integer min)

getMax

Get the current maximum value.

public Integer getMax()

Returns: The maximum as an Integer, or null if not set

setMax

Set the maximum value.

max · int · required

The maximum to apply

public void setMax(int max)

assertMax

Assert the max attribute matches the expected value.

max · Integer

The expected maximum, or null to assert no explicit maximum is set

public void assertMax(Integer max)

Inherited Methods

From AbstractNumberFieldElement:

• getHasControls() - Check if step controls are visible
• assertHasControls(boolean hasControls) - Assert step controls visibility
• clickIncreaseButton() - Click the increase button
• clickDecreaseButton() - Click the decrease button

From HasValueElement:

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

From HasValidationPropertiesElement:

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

From FocusableElement:

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

Complete Example

@Test
public void testIntegerFieldMinMaxStep() {
    // Find integer field by label
    IntegerFieldElement integerField = IntegerFieldElement.getByLabel(page, "Score");
    integerField.assertVisible();
    
    // Check constraints
    integerField.assertMin(0);
    integerField.assertMax(100);
    integerField.assertStep(10);
    
    // Check initial value
    integerField.assertValue("10");
    
    // Test valid value
    integerField.setValue("50");
    integerField.assertValue("50");
    integerField.assertValid();
    
    // Test out of bounds value
    integerField.setValue("110");
    integerField.assertInvalid();
    
    // Test minimum violation
    integerField.setValue("-10");
    integerField.assertInvalid();
}

@Test
public void testIntegerFieldStepControls() {
    IntegerFieldElement integerField = IntegerFieldElement.getByLabel(page, "With Controls");
    integerField.assertVisible();
    integerField.assertHasControls(true);
    
    // Test increment
    integerField.assertValue("");
    integerField.clickIncreaseButton();
    integerField.assertValue("1");
    integerField.clickIncreaseButton();
    integerField.assertValue("2");
    
    // Test decrement
    integerField.clickDecreaseButton();
    integerField.assertValue("1");
}