Effect에서 이벤트 분리하기

이벤트 핸들러와 Effect 중에 선택하기

먼저 이벤트 핸들러와 Effect의 차이점에 대해 간단히 알아보겠습니다.

채팅방 컴포넌트를 구현한다고 상상해 보세요. 요구사항은 아래와 같습니다.

1. 채팅방 컴포넌트는 선택된 채팅방에 자동으로 연결해야 합니다.
2. ”전송” 버튼을 클릭하면 채팅에 메시지를 전송해야 합니다.

코드를 이미 구현했다고 하겠습니다. 그런데 그 코드를 어디에 넣어야 할지 확실하지 않습니다. 이벤트 핸들러와 Effect 중에 무엇을 사용해야 할까요? 이 질문에 답해야 할 때마다 해당 코드가 실행되어야 하는 이유를 고려해 보세요.

이벤트 핸들러는 특정 상호작용에 대한 응답으로 실행된다

사용자 관점에서 메시지는 “전송” 버튼이 클릭 되었기 때문에 전송되어야 합니다. 다른 때나 다른 이유로 메시지가 전송되면 사용자는 꽤 당황할 것입니다. 그러므로 메시지를 전송하는 건 이벤트 핸들러가 되어야 합니다. 이벤트 핸들러는 특정 상호작용을 처리하게 해줍니다.

function ChatRoom({ roomId }) {
  const [message, setMessage] = useState('');
  // ...
  function handleSendClick() {
    sendMessage(message);
  }
  // ...
  return (
    <>
      <input value={message} onChange={e => setMessage(e.target.value)} />
      <button onClick={handleSendClick}>전송</button>
    </>
  );
}

이벤트 핸들러를 사용하면 사용자가 버튼을 누를 때만 sendMessage(message)가 실행될 것이라고 확신할 수 있습니다.

Effect는 동기화가 필요할 때마다 실행된다

채팅방 컴포넌트는 채팅방과의 연결을 유지해야 한다는 요구사항도 떠올려 보세요. 이 코드는 어디에 넣어야 할까요?

이 코드를 실행하는 이유는 어떠한 특정 상호작용이 아닙니다. 사용자가 채팅방 화면으로 이동한 이유나 방법은 상관없습니다. 사용자가 현재 채팅방 화면을 보고 상호작용할 수 있으므로 컴포넌트는 선택된 채팅 서버에 계속 연결되어 있어야 합니다. 채팅방 컴포넌트가 앱의 첫 화면이고 사용자가 아무런 상호작용을 하지 않은 경우라 해도 여전히 연결되어 있어야 합니다. 그러므로 이 코드는 Effect입니다.

function ChatRoom({ roomId }) {
  // ...
  useEffect(() => {
    const connection = createConnection(serverUrl, roomId);
    connection.connect();
    return () => {
      connection.disconnect();
    };
  }, [roomId]);
  // ...
}

이렇게 코드를 작성하면 사용자가 수행하는 특정 상호작용에 상관없이 현재 선택된 채팅 서버와 항상 연결된 상태임을 확신할 수 있습니다. 사용자가 앱을 열기만 했든 다른 방을 선택했든 다른 화면으로 이동했다가 다시 돌아왔든, 컴포넌트가 현재 선택된 방과 동기화된 상태를 유지할 것이고 필요할 때마다 다시 연결할 것을 Effect가 보장합니다.

반응형 값과 반응형 로직

이벤트 핸들러는 버튼 클릭과 같이 항상 “수동으로” 트리거 되지만, Effect는 동기화 유지에 필요한 만큼 자주 실행 및 재실행되기 때문에 “자동으로” 트리거 된다고 직감적으로 말할 수도 있습니다.

이에 대해 더 정확하게 생각하는 방법이 있습니다.

컴포넌트 본문 내부에 선언된 props, state, 변수를 반응형 값이라고 합니다. 이 예시에서 serverUrl은 반응형 값이 아니지만 roomId와 message는 반응형 값입니다. 반응형 값은 데이터 렌더링 과정에 관여합니다.

const serverUrl = 'https://localhost:1234';

function ChatRoom({ roomId }) {
  const [message, setMessage] = useState('');

  // ...
}

이러한 반응형 값은 리렌더링으로 인해 변경될 수 있습니다. 예를 들어 사용자가 message를 편집하거나 드롭다운에서 다른 roomId를 선택하는 경우가 있습니다. 이벤트 핸들러와 Effect는 변화에 다르게 반응합니다.

