Error

Asserting Errors

Assertions

All links point to https://pkg.go.dev/github.com/go-openapi/testify/v2

This domain exposes 8 functionalities.

EqualError

EqualError asserts that a function returned a non-nil error (i.e. an error) and that it is equal to the provided error.

Examples

	actualObj, err := SomeFunction()
	assertions.EqualError(t, err,  expectedErrorString)

	success: ErrTest, "assert.ErrTest general error for testing"
	failure: ErrTest, "wrong error message"

Signature	Usage
`assert.EqualError(t T, theError error, errString string, msgAndArgs ...any) bool`	package-level function
`assert.EqualErrorf(t T, theError error, errString string, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).EqualError(theError error, errString string) bool`	method variant
`assert.(*Assertions).EqualErrorf(theError error, errString string, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.EqualError(t T, theError error, errString string, msgAndArgs ...any) bool`	package-level function
`require.EqualErrorf(t T, theError error, errString string, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).EqualError(theError error, errString string) bool`	method variant
`require.(*Assertions).EqualErrorf(theError error, errString string, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.EqualError(t T, theError error, errString string, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#EqualError

Error

Error asserts that a function returned a non-nil error (ie. an error).

Examples

	actualObj, err := SomeFunction()
	assertions.Error(t, err)

	success: ErrTest
	failure: nil

Signature	Usage
`assert.Error(t T, err error, msgAndArgs ...any) bool`	package-level function
`assert.Errorf(t T, err error, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).Error(err error) bool`	method variant
`assert.(*Assertions).Errorf(err error, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.Error(t T, err error, msgAndArgs ...any) bool`	package-level function
`require.Errorf(t T, err error, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).Error(err error) bool`	method variant
`require.(*Assertions).Errorf(err error, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.Error(t T, err error, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#Error

ErrorAs

ErrorAs asserts that at least one of the errors in err’s chain matches target, and if so, sets target to that error value.

This is a wrapper for errors.As.

Examples

	assertions.ErrorAs(t, err, &target)

	success: fmt.Errorf("wrap: %w", &dummyError{}), new(*dummyError)
	failure: ErrTest, new(*dummyError)

Signature	Usage
`assert.ErrorAs(t T, err error, target any, msgAndArgs ...any) bool`	package-level function
`assert.ErrorAsf(t T, err error, target any, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).ErrorAs(err error, target any) bool`	method variant
`assert.(*Assertions).ErrorAsf(err error, target any, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.ErrorAs(t T, err error, target any, msgAndArgs ...any) bool`	package-level function
`require.ErrorAsf(t T, err error, target any, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).ErrorAs(err error, target any) bool`	method variant
`require.(*Assertions).ErrorAsf(err error, target any, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.ErrorAs(t T, err error, target any, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#ErrorAs

ErrorContains

ErrorContains asserts that a function returned a non-nil error (i.e. an error) and that the error contains the specified substring.

Examples

	actualObj, err := SomeFunction()
	assertions.ErrorContains(t, err,  expectedErrorSubString)

	success: ErrTest, "general error"
	failure: ErrTest, "not in message"

Signature	Usage
`assert.ErrorContains(t T, theError error, contains string, msgAndArgs ...any) bool`	package-level function
`assert.ErrorContainsf(t T, theError error, contains string, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).ErrorContains(theError error, contains string) bool`	method variant
`assert.(*Assertions).ErrorContainsf(theError error, contains string, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.ErrorContains(t T, theError error, contains string, msgAndArgs ...any) bool`	package-level function
`require.ErrorContainsf(t T, theError error, contains string, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).ErrorContains(theError error, contains string) bool`	method variant
`require.(*Assertions).ErrorContainsf(theError error, contains string, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.ErrorContains(t T, theError error, contains string, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#ErrorContains

ErrorIs

ErrorIs asserts that at least one of the errors in err’s chain matches target.

This is a wrapper for errors.Is.

Examples

	assertions.ErrorIs(t, err, io.EOF)

	success: fmt.Errorf("wrap: %w", io.EOF), io.EOF
	failure: ErrTest, io.EOF

Signature	Usage
`assert.ErrorIs(t T, err error, target error, msgAndArgs ...any) bool`	package-level function
`assert.ErrorIsf(t T, err error, target error, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).ErrorIs(err error, target error) bool`	method variant
`assert.(*Assertions).ErrorIsf(err error, target error, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.ErrorIs(t T, err error, target error, msgAndArgs ...any) bool`	package-level function
`require.ErrorIsf(t T, err error, target error, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).ErrorIs(err error, target error) bool`	method variant
`require.(*Assertions).ErrorIsf(err error, target error, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.ErrorIs(t T, err error, target error, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#ErrorIs

NoError

NoError asserts that a function returned a nil error (ie. no error).

Examples

	actualObj, err := SomeFunction()
	if assert.NoError(t, err) {
		assertions.Equal(t, expectedObj, actualObj)
	}

	success: nil
	failure: ErrTest

Signature	Usage
`assert.NoError(t T, err error, msgAndArgs ...any) bool`	package-level function
`assert.NoErrorf(t T, err error, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).NoError(err error) bool`	method variant
`assert.(*Assertions).NoErrorf(err error, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.NoError(t T, err error, msgAndArgs ...any) bool`	package-level function
`require.NoErrorf(t T, err error, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).NoError(err error) bool`	method variant
`require.(*Assertions).NoErrorf(err error, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.NoError(t T, err error, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#NoError

NotErrorAs

NotErrorAs asserts that none of the errors in err’s chain matches target, but if so, sets target to that error value.

Examples

	assertions.NotErrorAs(t, err, &target)

	success: ErrTest, new(*dummyError)
	failure: fmt.Errorf("wrap: %w", &dummyError{}), new(*dummyError)

Signature	Usage
`assert.NotErrorAs(t T, err error, target any, msgAndArgs ...any) bool`	package-level function
`assert.NotErrorAsf(t T, err error, target any, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).NotErrorAs(err error, target any) bool`	method variant
`assert.(*Assertions).NotErrorAsf(err error, target any, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.NotErrorAs(t T, err error, target any, msgAndArgs ...any) bool`	package-level function
`require.NotErrorAsf(t T, err error, target any, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).NotErrorAs(err error, target any) bool`	method variant
`require.(*Assertions).NotErrorAsf(err error, target any, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.NotErrorAs(t T, err error, target any, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#NotErrorAs

NotErrorIs

NotErrorIs asserts that none of the errors in err’s chain matches target.

This is a wrapper for errors.Is.

Examples

	assertions.NotErrorIs(t, err, io.EOF)

	success: ErrTest, io.EOF
	failure: fmt.Errorf("wrap: %w", io.EOF), io.EOF

Signature	Usage
`assert.NotErrorIs(t T, err error, target error, msgAndArgs ...any) bool`	package-level function
`assert.NotErrorIsf(t T, err error, target error, msg string, args ...any) bool`	formatted variant
`assert.(*Assertions).NotErrorIs(err error, target error) bool`	method variant
`assert.(*Assertions).NotErrorIsf(err error, target error, msg string, args ..any)`	method formatted variant

Signature	Usage
`require.NotErrorIs(t T, err error, target error, msgAndArgs ...any) bool`	package-level function
`require.NotErrorIsf(t T, err error, target error, msg string, args ...any) bool`	formatted variant
`require.(*Assertions).NotErrorIs(err error, target error) bool`	method variant
`require.(*Assertions).NotErrorIsf(err error, target error, msg string, args ..any)`	method formatted variant

Signature	Usage
`assertions.NotErrorIs(t T, err error, target error, msgAndArgs ...any) bool`	internal implementation

Source: github.com/go-openapi/testify/v2/internal/assertions#NotErrorIs

Generated with github.com/go-openapi/testify/v2/codegen