errext

Documentation

Overview

Package errext contains extensions for normal Go errors that are used in k6.

Index

• func WithExitCodeIfNone(err error, exitCode ExitCode) error
• func WithHint(err error, hint string) error
• type Exception
• type ExitCode
• type HasExitCode
• type HasHint

Functions

func WithExitCodeIfNone

func WithExitCodeIfNone(err error, exitCode ExitCode) error

WithExitCodeIfNone can attach an exit code to the given error, if it doesn't have one already. It won't do anything if the error already had an exit code attached. Similarly, if there is no error (i.e. the given error is nil), it also won't do anything.

func WithHint

func WithHint(err error, hint string) error

WithHint is a helper that can attach a hint to the given error. If there is no error (i.e. the given error is nil), it won't do anything. If the given error already had a hint, this helper will wrap it so that the new hint is "new hint (old hint)".

Types

type Exception

type Exception interface {
	error
	StackTrace() string
}

Exception represents errors that resulted from a script exception and contain a stack trace that lead to them.

type ExitCode

type ExitCode uint8

ExitCode is the code with which the application should exit if this error bubbles up to the top of the scope. Values should be between 0 and 125: https://unix.stackexchange.com/questions/418784/what-is-the-min-and-max-values-of-exit-codes-in-linux

type HasExitCode

type HasExitCode interface {
	error
	ExitCode() ExitCode
}

HasExitCode is a wrapper around an error with an attached exit code.

type HasHint

type HasHint interface {
	error
	Hint() string
}

HasHint is a wrapper around an error with an attached user hint. These hints can be used to give extra human-readable information about the error, including suggestions on how the error can be fixed.