• 이벤트 핸들러 내부의 로직은 반응형이 아닙니다. 사용자가 같은 상호작용(예: 클릭)을 반복하지 않는 한 재실행되지 않습니다. 이벤트 핸들러는 변화에 “반응”하지 않으면서 반응형 값을 읽을 수 있습니다.
• Effect 내부의 로직은 반응형입니다. Effect에서 반응형 값을 읽는 경우 그 값을 의존성으로 지정해야 합니다. 그렇게 하면 리렌더링이 그 값을 바꾸는 경우 React가 새로운 값으로 Effect의 로직을 다시 실행합니다.

이 차이를 설명하기 위해 이전 예시를 다시 보겠습니다.

이벤트 핸들러 내부의 로직은 반응형이 아니다

아래의 코드 라인을 보세요. 이 로직이 반응형이어야 할까요, 아닐까요?

    // ...
    sendMessage(message);
    // ...

사용자 관점에서 message를 바꾸는 것이 메시지를 전송하고 싶다는 의미는 아닙니다. 사용자가 입력 중이라는 의미일 뿐입니다. 즉 메시지를 전송하는 로직은 반응형이어서는 안 됩니다. 반응형 값이 변경되었다는 이유만으로 로직이 재실행되어서는 안 됩니다. 그러므로 이 로직은 이벤트 핸들러에 속합니다.

  function handleSendClick() {
    sendMessage(message);
  }

이벤트 핸들러는 반응형이 아니므로 sendMessage(message)는 사용자가 전송 버튼을 클릭할 때만 실행될 것입니다.

Effect 내부의 로직은 반응형이다

이제 아래의 코드 라인으로 돌아가 봅시다.

    // ...
    const connection = createConnection(serverUrl, roomId);
    connection.connect();
    // ...

사용자 관점에서 roomId를 바꾸는 것은 다른 방에 연결하고 싶다는 의미입니다. 즉 방에 연결하기 위한 로직은 반응형이어야 합니다. 우리는 이 코드가 반응형 값을 “따라가고” 그 값이 바뀌면 다시 실행되기를 원합니다. 그러므로 이 로직은 Effect에 속합니다.

  useEffect(() => {
    const connection = createConnection(serverUrl, roomId);
    connection.connect();
    return () => {
      connection.disconnect()
    };
  }, [roomId]);

Effect는 반응형이므로 createConnection(serverUrl, roomId)와 connection.connect()는 구별되는 모든 roomId 값에 대해 실행될 겁니다. Effect는 채팅 연결과 현재 선택된 방의 동기화를 유지해 줍니다.

Effect에서 비반응형 로직 추출하기

반응형 로직과 비반응형 로직을 섞으려 한다면 더 까다로워집니다.

예를 들어 사용자가 채팅에 연결할 때 알림을 보여주는 상황을 상상해 보세요. 올바른 색상의 알림을 보여주기 위해 props로부터 현재 테마(dark 또는 light)를 읽습니다.

