Функції обробки помилок у Golang

У цій статті я продемонструю основи обробки функцій помилок у Go і як ними користуватися.

Що таке тип помилки?

Тип помилки в Go є типом інтерфейсу.

type error interface { 
    Error() string 
}

Таким чином, в основному, тип помилки - це все, що реалізує метод Error().

Створення екземпляра помилки

Існує два способи створення помилки.

функція error.New
функція fmt.Errorf

func bar() error {
    return errors.New("error: an error occurred")
}
func foo() error {
    return fmt.Errorf("error: %s", "an error occurred")
}

Кожен виклик цих двох функцій повертає відмінне значення помилки, навіть якщо текст ідентичний.

fmt.Println(foo()==bar()) # false

Визначення очікуваних помилок

Визначення очікуваних помилок є ключовою технікою в Go, оскільки вона допомагає нам виявляти конкретні помилки та по різному їх обробляти.

package main

import (
	"errors"
	"fmt"
)

var ErrDivideByZero = errors.New("divide by zero")

func Divide(a, b int) (int, error) {
	if b == 0 {
		return 0, ErrDivideByZero
	}
	return a / b, nil
}

func main() {
	a, b := 5, 0
	result, err := Divide(a, b)
	if err != nil {
		switch {
		case errors.Is(err, ErrDivideByZero):
			fmt.Println("Divide by zero")
		default:
			fmt.Printf("unknown error: %v\n", err)
		}
	}

	fmt.Printf("%d / %d = %d\n", a, b, result)

}

Ось приклад;

Спочатку ми визначаємо сигнальну помилку під назвою ErrDivideByZero.
Потім ми визначаємо функцію Divide, яка повертає цю помилку, коли другий аргумент дорівнює нулю.
Пізніше ми використовуємо errors.Is, щоб перевірити, чи повернута помилка, ErrDivideByZero і виконати певні дії.

Обгортання помилок

Обгорнути помилку, це взяти одне значення помилки та помістити його в інше значення помилки, як загорнутий подарунок.

Функції обробки помилок у Golang

Це корисно, коли ви хочете повернути конкретне повідомлення про помилку, коли виникла конкретна помилка.

Ось приклад.

package main

import (
	"errors"
	"fmt"
)

var ErrDivideByZero = errors.New("divide by zero")


func doDivide(a, b int) (int, error) {
	result, err := Divide(a, b)
	if err != nil {
		return 0, fmt.Errorf("divide error: %w", err)
	}
	return result, nil

}

func Divide(a, b int) (int, error) {
	if b == 0 {
		return 0, ErrDivideByZero
	}
	return a / b, nil
}

func main() {
	a, b := 5, 0
	result, err := doDivide(a, b)
	if err != nil {
		switch {
		case errors.Is(err, ErrDivideByZero):
			fmt.Println("Divide by zero")
		default:
			fmt.Printf("unknown error: %v\n", err)
		}
	}

	fmt.Printf("%d / %d = %d\n", a, b, result)

}

По-перше, функція Divide повертає ErrDivideByZero коли другий аргумент дорівнює нулю
Потім, функція doDivide обгортає помилку ErrDivideByZero спеціальним повідомленням про помилку та повертає нову помилку.
Нарешті, в основній функції ми використовуємо функцію errors.Is, щоб перевірити, чи є всередині обгорнутого ланцюга тип помилки ErrDivideByZero .

Висновок

Ось три виноси

Тип помилки в Go є типом інтерфейсу.
Попередньо визначені помилки дозволять нам перевірити, яка помилка сталася пізніше.
Обгонуті помилки додають контекст до викликів функцій (подібно до трасування стека)