부수 효과
Side effect
코드가 실행되면서 반환값 계산을 넘어 외부에서 관찰 가능한 상태나 동작을 바꾸는 일이다.
같은 뜻으로 쓰는 말
- 사이드 이펙트
- side-effect
마지막 검증
부수 효과는 값을 계산해 돌려주는 것 밖의 관찰 가능한 변화를 뜻한다. 모듈을 불러오는 즉시 전역 값을 바꾸거나 이벤트를 등록하고, 폴리필을 설치하거나 CSS를 적용하는 일이 대표 사례다. 로그를 남기는 일도 외부에서 관찰할 수 있으므로 부수 효과다.
사용한 내보내기가 없어도 모듈의 최상위 코드를 실행할 때 필요한 부수 효과가 있다면 그 코드는 남아야 한다. 반대로 부수 효과가 없다고 잘못 선언하면 운영 최적화에서 초기화 코드나 스타일이 사라질 수 있다.
이 용어 문서에서 말하는 부수 효과는 모듈의 최상위 코드를 실행할 때 생기는 일반적인
변화다. React의 Effect나 useEffect라는 API 자체를 뜻하지 않는다. React Effect 안의
코드도 외부 상태를 바꿀 수 있지만, 빌드 도구가 모듈을 제거해도 되는지와는 구분해서
판단한다.
출처와 검증 범위
아래 날짜는 링크를 마지막으로 열어 본 날입니다. 문서 상단의 검증일은 글의 설명과 적용 범위를 다시 확인한 날입니다.
- Tree Shakingwebpack · 공식 문서 · 확인 2026-08-04
- Configuration Options — treeshake.moduleSideEffectsRollup · 공식 문서 · 확인 2026-08-04