function ChatRoom({ roomId, theme }) {
  useEffect(() => {
    const connection = createConnection(serverUrl, roomId);
    connection.on('connected', () => {
      showNotification('연결됨!', theme);
    });
    connection.connect();
    // ...

그러나 theme은 (리렌더링으로 변경될 수 있는) 반응형 값이고 Effect가 읽는 모든 반응형 값은 의존성으로 선언되어야 합니다. 그러므로 theme을 Effect의 의존성으로 지정해야 합니다.

function ChatRoom({ roomId, theme }) {
  useEffect(() => {
    const connection = createConnection(serverUrl, roomId);
    connection.on('connected', () => {
      showNotification('연결됨!', theme);
    });
    connection.connect();
    return () => {
      connection.disconnect()
    };
  }, [roomId, theme]); // ✅ 모든 의존성 선언됨
  // ...

이 예시로 이것저것 해보면서 사용자 경험상의 문제를 발견할 수 있을지 확인해 보세요.

roomId가 변경되면 채팅은 예상대로 다시 연결됩니다. 하지만 theme도 의존성이므로 dark 테마와 light 테마 사이를 전환할 때마다 채팅도 다시 연결됩니다. 좋지 않습니다!

다시 말해 아래의 코드 라인이 비록 (반응형인) Effect 내부에 있지만 반응형이 아니길 바랍니다.

      // ...
      showNotification('연결됨!', theme);
      // ...

이 비반응형 로직을 주변의 반응형 Effect로부터 분리할 방법이 필요합니다.

Effect 이벤트 선언하기

이 비반응형 로직을 Effect에서 추출하려면 useEffectEvent라는 특수한 Hook을 사용하세요.

import { useEffect, useEffectEvent } from 'react';

function ChatRoom({ roomId, theme }) {
  const onConnected = useEffectEvent(() => {
    showNotification('연결됨!', theme);
  });
  // ...

여기서 onConnected를 Effect 이벤트라고 합니다. Effect 로직의 일부이지만 이벤트 핸들러와 훨씬 비슷하게 동작합니다. 내부의 로직은 반응형이 아니며 항상 props와 state의 최근 값을 “바라봅니다”.

이제 Effect 내부에서 Effect 이벤트인 onConnected를 호출할 수 있습니다.

function ChatRoom({ roomId, theme }) {
  const onConnected = useEffectEvent(() => {
    showNotification('연결됨!', theme);
  });

  useEffect(() => {
    const connection = createConnection(serverUrl, roomId);
    connection.on('connected', () => {
      onConnected();
    });
    connection.connect();
    return () => connection.disconnect();
  }, [roomId]); // ✅ 모든 의존성이 선언됨
  // ...

이렇게 하면 문제가 해결됩니다. Effect의 의존성 목록에서 onConnected를 제거해야 한다는 것에 유의하세요. Effect 이벤트는 반응형이 아니므로 의존성에서 제외되어야 합니다.

새로운 동작이 예상대로 작동하는지 확인해 보세요.

Effect 이벤트가 이벤트 핸들러와 아주 비슷하다고 생각할 수 있습니다. 이벤트 핸들러는 사용자의 상호작용에 대한 응답으로 실행되는 반면에 Effect 이벤트는 Effect에서 직접 트리거 된다는 것이 주요한 차이점입니다. Effect 이벤트를 사용하면 Effect의 반응성과 반응형이어서는 안 되는 코드 사이의 “연결을 끊어줍니다”.

Effect 이벤트로 최근 props와 state 읽기

Effect 이벤트는 의존성 린터를 억제하고 싶었을 많은 패턴을 수정하게 합니다.

예를 들어 페이지 방문을 기록하기 위한 Effect가 있다고 해보겠습니다.

function Page() {
  useEffect(() => {
    logVisit();
  }, []);
  // ...
}

이후 사이트에 여러 경로가 추가되고 이제 Page 컴포넌트는 현재 경로가 담긴 url을 prop으로 받습니다. logVisit에 url을 전달하여 호출하려는데 의존성 린터가 불평합니다.

function Page({ url }) {
  useEffect(() => {
    logVisit(url);
  }, []); // 🔴 React Hook useEffect has a missing dependency: 'url'
  // ...
}

이 코드로 무엇을 하려는 것인지 생각해 보세요. 각 URL은 서로 다른 페이지를 나타내므로 각 URL에 대한 방문을 따로 기록하려 합니다. 즉 이 logVisit 호출은 url에 반응형이어야 합니다. 그러므로 이런 경우에는 의존성 린터의 말을 따라 url을 의존성으로 추가하는 것이 합리적입니다.

function Page({ url }) {
  useEffect(() => {
    logVisit(url);
  }, [url]); // ✅ 모든 의존성이 선언됨
  // ...
}

이제 모든 페이지 방문기록에 장바구니의 물건 개수도 포함하려 한다고 해보겠습니다.

function Page({ url }) {
  const { items } = useContext(ShoppingCartContext);
  const numberOfItems = items.length;

  useEffect(() => {
    logVisit(url, numberOfItems);
  }, [url]); // 🔴 React Hook useEffect has a missing dependency: 'numberOfItems'
  // ...
}

Effect 내부에서 numberOfItems를 사용했으므로 린터는 이를 의존성에 추가해달라고 부탁합니다. 하지만 logVisit 호출이 numberOfItems에 반응하지 않길 원합니다. 사용자가 장바구니에 무언가를 넣어 numberOfItems가 변경되는 것이 사용자가 페이지를 다시 방문했음을 의미하지는 않습니다. 즉 페이지 방문은 어떤 의미에서 “이벤트”입니다. 이 이벤트는 특정한 시점에 발생합니다.

코드를 두 부분으로 나눠보세요.

function Page({ url }) {
  const { items } = useContext(ShoppingCartContext);
  const numberOfItems = items.length;

  const onVisit = useEffectEvent(visitedUrl => {
    logVisit(visitedUrl, numberOfItems);
  });

  useEffect(() => {
    onVisit(url);
  }, [url]); // ✅ 모든 의존성 선언됨
  // ...
}

여기서 onVisit은 Effect 이벤트입니다. 그 내부의 코드는 반응형이 아닙니다. 그러므로 numberOfItems (또는 다른 반응형 값!)의 변경이 주변 코드를 재실행시킬 걱정 없이 사용할 수 있습니다.

반면에 Effect 자체는 여전히 반응형입니다. Effect 내부의 코드는 prop인 url을 사용하므로 다른 url로 리렌더링 될 때마다 Effect가 재실행됩니다. 그로 인해 Effect 이벤트인 onVisit가 호출될 것입니다.

결과적으로 prop인 url 변경될 때마다 logVisit을 호출할 것이고 항상 최근의 numberOfItems를 읽을 것입니다. 하지만 numberOfItems 혼자만 변경되면 어떠한 코드도 재실행되지 않습니다.

  const onVisit = useEffectEvent(() => {
    logVisit(url, numberOfItems);
  });

  useEffect(() => {
    onVisit();
  }, [url]);

  const onVisit = useEffectEvent(visitedUrl => {
    logVisit(visitedUrl, numberOfItems);
  });

  useEffect(() => {
    onVisit(url);
  }, [url]);

  const onVisit = useEffectEvent(visitedUrl => {
    logVisit(visitedUrl, numberOfItems);
  });

  useEffect(() => {
    setTimeout(() => {
      onVisit(url);
    }, 5000); // 방문 기록을 지연시킴
  }, [url]);

function Page({ url }) {
  const { items } = useContext(ShoppingCartContext);
  const numberOfItems = items.length;

  useEffect(() => {
    logVisit(url, numberOfItems);
    // 🔴 이런 식으로 린터를 억제하는 것은 피하세요.
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [url]);
  // ...
}

import { useState, useEffect } from 'react';

export default function App() {
  const [position, setPosition] = useState({ x: 0, y: 0 });
  const [canMove, setCanMove] = useState(true);

  function handleMove(e) {
    if (canMove) {
      setPosition({ x: e.clientX, y: e.clientY });
    }
  }

  useEffect(() => {
    window.addEventListener('pointermove', handleMove);
    return () => window.removeEventListener('pointermove', handleMove);
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, []);

  return (
    <>
      <label>
        <input type="checkbox"
          checked={canMove}
          onChange={e => setCanMove(e.target.checked)}
        />
        점 움직이게 하기
      </label>
      <hr />
      <div style={{
        position: 'absolute',
        backgroundColor: 'pink',
        borderRadius: '50%',
        opacity: 0.6,
        transform: `translate(${position.x}px, ${position.y}px)`,
        pointerEvents: 'none',
        left: -20,
        top: -20,
        width: 40,
        height: 40,
      }} />
    </>
  );
}

import { useState, useEffect } from 'react';
import { experimental_useEffectEvent as useEffectEvent } from 'react';

export default function App() {
  const [position, setPosition] = useState({ x: 0, y: 0 });
  const [canMove, setCanMove] = useState(true);

  const onMove = useEffectEvent(e => {
    if (canMove) {
      setPosition({ x: e.clientX, y: e.clientY });
    }
  });

  useEffect(() => {
    window.addEventListener('pointermove', onMove);
    return () => window.removeEventListener('pointermove', onMove);
  }, []);

  return (
    <>
      <label>
        <input type="checkbox"
          checked={canMove}
          onChange={e => setCanMove(e.target.checked)}
        />
        점 움직이게 하기
      </label>
      <hr />
      <div style={{
        position: 'absolute',
        backgroundColor: 'pink',
        borderRadius: '50%',
        opacity: 0.6,
        transform: `translate(${position.x}px, ${position.y}px)`,
        pointerEvents: 'none',
        left: -20,
        top: -20,
        width: 40,
        height: 40,
      }} />
    </>
  );
}

Effect 이벤트의 한계

Effect 이벤트는 사용할 수 있는 방법이 매우 제한적입니다.

• Effect 내부에서만 호출하세요.
• 절대로 다른 컴포넌트나 Hook에 전달하지 마세요.

예를 들어 아래와 같이 Effect 이벤트를 선언하고 전달하지 마세요.

function Timer() {
  const [count, setCount] = useState(0);

  const onTick = useEffectEvent(() => {
    setCount(count + 1);
  });

  useTimer(onTick, 1000); // 🔴 금지: Effect 이벤트 전달하기

  return <h1>{count}</h1>
}

function useTimer(callback, delay) {
  useEffect(() => {
    const id = setInterval(() => {
      callback();
    }, delay);
    return () => {
      clearInterval(id);
    };
  }, [delay, callback]); // 의존성에 "callback"을 지정해야 함
}

그 대신 Effect 이벤트는 항상 자신을 사용하는 Effect의 바로 근처에 선언하세요.

function Timer() {
  const [count, setCount] = useState(0);
  useTimer(() => {
    setCount(count + 1);
  }, 1000);
  return <h1>{count}</h1>
}

function useTimer(callback, delay) {
  const onTick = useEffectEvent(() => {
    callback();
  });

  useEffect(() => {
    const id = setInterval(() => {
      onTick(); // ✅ 바람직함: Effect 내부에서 지역적으로만 호출됨
    }, delay);
    return () => {
      clearInterval(id);
    };
  }, [delay]); // "onTick"(Effect 이벤트)를 의존성으로 지정할 필요 없음
}

Effect 이벤트는 Effect의 코드 중 비반응형인 “부분”입니다. Effect 이벤트는 자신을 사용하는 Effect 근처에 있어야 합니다.