Side-effects
For side-effects other than simply changing the application state we'll be using the useEffect
hook.
There's three parts to each useEffect
hook: setup
, cleanup
, and dependencies
. Cleanup and dependencies are optional.
Setup
The function provided is the setup
of the hook. This is where all the hook's logic is.
useEffect(() => {
console.log("setup")
window.addEventListener("mousemove", (event: MouseEvent) => {
setPosition({ x: event.clientX, y: event.clientY })
})
})
Hook written like that will run for every render of the component its used in, and create a myriad of event listeners.
In fact this code will break your browser.
Cleanup
The setup can return a function that will be called when its time to "undo" the changes the hook has made.
useEffect(() => {
console.log("setup")
const handler = (event: MouseEvent) => {
setPosition({ x: event.clientX, y: event.clientY })
}
window.addEventListener("mousemove", handler)
return () => {
console.log("cleanup")
window.removeEventListener("mousemove", handler)
}
})
In fact this code will probably break your browser.
Dependencies
We really only want the hook to run once:
useEffect(() => {
console.log("setup")
const handler = (event: MouseEvent) => {
setPosition({ x: event.clientX, y: event.clientY })
}
window.addEventListener("mousemove", handler)
return () => {
console.log("cleanup")
window.removeEventListener("mousemove", handler)
}
}, [])
Second argument to the useEffect
function is the array of dependencies. Hook behavior changes depending what in it:
null
orundefined
: the hook will run for every render[]
(empty array): the hook will run once, after the first render[value1, value2]
: the hook will only run when one of the values changes