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

assert

package

Go to main page

Versions in this module

v1

v1.2.4

Oct 1, 2025

v1.2.3

Oct 1, 2025

v1.2.2

Oct 1, 2025

Changes in this version

+ func Error(t internal.TestingT, v error) *internal.ErrorAssertion

+ func Map[K, V comparable](t internal.TestingT, v map[K]V) *internal.MapAssertion[K, V]

+ func Slice[T comparable](t internal.TestingT, v []T) *internal.SliceAssertion[T]

+ func String(t internal.TestingT, v string) *internal.StringAssertion

v1.2.1

Sep 23, 2025

v1.2.0

Sep 14, 2025

v1.1.4

Sep 14, 2025

Changes in this version

+ func Panic(t internal.TestingT, fn func(), expr string, msg ...string)

+ func ToJsonString(v any) string

+ func ToPrettyString(v any) string

+ type Assertion struct

+ func That(t internal.TestingT, v any) *Assertion

+ func (a *Assertion) Contains(expect any, msg ...string) *Assertion

+ func (a *Assertion) Equal(expect any, msg ...string) *Assertion

+ func (a *Assertion) False(msg ...string) *Assertion

+ func (a *Assertion) Has(expect any, msg ...string) *Assertion

+ func (a *Assertion) Implements(expect any, msg ...string) *Assertion

+ func (a *Assertion) Nil(msg ...string) *Assertion

+ func (a *Assertion) NotEqual(expect any, msg ...string) *Assertion

+ func (a *Assertion) NotNil(msg ...string) *Assertion

+ func (a *Assertion) NotSame(expect any, msg ...string) *Assertion

+ func (a *Assertion) Same(expect any, msg ...string) *Assertion

+ func (a *Assertion) True(msg ...string) *Assertion

+ func (a *Assertion) TypeOf(expect any, msg ...string) *Assertion

+ type AssertionBase struct

+ func (c *AssertionBase[T]) Require() T

+ type ErrorAssertion struct

+ func ThatError(t internal.TestingT, v error) *ErrorAssertion

+ func (a *ErrorAssertion) Is(target error, msg ...string) *ErrorAssertion

+ func (a *ErrorAssertion) Matches(expr string, msg ...string) *ErrorAssertion

+ func (a *ErrorAssertion) Nil(msg ...string) *ErrorAssertion

+ func (a *ErrorAssertion) NotIs(target error, msg ...string) *ErrorAssertion

+ func (a *ErrorAssertion) NotNil(msg ...string) *ErrorAssertion

+ type MapAssertion struct

+ func ThatMap[K, V comparable](t internal.TestingT, v map[K]V) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) ContainsKey(key K, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) ContainsKeyValue(key K, value V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) ContainsKeys(keys []K, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) ContainsValue(value V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) ContainsValues(values []V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) Empty(msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) Equal(expect map[K]V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) HasSameKeys(expect map[K]V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) HasSameValues(expect map[K]V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) Length(length int, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) Nil(msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotContainsKey(key K, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotContainsKeys(keys []K, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotContainsValue(value V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotContainsValues(values []V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotEmpty(msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotEqual(expect map[K]V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) NotNil(msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) SubsetOf(expect map[K]V, msg ...string) *MapAssertion[K, V]

+ func (a *MapAssertion[K, V]) SupersetOf(expect map[K]V, msg ...string) *MapAssertion[K, V]

+ type Number interface

+ type NumberAssertion struct

+ func ThatNumber[T Number](t internal.TestingT, v T) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) Between(lower, upper T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) Equal(expect T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) GreaterOrEqual(expect T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) GreaterThan(expect T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) InDelta(expect T, delta T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) IsFinite(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) IsInf(sign int, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) IsNaN(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) LessOrEqual(expect T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) LessThan(expect T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) Negative(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) NotBetween(lower, upper T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) NotEqual(expect T, msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) NotNegative(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) NotPositive(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) NotZero(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) Positive(msg ...string) *NumberAssertion[T]

+ func (a *NumberAssertion[T]) Zero(msg ...string) *NumberAssertion[T]

+ type SliceAssertion struct

+ func ThatSlice[T comparable](t internal.TestingT, v []T) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) AllMatches(fn func(T) bool, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) AllUnique(msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) AnyMatches(fn func(T) bool, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) Contains(element T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) ContainsSlice(sub []T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) Empty(msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) Equal(expect []T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) HasPrefix(prefix []T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) HasSuffix(suffix []T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) Length(length int, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) Nil(msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) NoneMatches(fn func(T) bool, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) NotContains(element T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) NotContainsSlice(sub []T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) NotEmpty(msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) NotEqual(expect []T, msg ...string) *SliceAssertion[T]

+ func (a *SliceAssertion[T]) NotNil(msg ...string) *SliceAssertion[T]

+ type StringAssertion struct

+ func ThatString(t internal.TestingT, v string) *StringAssertion

+ func (a *StringAssertion) Blank(msg ...string) *StringAssertion

+ func (a *StringAssertion) Contains(substr string, msg ...string) *StringAssertion

+ func (a *StringAssertion) Equal(expect string, msg ...string) *StringAssertion

+ func (a *StringAssertion) EqualFold(expect string, msg ...string) *StringAssertion

+ func (a *StringAssertion) HasPrefix(prefix string, msg ...string) *StringAssertion

+ func (a *StringAssertion) HasSuffix(suffix string, msg ...string) *StringAssertion

+ func (a *StringAssertion) IsAlpha(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsAlphaNumeric(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsBase64(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsEmail(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsHex(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsIPv4(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsLowerCase(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsNumeric(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsURL(msg ...string) *StringAssertion

+ func (a *StringAssertion) IsUpperCase(msg ...string) *StringAssertion

+ func (a *StringAssertion) JSONEqual(expect string, msg ...string) *StringAssertion

+ func (a *StringAssertion) Length(length int, msg ...string) *StringAssertion

+ func (a *StringAssertion) Matches(pattern string, msg ...string) *StringAssertion

+ func (a *StringAssertion) NotBlank(msg ...string) *StringAssertion

+ func (a *StringAssertion) NotEqual(expect string, msg ...string) *StringAssertion