https://react-ko.dev/reference/react/useEffect ์ปดํฌ๋„ŒํŠธ๋ฅผ ์™ธ๋ถ€ ์‹œ์Šคํ…œ๊ณผ ๋™๊ธฐํ™”ํ•  ์ˆ˜ ์žˆ๋Š” React Hook

์™ธ๋ถ€์‹œ์Šคํ…œ : ๋ธŒ๋ผ์šฐ์ € API, ๋„คํŠธ์›Œํฌ ๋“ฑ ๋ฆฌ์•กํŠธ๋กœ ์ œ์–ด๋˜์ง€ ์•Š๋Š” ์ฝ”๋“œ ์กฐ๊ฐ

parameters

  • setup
    • Effect์˜ ๋กœ์ง์ด ํฌํ•จ๋œ ํ•จ์ˆ˜. ํด๋ฆฐ์—… ํ•จ์ˆ˜๋ฅผ ๋ฐ˜ํ™˜ํ•  ์ˆ˜ ์žˆ๋‹ค.
    • ์ปดํฌ๋„ŒํŠธ๊ฐ€ DOM์— ์ถ”๊ฐ€๋˜๋ฉด ์…‹์—… ํ•จ์ˆ˜๋ฅผ ์‹คํ–‰ํ•œ๋‹ค.
    • ์˜์กด์„ฑ์ด ๋ณ€๊ฒฝ๋˜์–ด ๋ฆฌ๋ Œ๋”๋ง ๋  ๋•Œ๋งˆ๋‹ค React๋Š” ๋จผ์ € ์ด์ „ ๊ฐ’์œผ๋กœ ํด๋ฆฐ์—… ํ•จ์ˆ˜๋ฅผ ์‹คํ–‰ํ•œ๋‹ค์Œ, ์ƒˆ ๊ฐ’์œผ๋กœ ์…‹์—… ํ•จ์ˆ˜๋ฅผ ์‹คํ–‰ํ•œ๋‹ค.
    • ์ปดํฌ๋„ŒํŠธ๊ฐ€ DOM์—์„œ ์ œ๊ฑฐ๋˜๋ฉด, React๋Š” ๋งˆ์ง€๋ง‰์œผ๋กœ ํด๋ฆฐ์—… ํ•จ์ˆ˜๋ฅผ ์‹คํ–‰ํ•œ๋‹ค.
  • dependencies (optional)
    • setup ํ•จ์ˆ˜ ๋‚ด์—์„œ ์ฐธ์กฐ๋œ ๋ชจ๋“  ๋ฐ˜์‘ํ˜• ๊ฐ’(props, state, ์ปดํฌ๋„ŒํŠธ ๋ณธ๋ฌธ ๋‚ด ์„ ์–ธ๋œ ํ•จ์ˆ˜/๋ณ€์ˆ˜)์˜ ๋ชฉ๋ก
    • React๋Š” ๊ฐ ์˜์กด์„ฑ์— ๋Œ€ํ•ด Object.is๋กœ ์ด์ „ ๊ฐ’๊ณผ ๋น„๊ตํ•œ๋‹ค.
    • ๋นˆ๋ฐฐ์—ด vs ์•„์˜ˆ ๋„ฃ์ง€ ์•Š์•˜์„๋•Œ
      • ๋นˆ๋ฐฐ์—ด : ์ปดํฌ๋„ŒํŠธ๊ฐ€ ์ฒ˜์Œ DOM์— ์ถ”๊ฐ€๋˜์—ˆ์„๋•Œ๋งŒ ์‹คํ–‰ํ•จ
      • ์•„์˜ˆ ๋„ฃ์ง€ ์•Š์•˜์„๋•Œ : ๋งค ๋ฆฌ๋ Œ๋”๋ง๋งˆ๋‹ค ์‹คํ–‰ํ•จ

