Package com.vaadin.flow.component.datepicker

Class DatePickerTester

  • All Implemented Interfaces:
    com.vaadin.browserless.Clickable 
    
public class DatePickerTester<T extends DatePicker>
extends ComponentTester<T>

    Tester for the DatePicker components.

    Since:

    1.0

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description

    • Field Summary

      Fields 
      Modifier and Type Field Description
      public final T component

    • Constructor Summary

      Constructors 
      Constructor Description
      DatePickerTester(T component) Wrap given component for testing.

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description

    • Method Summary

      Modifier and Type Method Description
      void setValue(LocalDate date) Set the given date as value to the component, as the user would enter it.
      boolean isValid() Checks whether the field is currently valid, applying the same constraints as the component itself — required, min and max — and honouring an invalid state set from the outside, as a com.vaadin.flow.data.binder.Binder or a custom validator does.
      void clear() Empties the field, as when the user deletes its contents (or clicks the clear button, where one is shown).
      void clickClearButton() Empties the field by clicking its clear button, as the user would.

      • Methods inherited from class com.vaadin.browserless.ComponentTester

        blur, ensureComponentIsUsable, find, focus, getComponent, isFocused, isUsable, setModal

      • Methods inherited from class com.vaadin.browserless.Clickable

        click, click, click, middleClick, middleClick, rightClick, rightClick

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • DatePickerTester

        DatePickerTester(T component)

        Wrap given component for testing.

        Parameters:
        component - target component

    • Method Detail

      • setValue

         void setValue(LocalDate date)

        Set the given date as value to the component, as the user would enter it.

        A date that violates the component's constraints — outside min - max, or the empty value on a required field — is committed all the same, because the browser commits it too and simply leaves the field invalid. Assert that outcome with isValid instead of expecting this method to throw.
        Parameters:
        date - date to set to the component

      • isValid

         boolean isValid()

        Checks whether the field is currently valid, applying the same constraints as the component itself — required, min and max — and honouring an invalid state set from the outside, as a com.vaadin.flow.data.binder.Binder or a custom validator does.

        A field can hold a value that does not satisfy its constraints — the user can type one, setValue commits it as the browser does, and the value can also be set on the server — so a test asserting on validation state checks this instead of expecting a value to be refused.

        Returns:

        true if the field is not marked invalid and its current value satisfies the constraints of the field

        Since:

        25.3

      • clear

         void clear()

        Empties the field, as when the user deletes its contents (or clicks the clear button, where one is shown).

        Emptying is something the user can always do, so it needs no clear button: a field may legitimately end up invalid — a required field, for instance — once emptied.
        Since:

        25.3

      • clickClearButton

         void clickClearButton()

        Empties the field by clicking its clear button, as the user would.

        Unlike clear, which models selecting the contents and deleting them and is therefore always available, this requires the clear button to be visible — a hidden clear button is not something the user can click.
        Since:

        25.3