react-mutex v0.1.2

useMutex

A set of react hooks that allows for a mutually exclusive access to a resource.

Documentation

Hooks

• useMutex<T>(initialValue): Mutex<T>

  useMutex creates a reference containing some data of type T, and then returns a mutex that controls access to said resource. Its initial value is provided by the parameter initialValue, and will only be used to initialize the reference, when the component is first mounted.

  Name	Type	Description
  initialValue	T	The initial value of the resource.

• useMutex<T, P>(initializer, params): Mutex<T>

  useMutex creates a reference containing some data of type T, and then returns a mutex that controls access to said resource. Its initial value is computed by calling the user-supplied function initializer w ith parameters params. This will only be done to initialize the reference, when the component is first mounted.

  This version of useMutex is useful when the provided initial value is a large object, or its creation triggers some stateful behavior.

  Name	Type	Description
  initializer	(params: P) => T	A function that produces the initial value.
  params	P	The parameter passed to the initializer function.

Types

Mutex<T>

A mutex protecting a resource from simultaneous access.

MutexResource<T>

An access to the resource protected by a mutex. Must be released once the user has finished accessing the resource.