barriers

Documentation

Index

• func Handled(err error) error
• func HandledWithMessage(err error, msg string) error
• func HandledWithMessagef(err error, format string, args ...interface{}) error

Functions

func Handled

func Handled(err error) error

Handled swallows the provided error and hides it from the Cause()/Unwrap() interface, and thus the Is() facility that identifies causes. However, it retains it for the purpose of printing the error out (e.g. for troubleshooting). The error message is preserved in full.

Detail is shown: - via `errors.GetSafeDetails()`, shows details from hidden error. - when formatting with `%+v`. - in Sentry reports.

func HandledWithMessage

func HandledWithMessage(err error, msg string) error

HandledWithMessage is like Handled except the message is overridden. This can be used e.g. to hide message details or to prevent downstream code to make assertions on the message's contents.

func HandledWithMessagef

func HandledWithMessagef(err error, format string, args ...interface{}) error

HandledWithMessagef is like HandledWithMessagef except the message is formatted.