Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

assertions

package

Go to main page

Versions in this module

v2

v2.2.0

Jan 24, 2026

Changes in this version

+ func DirNotExists(t T, path string, msgAndArgs ...any) bool

+ func ElementsMatchT[E comparable](t T, listA, listB []E, msgAndArgs ...any) bool

+ func EqualT[V comparable](t T, expected, actual V, msgAndArgs ...any) bool

+ func FalseT[B Boolean](t T, value B, msgAndArgs ...any) bool

+ func FileNotExists(t T, path string, msgAndArgs ...any) bool

+ func GreaterOrEqualT[Orderable Ordered](t T, e1, e2 Orderable, msgAndArgs ...any) bool

+ func GreaterT[Orderable Ordered](t T, e1, e2 Orderable, msgAndArgs ...any) bool

+ func InDeltaT[Number Measurable](t T, expected, actual, delta Number, msgAndArgs ...any) bool

+ func InEpsilonT[Number Measurable](t T, expected, actual Number, epsilon float64, msgAndArgs ...any) bool

+ func IsDecreasingT[OrderedSlice ~[]E, E Ordered](t T, collection OrderedSlice, msgAndArgs ...any) bool

+ func IsIncreasingT[OrderedSlice ~[]E, E Ordered](t T, collection OrderedSlice, msgAndArgs ...any) bool

+ func IsNonDecreasingT[OrderedSlice ~[]E, E Ordered](t T, collection OrderedSlice, msgAndArgs ...any) bool

+ func IsNonIncreasingT[OrderedSlice ~[]E, E Ordered](t T, collection OrderedSlice, msgAndArgs ...any) bool

+ func IsNotOfTypeT[EType any](t T, object any, msgAndArgs ...any) bool

+ func IsOfTypeT[EType any](t T, object any, msgAndArgs ...any) bool

+ func JSONEqT[EDoc, ADoc Text](t T, expected EDoc, actual ADoc, msgAndArgs ...any) bool

+ func Kind(t T, expectedKind reflect.Kind, object any, msgAndArgs ...any) bool

+ func LessOrEqualT[Orderable Ordered](t T, e1, e2 Orderable, msgAndArgs ...any) bool

+ func LessT[Orderable Ordered](t T, e1, e2 Orderable, msgAndArgs ...any) bool

+ func MapContainsT[Map ~map[K]V, K comparable, V any](t T, m Map, key K, msgAndArgs ...any) bool

+ func MapNotContainsT[Map ~map[K]V, K comparable, V any](t T, m Map, key K, msgAndArgs ...any) bool

+ func NegativeT[SignedNumber SignedNumeric](t T, e SignedNumber, msgAndArgs ...any) bool

+ func NotElementsMatchT[E comparable](t T, listA, listB []E, msgAndArgs ...any) (ok bool)

+ func NotEqualT[V comparable](t T, expected, actual V, msgAndArgs ...any) bool

+ func NotKind(t T, expectedKind reflect.Kind, object any, msgAndArgs ...any) bool

+ func NotRegexpT[Rex RegExp, ADoc Text](t T, rx Rex, actual ADoc, msgAndArgs ...any) bool

+ func NotSameT[P any](t T, expected, actual *P, msgAndArgs ...any) bool

+ func NotSortedT[OrderedSlice ~[]E, E Ordered](t T, collection OrderedSlice, msgAndArgs ...any) bool

+ func PositiveT[SignedNumber SignedNumeric](t T, e SignedNumber, msgAndArgs ...any) bool

+ func RegexpT[Rex RegExp, ADoc Text](t T, rx Rex, actual ADoc, msgAndArgs ...any) bool

+ func SameT[P any](t T, expected, actual *P, msgAndArgs ...any) bool

+ func SeqContainsT[E comparable](t T, iter iter.Seq[E], element E, msgAndArgs ...any) bool

+ func SeqNotContainsT[E comparable](t T, iter iter.Seq[E], element E, msgAndArgs ...any) bool

+ func SliceContainsT[Slice ~[]E, E comparable](t T, s Slice, element E, msgAndArgs ...any) bool

+ func SliceNotContainsT[Slice ~[]E, E comparable](t T, s Slice, element E, msgAndArgs ...any) bool

+ func SliceNotSubsetT[Slice ~[]E, E comparable](t T, list, subset Slice, msgAndArgs ...any) (ok bool)

+ func SliceSubsetT[Slice ~[]E, E comparable](t T, list, subset Slice, msgAndArgs ...any) (ok bool)

+ func SortedT[OrderedSlice ~[]E, E Ordered](t T, collection OrderedSlice, msgAndArgs ...any) bool

