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

*max-update-loops* cljs

combine-emulators cljs

(combine-emulators emu1 & more)

Combine two or more effect emualtors into one.

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.

get-component cljs

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)

performance-check cljs

(performance-check item state-seq)

For all the given states, this checks that for the same state, the item renders to the equal item; i.e. rendering has no side effects. If that it true, it also checks that for different states, it renders to different items; i.e. the state is minimal for this item. Note that this test makes most sense for 'dynamic' items. Returns :bad, :good, :ideal depending on these results.

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.

seq-diff cljs

(seq-diff s1 s2)

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.

verify-performance cljs

(verify-performance level item state-seq)

verify-performance! cljs

(verify-performance! level item state-seq)