Caveats

  • useEffect๋Š” Hook์ด๋ฏ€๋กœ ์ปดํฌ๋„ŒํŠธ ์ตœ์ƒ์œ„ ๋ ˆ๋ฒจ ๋˜๋Š” ์ปค์Šคํ…€ ํ›…์—์„œ๋งŒ ํ˜ธ์ถœ ๊ฐ€๋Šฅํ•˜๋‹ค. ๋ฐ˜๋ณต๋ฌธ/์กฐ๊ฑด๋ฌธ ์•ˆ์—์„œ๋Š” ํ˜ธ์ถœํ•  ์ˆ˜ ์—†๊ณ , ๋”ฐ๋ผ์„œ ํ•„์š”์‹œ ์ƒˆ ์ปดํฌ๋„ŒํŠธ๋กœ ์ถ”์ถœํ•˜๋ผ
  • ์™ธ๋ถ€ ์‹œ์Šคํ…œ๊ณผ์˜ ๋™๊ธฐํ™” ๋ชฉ์ ์ด ์•„๋‹ˆ๋ฉด Effect๊ฐ€ ํ•„์š”์—†์„ ์ˆ˜ ์žˆ๋‹ค.
  • Strict Mode๊ฐ€ ์ผœ์ ธ์žˆ์œผ๋ฉด ์ฒซ ๋ฒˆ์งธ ์…‹์—… ์‹œ ์…‹์—… + ํด๋ฆฐ์—…์„ ํ•œ๋ฒˆ ๋” ์‹คํ–‰ํ•œ๋‹ค.
  • ์˜์กด์„ฑ ๋ฐฐ์—ด์— ์ปดํฌ๋„ŒํŠธ ๋‚ด๋ถ€์— ์ •์˜๋œ ๊ฐ์ฒด/ํ•จ์ˆ˜๊ฐ€ ํฌํ•จ๋˜๋ฉด Effect๊ฐ€ ํ•„์š”์ด์ƒ์œผ๋กœ ์ž์ฃผ ์‹คํ–‰๋  ์ˆ˜ ์žˆ๋‹ค.
  • Effect๊ฐ€ ์ƒํ˜ธ์ž‘์šฉ(ํด๋ฆญ ๋“ฑ)์œผ๋กœ ์ธํ•œ ๊ฒƒ์ด ์•„๋‹ˆ๋ผ๋ฉด, React๋Š” ๋ธŒ๋ผ์šฐ์ €๊ฐ€ Effect๋ฅผ ์‹คํ–‰ํ•˜๊ธฐ ์ „์— ํ™”๋ฉด์„ ๋จผ์ € ์—…๋ฐ์ดํŠธํ•œ๋‹ค. ๋”ฐ๋ผ์„œ Effect๊ฐ€ UI ์ž‘์—…์„ ํ•˜๊ณ  ์žˆ๊ฑฐ๋‚˜ ์ง€์—ฐ์ด ๋ˆˆ์— ๋„๋ฉด useLayoutEffect๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.
  • Effect๋Š” ํด๋ผ์ด์–ธํŠธ์—์„œ๋งŒ ์‹คํ–‰๋˜๊ณ  ์„œ๋ฒ„๋ Œ๋”๋ง ์ค‘์—๋Š” ์‹คํ–‰๋˜์ง€ ์•Š๋Š”๋‹ค.

Usage

Controlling a non-React widget

์™ธ๋ถ€ ์‹œ์Šคํ…œ์„ ์ปดํฌ๋„ŒํŠธ์˜ ํŠน์ • prop์ด๋‚˜ state์™€ ๋™๊ธฐํ™”ํ•˜๊ณ  ์‹ถ์„ ๋•Œ๊ฐ€ ์žˆ๋‹ค. ์•„๋ž˜ ์˜ˆ์ œ๋Š” ์ปดํฌ๋„ŒํŠธ ๋‚ด zoomLevel prop๊ณผ ์™ธ๋ถ€ Map ์ปดํฌ๋„ŒํŠธ์™€ ๋™๊ธฐํ™” ์‹œํ‚ค๋Š” ์˜ˆ์ œ์ด๋‹ค.

import { useRef, useEffect } from 'react';
import { MapWidget } from './map-widget.js';
 
export default function Map({ zoomLevel }) {
  const containerRef = useRef(null);
  const mapRef = useRef(null);
 
  useEffect(() => {
    if (mapRef.current === null) {
      mapRef.current = new MapWidget(containerRef.current);
    }
 
    const map = mapRef.current;
    map.setZoom(zoomLevel);
  }, [zoomLevel]);
  ...
}

MapWidget ํด๋ž˜์Šค๋Š” ์ž์‹ ์—๊ฒŒ ์ „๋‹ฌ๋œ DOM ๋…ธ๋“œ๋งŒ ๊ด€๋ฆฌํ•˜๊ธฐ ๋•Œ๋ฌธ์— ํด๋ฆฐ์—… ํ•จ์ˆ˜๊ฐ€ ํ•„์š”ํ•˜์ง€ ์•Š๋Š”๋‹ค. Map ๋ฆฌ์•กํŠธ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ํŠธ๋ฆฌ์—์„œ ์ œ๊ฑฐ๋˜๋ฉด DOM ๋…ธ๋“œ์™€ MapWidget ํด๋ž˜์Šค ์ธ์Šคํ„ด์Šค๋Š” ๋ธŒ๋ผ์šฐ์ € JS ์—”์ง„์— ์˜ํ•ด GC๋œ๋‹ค.

Fetching data with Effects