+ func StringContainsT[ADoc, EDoc Text](t T, str ADoc, substring EDoc, msgAndArgs ...any) bool

+ func StringNotContainsT[ADoc, EDoc Text](t T, str ADoc, substring EDoc, msgAndArgs ...any) bool

+ func TrueT[B Boolean](t T, value B, msgAndArgs ...any) bool

+ func YAMLEqBytes(t T, expected, actual []byte, msgAndArgs ...any) bool

+ func YAMLEqT[EDoc, ADoc Text](t T, expected EDoc, actual ADoc, msgAndArgs ...any) bool

+ type Boolean interface

+ type Measurable interface

+ type Ordered interface

+ type RegExp interface

+ type SignedNumeric interface

+ type Text interface

+ type UnsignedNumeric interface

v2.1.8

Jan 3, 2026

v2.1.7

Jan 3, 2026

v2.1.6

Jan 3, 2026

v2.1.5

Jan 3, 2026

v2.1.4

Jan 3, 2026

v2.1.3

Jan 3, 2026

v2.1.2

Jan 3, 2026

v2.1.1

Jan 2, 2026

v2.1.0

Jan 2, 2026

Changes in this version

+ var ErrTest = errors.New("assert.ErrTest general error for testing")

+ func CallerInfo() []string

+ func Condition(t T, comp Comparison, msgAndArgs ...any) bool

+ func Contains(t T, s, contains any, msgAndArgs ...any) bool

+ func DirExists(t T, path string, msgAndArgs ...any) bool

+ func ElementsMatch(t T, listA, listB any, msgAndArgs ...any) (ok bool)

+ func Empty(t T, object any, msgAndArgs ...any) bool

+ func Equal(t T, expected, actual any, msgAndArgs ...any) bool

+ func EqualError(t T, theError error, errString string, msgAndArgs ...any) bool

+ func EqualExportedValues(t T, expected, actual any, msgAndArgs ...any) bool

+ func EqualValues(t T, expected, actual any, msgAndArgs ...any) bool

+ func Error(t T, err error, msgAndArgs ...any) bool

+ func ErrorAs(t T, err error, target any, msgAndArgs ...any) bool

+ func ErrorContains(t T, theError error, contains string, msgAndArgs ...any) bool

+ func ErrorIs(t T, err, target error, msgAndArgs ...any) bool

+ func Eventually(t T, condition func() bool, waitFor time.Duration, tick time.Duration, ...) bool

+ func EventuallyWithT(t T, condition func(collect *CollectT), waitFor time.Duration, ...) bool

+ func Exactly(t T, expected, actual any, msgAndArgs ...any) bool

+ func Fail(t T, failureMessage string, msgAndArgs ...any) bool

+ func FailNow(t T, failureMessage string, msgAndArgs ...any) bool

+ func False(t T, value bool, msgAndArgs ...any) bool

+ func FileEmpty(t T, path string, msgAndArgs ...any) bool

+ func FileExists(t T, path string, msgAndArgs ...any) bool

+ func FileNotEmpty(t T, path string, msgAndArgs ...any) bool

+ func Greater(t T, e1 any, e2 any, msgAndArgs ...any) bool

+ func GreaterOrEqual(t T, e1 any, e2 any, msgAndArgs ...any) bool

+ func HTTPBody(handler http.HandlerFunc, method, url string, values url.Values) string

+ func HTTPBodyContains(t T, handler http.HandlerFunc, method, url string, values url.Values, str any, ...) bool

+ func HTTPBodyNotContains(t T, handler http.HandlerFunc, method, url string, values url.Values, str any, ...) bool

+ func HTTPError(t T, handler http.HandlerFunc, method, url string, values url.Values, ...) bool

+ func HTTPRedirect(t T, handler http.HandlerFunc, method, url string, values url.Values, ...) bool

+ func HTTPStatusCode(t T, handler http.HandlerFunc, method, url string, values url.Values, ...) bool

+ func HTTPSuccess(t T, handler http.HandlerFunc, method, url string, values url.Values, ...) bool

+ func Implements(t T, interfaceObject any, object any, msgAndArgs ...any) bool

+ func InDelta(t T, expected, actual any, delta float64, msgAndArgs ...any) bool

+ func InDeltaMapValues(t T, expected, actual any, delta float64, msgAndArgs ...any) bool

+ func InDeltaSlice(t T, expected, actual any, delta float64, msgAndArgs ...any) bool

+ func InEpsilon(t T, expected, actual any, epsilon float64, msgAndArgs ...any) bool

