Характеристики

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, заключены в кортеж с метаданными об ответственности.

Эта функция возвращает либо {: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/арность"

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

Трассировка стека должна быть задана в качестве аргумента. Если нет, трассировка стека извлекается из 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, возвращая неизменённое содержимое для других.

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