Effect ๋‚ด๋ถ€์—์„œ ๋ฐ์ดํ„ฐ ํŒจ์นญํ•  ๊ฒฝ์šฐ, ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํด๋ฆฐ์—… ํ•จ์ˆ˜์—์„œ ํ”Œ๋ž˜๊ทธ๋ฅผ ์ง€์ •ํ•˜๋ฉด ๋„คํŠธ์›Œํฌ ์‘๋‹ต์ด ๋ณด๋‚ธ ์ˆœ์„œ์™€ ๋‹ค๋ฅด๊ฒŒ ๋„์ฐฉํ•ด๋„ race condition์ด ๋ฐœ์ƒํ•˜์ง€ ์•Š๋Š”๋‹ค.

import { useState, useEffect } from 'react';
import { fetchBio } from './api.js';
 
export default function Page() {
  const [person, setPerson] = useState('Alice');
  const [bio, setBio] = useState(null);
  
  useEffect(() => {
    async function startFetching() {
      setBio(null);
      const result = await fetchBio(person);
      if (!ignore) {
        setBio(result);
      }
    }
 
    let ignore = false;
    startFetching();
    return () => {
      ignore = true;
    }
  }, [person]);
  ...
}
 

๋‹ค๋งŒ Effect์—์„œ ์ง์ ‘ ๋ฐ์ดํ„ฐ ํŒจ์นญ์„ ํ•˜๋Š” ๊ฒƒ์€ ์ถ”ํ›„ ์บ์‹ฑ/์„œ๋ฒ„ ๋ Œ๋”๋ง ๊ฐ™์€ ์ตœ์ ํ™”๋ฅผ ์ถ”๊ฐ€ํ•˜๊ธฐ ์–ด๋ ค์›Œ์ง„๋‹ค. ๋”ฐ๋ผ์„œ ์ปค์Šคํ…€ ํ›…์„ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ์ ์ ˆํ•œ ํŒจํ‚ค์ง€๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด ์ข‹๋‹ค.

Displaying different content on the server and the client

์„œ๋ฒ„ ๋ Œ๋”๋ง์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ, ์„œ๋ฒ„์—์„œ ์ƒ์„ฑํ•œ HTML๊ณผ ํด๋ผ์ด์–ธํŠธ์˜ ์ฒซ ๋ Œ๋”๋ง ๊ฒฐ๊ณผ๊ฐ€ ๊ฐ™์•„์•ผ hydration์ด ์ •์ƒ์ ์œผ๋กœ ์ด๋ฃจ์–ด์ง„๋‹ค. ํ•˜์ง€๋งŒ ๊ฒฝ์šฐ์— ๋”ฐ๋ผ ํด๋ผ์ด์–ธํŠธ์—์„œ ๋‹ค๋ฅธ ๊ฒฐ๊ณผ๋ฌผ์„ ๋‚˜ํƒ€๋‚ด๋ƒํ•˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ๋‹ค. (localstorage ์‚ฌ์šฉ ๋“ฑ) ์ด๋Ÿด๋•Œ ๋‹ค์Œ๊ณผ ๊ฐ™์ด useEffect๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

function MyComponent() {  
	const [didMount, setDidMount] = useState(false);  
	
	useEffect(() => {  
		setDidMount(true);  
	}, []); 
	
	if (didMount) {  
		// ... return client-only JSX ...  
	} else {  
		// ... return initial JSX ...  
	}  
}

useEffect๋Š” ์„œ๋ฒ„์—์„œ ์‹คํ–‰๋˜์ง€์•Š๋Š”๋‹ค. ๋”ฐ๋ผ์„œ ์„œ๋ฒ„์—์„œ ์ƒ์„ฑํ•œ HTML๊ณผ ๋ฆฌ์•กํŠธ์˜ ์ฒซ ๋ Œ๋”๋ง ๊ฒฐ๊ณผ๋Š” ๊ฐ™๋‹ค. ๋”ฐ๋ผ์„œ hydration์€ ์ •์ƒ์ ์œผ๋กœ ์™„๋ฃŒ๋˜๊ณ , Effect๊ฐ€ ์‹คํ–‰๋˜๋ฉด์„œ ๋ฆฌ๋ Œ๋”๋ง์ด ์ด๋ฃจ์–ด์ง„๋‹ค.

ํ•˜์ง€๋งŒ ์ด๋Ÿฌํ•œ ํŒจํ„ด์€ ๋˜๋„๋ก์ด๋ฉด ํ”ผํ•˜๋ผ. ๋А๋ฆฐ ํ™˜๊ฒฝ์—์„œ๋Š” ์ปดํฌ๋„ŒํŠธ ๋ชจ์–‘์ด ๊ฐ‘์ž๊ธฐ ๋ฐ”๋€Œ๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ๋Œ€๋ถ€๋ถ„์€ CSS๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์กฐ๊ฑด๋ถ€๋กœ ๋‹ค๋ฅธ ๊ฒƒ์„ ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ๋‹ค.

review