reacl-c.test-util.core — de.active-group/reacl-c 0.7.0

*max-update-loops* cljs

combine-emulators cljs

(combine-emulators emu1 & more)

Combine two or more effect emualtors into one, to be used with env.

describe-failed-find cljs

(describe-failed-find env item)

effect-args cljs

(effect-args eff)

effect-f cljs

(effect-f eff)

effect? cljs

(effect? a & [eff-defn])

env cljs

(env item & [options])

Returns a new test environment to test the behavior of the given item. Options map may include

:emulator a function (fn [env effect] (return ...)) that may handle effect action reaching the toplevel.

execute-effect! cljs

(execute-effect! env eff)

Executed the given effect in the given test environment.

find cljs

(find env item)

find-all cljs

(find-all env item)

find-all-named cljs

(find-all-named env thing)

find-named cljs

(find-named env thing)

get-component cljs

(get-component env)

inject-action! cljs

(inject-action! comp action)

inject-return! cljs

(inject-return! comp ret)

inject-state-change! cljs

(inject-state-change! comp state)

invoke-callback! cljs

(invoke-callback! comp callback event)

mount! cljs

(mount! env state)

Mounts the item of the given test environment with the given state, and returns actions and maybe a changed state.

mount!! cljs

(mount!! env state)

preventing-error-log cljs

(preventing-error-log thunk)

Prevents a log message about an exception during the evaluation of thunk, which occurs event when the error is handled in an error boundary.

provided clj macro

(provided bindings & body)

push! cljs

(push! env ret)

push!! cljs

(push!! env ret)

send-message! cljs

(send-message! comp msg)

Sends a message to the given component or the toplevel component of the given test environment, and returns actions and maybe a changed state.

subscribe-effect-args cljs

(subscribe-effect-args eff)

The arguments passed to the subscription the given subscribe effect was generated from.

subscribe-effect? cljs

(subscribe-effect? eff)

(subscribe-effect? eff subs)

Tests if the given effect, is one that is emitted by a subscription equal to the given one on mount. This can be useful in unit tests.

subscription-emulator cljs

(subscription-emulator subs-env)

Returns the emulator function to be set as the :emulator option of a testing environemnt.

subscription-emulator-env cljs

(subscription-emulator-env sub)

Create a subscription emulation environment for items like the given subscription.

subscription-emulator-inject! cljs

(subscription-emulator-inject! subs-env action)

Make the emulated subscription emit the given action.

subscription-emulator-running? cljs

(subscription-emulator-running? subs-env)

Checks if the subscription emulation environment is attached as the :emulator to a testing environment and a subscription is mounted.

subscription-result! cljs

(subscription-result! env sub-eff action)

For the effect that resulted from mounting a subscription (see subscribe-effect?), inject the given action as a result of the subscription item, and return what the tested component in the given test environment returns.

subscription-result-return cljs

(subscription-result-return env sub-eff action)

subscription-start! cljs

(subscription-start! env sub-eff & [stop-fn!])

Begins a simulated execution of the subscription given by the given effect that resulting from mounting it (see subscribe-effect?). The optional given stop-fn! will be called when the unsubscribe-effect? returned on unmount is executed.

subscription-start-return cljs

(subscription-start-return env sub-eff & [stop-fn!])

unmount! cljs

(unmount! env)

Unmounts the item of the given test environment, and return actions and maybe a changed state.

unmount!! cljs

(unmount!! env)

unsubscribe-effect-args cljs

(unsubscribe-effect-args eff)

The arguments passed to the subscription the given unsubscribe effect was generated from.

unsubscribe-effect? cljs

(unsubscribe-effect? eff)

(unsubscribe-effect? eff subs)

Tests if the given effect, is one that is emitted by a subscription equal to the given one, on unmount. This can be useful in unit tests.

update! cljs

(update! env state)

Updates the state of the item of the given test environment, and returns actions and maybe a changed state.

update!! cljs

(update!! env state)

Updates the state of the item of the given test environment, and if the state is changed in reaction to that, then keeps on updating it. Returns actions and the final changed state, if it was changed at all. Throws if there are more than max-update-loops recursions, which are a sign for bug in the item.