+ func InEpsilonSlice(t T, expected, actual any, epsilon float64, msgAndArgs ...any) bool

+ func IsDecreasing(t T, object any, msgAndArgs ...any) bool

+ func IsIncreasing(t T, object any, msgAndArgs ...any) bool

+ func IsNonDecreasing(t T, object any, msgAndArgs ...any) bool

+ func IsNonIncreasing(t T, object any, msgAndArgs ...any) bool

+ func IsNotType(t T, theType, object any, msgAndArgs ...any) bool

+ func IsType(t T, expectedType, object any, msgAndArgs ...any) bool

+ func JSONEq(t T, expected, actual string, msgAndArgs ...any) bool

+ func JSONEqBytes(t T, expected, actual []byte, msgAndArgs ...any) bool

+ func Len(t T, object any, length int, msgAndArgs ...any) bool

+ func Less(t T, e1 any, e2 any, msgAndArgs ...any) bool

+ func LessOrEqual(t T, e1 any, e2 any, msgAndArgs ...any) bool

+ func Negative(t T, e any, msgAndArgs ...any) bool

+ func Never(t T, condition func() bool, waitFor time.Duration, tick time.Duration, ...) bool

+ func Nil(t T, object any, msgAndArgs ...any) bool

+ func NoDirExists(t T, path string, msgAndArgs ...any) bool

+ func NoError(t T, err error, msgAndArgs ...any) bool

+ func NoFileExists(t T, path string, msgAndArgs ...any) bool

+ func NotContains(t T, s, contains any, msgAndArgs ...any) bool

+ func NotElementsMatch(t T, listA, listB any, msgAndArgs ...any) (ok bool)

+ func NotEmpty(t T, object any, msgAndArgs ...any) bool

+ func NotEqual(t T, expected, actual any, msgAndArgs ...any) bool

+ func NotEqualValues(t T, expected, actual any, msgAndArgs ...any) bool

+ func NotErrorAs(t T, err error, target any, msgAndArgs ...any) bool

+ func NotErrorIs(t T, err, target error, msgAndArgs ...any) bool

+ func NotImplements(t T, interfaceObject any, object any, msgAndArgs ...any) bool

+ func NotNil(t T, object any, msgAndArgs ...any) bool

+ func NotPanics(t T, f PanicTestFunc, msgAndArgs ...any) bool

+ func NotRegexp(t T, rx any, str any, msgAndArgs ...any) bool

+ func NotSame(t T, expected, actual any, msgAndArgs ...any) bool

+ func NotSubset(t T, list, subset any, msgAndArgs ...any) (ok bool)

+ func NotZero(t T, i any, msgAndArgs ...any) bool

+ func ObjectsAreEqual(expected, actual any) bool

+ func ObjectsAreEqualValues(expected, actual any) bool

+ func Panics(t T, f PanicTestFunc, msgAndArgs ...any) bool

+ func PanicsWithError(t T, errString string, f PanicTestFunc, msgAndArgs ...any) bool

+ func PanicsWithValue(t T, expected any, f PanicTestFunc, msgAndArgs ...any) bool

+ func Positive(t T, e any, msgAndArgs ...any) bool

+ func Regexp(t T, rx any, str any, msgAndArgs ...any) bool

+ func Same(t T, expected, actual any, msgAndArgs ...any) bool

+ func Subset(t T, list, subset any, msgAndArgs ...any) (ok bool)

+ func True(t T, value bool, msgAndArgs ...any) bool

+ func WithinDuration(t T, expected, actual time.Time, delta time.Duration, msgAndArgs ...any) bool

+ func WithinRange(t T, actual, start, end time.Time, msgAndArgs ...any) bool

+ func YAMLEq(t T, expected string, actual string, msgAndArgs ...any) bool

+ func Zero(t T, i any, msgAndArgs ...any) bool

+ type Assertions struct

+ func New(t T) *Assertions

+ type BoolAssertionFunc func(T, bool, ...any) bool

+ type CollectT struct

+ func (CollectT) Helper()

+ func (c *CollectT) Errorf(format string, args ...any)

+ func (c *CollectT) FailNow()

+ type Comparison func() (success bool)

+ type ComparisonAssertionFunc func(T, any, any, ...any) bool

+ type ErrorAssertionFunc func(T, error, ...any) bool

+ type H interface

+ Helper func()

+ type PanicAssertionFunc func(t T, f PanicTestFunc, msgAndArgs ...any) bool

+ type PanicTestFunc func()

+ type T interface

+ Errorf func(format string, args ...any)

+ type ValueAssertionFunc func(T, any, ...any) bool