mirror of
https://github.com/taoensso/telemere.git
synced 2025-12-24 04:18:26 +00:00
d2386d62f1
Objectives:
- Support single map opts arg in all cases.
- Make it easier for folks to inspect the source to understand how
the common creators use/wrap underlying `signal!`.
Also updated relevant docstrings, etc.
31 lines
1.2 KiB
Text
31 lines
1.2 KiB
Text
"Error" signal creator, emphasizing (optional id) + error (Exception, etc.).
|
|
ALWAYS (unconditionally) returns the given error, so can conveniently be wrapped
|
|
by `throw`: (throw (error! (ex-info ...)), etc.
|
|
|
|
Default kind: `:error`
|
|
Default level: `:error`
|
|
|
|
Examples:
|
|
|
|
(throw (error! (ex-info "MyEx" {}))) ; %> {:kind :error, :level :error, :error <MyEx> ...}
|
|
(throw (error! ::my-id (ex-info "MyEx" {}))) ; %> {... :id ::my-id ...}
|
|
(throw
|
|
(error!
|
|
{:let [x "x"] ; Available to `:data` and `:msg`
|
|
:data {:x x}
|
|
:msg ["My message:" x]}
|
|
|
|
(ex-info "MyEx" {}))) ; %> {... :data {x "x"}, :msg_ "My msg: x" ...}
|
|
|
|
Tips:
|
|
|
|
- Test using `with-signal`: (with-signal (error! ...)).
|
|
- Supports the same options [2] as other signals [1].
|
|
|
|
- `error` arg is a platform error (`java.lang.Throwable` or `js/Error`).
|
|
|
|
----------------------------------------------------------------------
|
|
[1] See `help:signal-creators` - (`signal!`, `log!`, `event!`, ...)
|
|
[2] See `help:signal-options` - {:keys [kind level id data ...]}
|
|
[3] See `help:signal-content` - {:keys [kind level id data ...]}
|
|
[4] See `help:signal-filters` - (by ns/kind/id/level, sampling, etc.)
|