This doc describes jotai/devtool
bundle.
useAtomDevtools
useAtomDevtools
is a React hook that manages ReduxDevTools integration for a particular atom.
function useAtomDevtools<Value>(
anAtom: WritableAtom<Value, Value>,
name?: string
): void
The useAtomDevtools
hook accepts a generic type parameter (mirroring the type stored in the atom). Additionally, the hook accepts two invocation parameters, anAtom
and name
.
anAtom
is the atom that will be attached to the devtools instance. name
is an optional parameter that defines the debug label for the devtools instance. If name
is undefined, atom.debugLabel
will be used instead.
Example
import { useAtomDevtools } from 'jotai/devtools'
// The interface for the type stored in the atom.
export interface Task {
label: string
complete: boolean
}
// The atom to debug.
export const tasksAtom = atom<Task[]>([])
// If the useAtomDevtools name parameter is undefined, this value will be used instead.
tasksAtom.debugLabel = 'Tasks'
export const useTasksDevtools = () => {
// The hook can be called simply by passing an atom for debugging.
useAtomDevtools(tasksAtom)
// Specify a custom type parameter
useAtomDevtools<Task[]>(tasksAtom)
// You can attach two devtools instances to the same atom and differentiate them with custom names.
useAtomDevtools(tasksAtom, 'Tasks (Instance 1)')
useAtomDevtools(tasksAtom, 'Tasks (Instance 2)')
}