vide/docs/api/reactivity-utility.md

Reactivity API: Utility

cleanup()

Runs a callback anytime a scope is reran or destroyed.

• Type

  function cleanup(callback: () -> ())
  function cleanup(obj: Destroyable)
  function cleanup(obj: Disconnectable)
  
  type Destroyable = { destroy: () -> () }
  type Disconnectable = { disconnect: () -> () }
  

• Example

  local data = source(1)
  
  effect(function()
      local label = create "TextLabel" { Text = data() }
  
      cleanup(function()
          label:Destroy()
      end)
  end)
  

untrack()

Runs a given function in a new stable scope.

• Type

  function untrack<T>(source: () -> T): T
  

• Details

  Can be used inside a reactive scope to read from sources you do not want tracked by the reactive scope.

• Example

  local a = source(0)
  local b = source(0)
  
  local sum = derive(function()
      return a() + untrack(b)
  end)
  
  print(sum()) -- 0
  b(1)
  print(sum()) -- 0
  a(1)
  print(sum()) -- 2
  

read()

Utility used to read a value that is either a primitive or a source. Sources read can still be tracked inside a reactive scope.

• Type

  function read<T>(value: T | () -> T): T
  

batch()

Runs a given function where any source updates made within the function do not trigger effects until after the function finishes running.

• Type

  function batch(fn: () -> ())
  

• Details

  Improves performance when an effect depends on multiple sources, and those sources need to be updated. Updating those sources inside a batch call will only cause the effect to run once after the batch call ends instead of after each time a source is updated.

---