💻 개발
useEffect와 useLayoutEffect의 차이점에 대해서 설명해주세요
본 포스트는 IT 기술면접 질문 메일링 서비스, 매일메일의 토픽에 대해 추가적으로 학습한 내용을 기록하고자 작성되었습니다. 기술면접 질문 및 답안&해설을 제공해주신 매일메일 서비스에 감사의 말씀 남깁니다.
서론
사실…
useLayoutEffect의 존재를 알게 된지는 얼마 안됐다. 예전에 GPT랑 싸우면서 트러블 슈팅하면서 처음 알게 됐는데, 그 때는 업무가 바빠서 제대로 공부하길 미루는 바람에 이번 주제에 대해서 제대로 얘기하지 못했다.괜찮다. 그래서 지금 이 글을 쓰고 있는 거니까~~
정답
useEffect
먼저 useEffect는 React를 다루는 개발자라면 모르는 사람이 없을 것이다.
그러니 useEffect에 대한 개념을 다시 한 번 잡고 useLayoutEffect에 대해 알아보며 비교해볼 것이다.
공식문서에서는 useEffect를 다음과 같이 설명하고 있다.
외부 시스템과 컴포넌트를 동기화하는 React Hook
컴포넌트 내부의 로직은 크게 두 가지 유형으로 나눌 수 있다. 바로 렌더링 코드, 이벤트 핸들러이다.
- 렌더링 코드는 props와 state를 적절히 변형해 결과적으로 JSX를 반환한다. 렌더링 코드의 로직은 순수하기 때문에 어떤 객체나 변수의 값을 변경(=Side Effect)하지 않는다.
- 이벤트 핸들러는 사용자의 이벤트(버튼 클릭 또는 입력 등)에 따라 특정 동작을 수행하는 로직으로, Side Effect를 포함할 수 있으며 컴포넌트 내부의 중첩 함수 형태를 갖는다.
하지만 만약 사용자의 이벤트가 아니라 컴포넌트의 렌더링을 어느 동작의 트리거로 활용하고 싶은 경우는 어떻게 해야 할까?
여기서 useEffect를 활용할 수 있다. useEffect는 렌더링 자체에 의해 발생하는 부수효과를 특정한다. 즉, 이벤트 핸들러처럼 특정 이벤트에 대해서가 아닌, 렌더링에 의해 Side Effect를 수행할 수 있다.
여기까지가 useEffect의 기본 컨셉이다. 공식 문서에 나와있는 간단한 예시만 첨부하고, 사용법에 대한 디테일한 부분은 생략하도록 하겠다.
import { useState, useRef, useEffect } from 'react'; function VideoPlayer({ src, isPlaying }) { const ref = useRef(null); useEffect(() => { // VideoPlayer 컴포넌트가 렌더링될 때마다 다음의 로직이 수행된다. if (isPlaying) { ref.current.play(); } else { ref.current.pause(); } }); return <video ref={ref} src={src} loop playsInline />; } export default function App() { const [isPlaying, setIsPlaying] = useState(false); return ( <> <button onClick={() => setIsPlaying(!isPlaying)}> {isPlaying ? '일시 정지' : '재생'} </button> <VideoPlayer isPlaying={isPlaying} src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4" /> </> ); }
useEffect와 useLayoutEffect
자 그럼 useLayoutEffect는 뭘까?
useEffect와 useLayoutEffect 모두 컴포넌트가 렌더링된 후 특정 작업을 수행하기 위해 사용된다는 점에서는 같다.
하지만 해당 작업을 수행하는 타이밍과 그 쓰임이 다르다.
useEffect는 렌더링이 완료된 시점에 비동기적으로 실행되는데, 화면이 실제로 사용자에게 그려진 후에 로직이 수행된다.
반면 useLayoutEffect는 렌더링 후 DOM이 업데이트되기 직전(=화면이 사용자에게 보여지기 전)에 동기적으로 실행된다.
프론트엔드 개발을 하다보면 useRef를 활용해 특정 DOM 요소의 크기 혹은 위치를 측정/조정해본 경험이 있을 것이다. 그런 경우 useEffect를 사용하면 동작 수행 후 DOM을 화면에 다시 그리게 되어 순간적으로 화면이 깜빡일 수 있다. 이 때 useEffect 대신 useLayoutEffect를 활용하면 해당 로직이 모두 끝난 후, 변경사항이 반영된 DOM이 화면에 출력되기 때문에 사용자 경험을 개선할 수 있다.
쓰임을 정리해보면 useEffect는 data fetch나 이벤트 리스너 추가처럼, 화면에 직접적인 영향을 주지 않는 작업에, useLayoutEffect는 DOM의 크기를 측정해서, 다른 요소의 위치를 조정해야 할 때 사용하는 것이 좋다.
한 가지 더 알아둬야할 주의사항은, useLayoutEffect는 동기적으로 실행되기 때문에 너무 많은 로직을 수행할 경우 렌더링이 느려질 수 있어 사용 시 트레이드 오프를 충분히 고려해야 한다.
(추가) useInsertionEffect
조사하다보니 비슷한 계열로 useInsertionEffect라는 훅이 있어 추가로 정리해보려고 한다. React 18 이상에서 지원되며, 스타일 삽입/계산 목적으로 설계된 훅으로, CSS-in-JS 라이브러리를 활용할 때 유용하게 쓰인다.
실행 시점은 DOM 변경 직후, 브라우저가 화면에 그릴 레이아웃을 계산하기 전에 수행된다. 시그니처는 나머지 두 훅과 동일하다.
앞선 두 가지 훅을 포함해 실행 순서를 정리하면 다음과 같다.
useInsertionEffect → useLayoutEffect → useEffectReact 렌더링 사이클에서의 순서를 정리하면 다음과 같이 정리할 수 있다.
- React가 DOM을 업데이트한다. (가상 DOM을 실제 DOM에 반영)
- useInsertionEffect 실행 (DOM 업데이트 후 브라우저가 레이아웃을 계산하기 전에 실행)
- useLayoutEffect 실행 (DOM 업데이트 후 브라우저가 화면을 그리기 전에 실행)
- 브라우저가 레이아웃을 계산하고 화면을 그리기 시작
- useEffect 실행 (비동기 후처리)

실습해보기
예제 코드는 jaddong님의 ‣ 글을 참고하여 만들었다. 좋은 글, 예제 제공에 감사드립니다!
import { Box, Button, Stack } from "@mui/material"; import { useEffect, useLayoutEffect, useState } from "react"; export default function App() { const [value, setValue] = useState(0); const [layoutValue, setLayoutValue] = useState(0); useEffect(() => { if (value === 0) { setValue(10 + Math.random() * 200); } }, [value]); useLayoutEffect(() => { if (layoutValue === 0) { setLayoutValue(10 + Math.random() * 200); } }, [layoutValue]); return ( <Stack p={2} gap={2}> <Stack direction="row" gap={1} alignItems={"center"}> <Button variant="outlined" onClick={() => setValue(0)}> 초기화 </Button> <Box width={200}>useEffect value</Box> {value} </Stack> <Stack direction="row" gap={1} alignItems={"center"}> <Button variant="outlined" onClick={() => setLayoutValue(0)}> 초기화 </Button> <Box width={200}>useLayoutEffect value</Box> {layoutValue} </Stack> </Stack> ); }

이게 gif 영상으로 찍으니까 프레임에 따라 깜빡임 현상이 잘 포착되지 않아서, useEffect value가 바뀌는 부분만 느리게 재생한 버전을 따로 만들었다.

보이는 것과 같이 useEffect value의 경우 다음과 같은 과정을 거치기 때문에, 순간적으로 0이 렌더링되는 현상이 발생한다.
- 버튼 클릭
→ layoutValue의 값이 0으로 초기화
→ 새 layoutValue의 값 0이 화면에 그려짐(Paint)
→ useEffect 실행
→ layoutValue의 값이 랜덤한 값으로 초기화
→ 새 layoutValue의 값(랜덤값)이 화면에 그려짐(Paint)
반면 useLayoutEffectValue의 경우 다음과 같은 과정을 거치므로, useEffect와 같은 깜빡임 현상 없이 자연스럽게 값이 변경되는 모습을 확인할 수 있다.
- 버튼 클릭
→ layoutValue의 값이 0으로 초기화
→ useLayoutEffect 실행
→ layoutValue의 값이 랜덤한 값으로 초기화
→ 새 layoutValue의 값(랜덤값)이 화면에 그려짐(Paint)
📚 일일 기술토크3 / 4