equalTo

equalTo is a common name for a matcher or predicate used in testing frameworks to verify that a value is equal to a specified target. It relies on the language’s defined notion of equality, typically using the object’s equality method (for example, equals in Java or eq in Python). The purpose is to express assertions in a readable, declarative style.

In Java with Hamcrest, equalTo is used as a matcher within assertion statements. For example: assertThat(actual, equalTo(expected)); or assertThat(actual, is(equalTo(expected))); This form separates the assertion logic from the comparison and improves error messages when a test fails.

In Python with PyHamcrest, the corresponding matcher is equal_to. Example: assert_that(actual, equal_to(expected)). Other languages and libraries often provide similar matchers under slightly varied names, such as equal_to or Is.EqualTo.

Key considerations include the distinction between equality and identity. equalTo checks that two values are equal according to the language’s equality semantics, not that two references point to the same object. For identity testing, frameworks typically provide different matchers (for example, is_same_as or identical_to). For floating-point comparisons, many libraries offer a tolerance-based matcher (such as close_to) because exact equality is frequently unreliable due to rounding errors.

See also: equal, is, isNot, closeTo, isSameAs.