useTask$() - Explicit Reactivity

In addition to implicit reactivity created by the templates, Qwik supports explicit execution of code when a property changes. This is achieved through the useTask$() hook. useTask$() hooks execute before the component renders and can be asynchronous. The hook can also have a clean-up function that is invoked on the next hook execution or when the component is removed.

In this example clicking on +1 updates count immediately. What we would like is to update the delay count after a 2-second delay. If count is updated before the 2 seconds are up then the timer is restarted.

Notice that the useTask$() callback receives a track function. Use the track function to tell Qwik which properties should trigger the task's watcher. The track function creates subscriptions in the store. On each invocation of useTask$() the subscriptions are cleared, so it is important to always set up a new set of subscriptions. This is useful if the set of subscriptions changes during the function's lifetime.

The useTask$() callback function can return a cleanup function. The clean-up function is invoked on the next useTask$() callback execution or when the component is removed. In our case, the cleanup function is used for returning code which clears the setTimeout.

The useTask$() callbacks execute before the component is rendered. This allows them to be used to compute values used in rendering. The function runs on both server and client. The server execution sets up subscriptions that are then serialized and available to the client. This saves the client from having to download all of the components and execute them at least once to recover the subscription information for the system.

Edit Tutorial