Спецификации

blame(:error, any(), stacktrace()) :: {t(), stacktrace()}

blame(non_error_kind(), payload, stacktrace()) :: {payload, stacktrace()}
when payload: var

Прикрепляет информацию к исключениям для дополнительной отладки.

Эта операция может быть ресурсоёмкой, так как она считывает данные из файловой системы, анализирует файлы beam, оценивает код и так далее.

Если модуль исключений реализует необязательный blame/2 обработчик, он будет вызван для выполнения вычислений.

Спецификации

blame_mfa(module(), function(), args :: [term()]) ::
  {:ok, :def | :defp | :defmacro | :defmacrop,
   [{args :: [term()], guards :: [term()]}]}
  | :error

Определяет вызов данного модуля, функции и аргументов.

Эта функция извлечёт доступные клаузы из байткода и оценит их по отношению к заданным аргументам. Клаузы возвращаются как список пар {args, guards} , где каждый аргумент и каждое условие верхнего уровня в условии, разделённые and/or, заключены в кортеж с метаданными blame.

Эта функция возвращает либо {:ok, definition, clauses}, либо :error. Где definition — это :def, :defp, :defmacro или :defmacrop.

Возвращает true, если данный term является исключением.

Спецификации

format(kind(), any(), stacktrace()) :: String.t()

Нормализует и форматирует выбросы/ошибки/выходы и трассировки стека.

Она полагается на format_banner/3 и format_stacktrace/1 для генерации окончательного формата.

Если kind равно {:EXIT, pid}, она не генерирует трассировку стека, так как такие выходы извлекаются как сообщения без трассировок стека.

Спецификации

format_banner(kind(), any(), stacktrace()) :: String.t()

Нормализует и форматирует любой выброс/ошибку/выход.

Сообщение форматируется и отображается в том же формате, что и в командной строке Elixir.

Третий аргумент — это трассировка стека, которая используется для обогащения нормализованной ошибки дополнительной информацией. Она используется только тогда, когда тип — ошибка.

Спецификации

format_exit(any()) :: String.t()

Форматирует выход. Возвращает строку.

Часто внутри выходов содержатся ошибки/исключения. Выходы часто оборачиваются вызывающей стороной и также содержат трассировки стека. Эта функция форматирует выходы так, чтобы хорошо отобразить причину выхода, вызывающую сторону и трассировку стека.

Принимает анонимную функцию и арность и форматирует её так, как показано в трассировках стека. Арность также может быть списком аргументов.

Примеры

Exception.format_fa(fn -> nil end, 1)
#=> "#Function<...>/1"

Форматирует указанный file и line так, как показано в трассировках стека. Если какие-либо из значений nil, они пропускаются.

Примеры

iex> Exception.format_file_line("foo", 1)
"foo:1:"

iex> Exception.format_file_line("foo", nil)
"foo:"

iex> Exception.format_file_line(nil, nil)
""

Принимает модуль, функцию и арность и форматирует их так, как показано в трассировках стека. Арность также может быть списком аргументов.

Примеры

iex> Exception.format_mfa(Foo, :bar, 1)
"Foo.bar/1"

iex> Exception.format_mfa(Foo, :bar, [])
"Foo.bar()"

iex> Exception.format_mfa(nil, :bar, [])
"nil.bar()"

Анонимные функции отображаются как -func/arity-anonfn-count-, где func — имя окружающей функции. Преобразовать в «анонимная функция в func/arity»

Форматирует трассировку стека.

Трассировка стека должна быть указана в качестве аргумента. Если нет, трассировка стека извлекается из Process.info/2.

Спецификации

format_stacktrace_entry(stacktrace_entry()) :: String.t()

Принимает запись трассировки стека и форматирует её в строку.

Получает сообщение для exception.

Спецификации

normalize(:error, any(), stacktrace()) :: t()

normalize(non_error_kind(), payload, stacktrace()) :: payload when payload: var

Нормализует исключение, преобразуя Erlang-исключения в Elixir-исключения.

Она принимает kind от catch в качестве аргумента и нормализует только :error, возвращая неизменённый payload для других.

Третий аргумент — это трассировка стека, которая используется для обогащения нормализованной ошибки дополнительной информацией. Она используется только тогда, когда тип — ошибка.