React Hooks: useRef 사용법
Nov 1, 2020 · 4 min read



React Hooks 중에서 useState()useEffect() 처럼 많이 쓰이지는 않지만 가끔 나와서 햇갈리게 하는 녀석이 있습니다. 바로 useRef() 훅(hook) 함수인데요. 이번 포스트에서는 useRef() 함수가 왜 필요하고, 언제 사용하는지에 대해서 알아보겠습니다.

상태 변경 -> 컴포넌트 재 랜더링

React 컴포넌트는 기본적으로 내부 상태(state)가 변할 때 마다 다시 랜더링(rendering)이 됩니다.

예를 들어, 아래 <Counter/> 컴포넌트의 버튼을 5번 클릭하면 count 상태값은 5번 바뀌게 됩니다.

import React, { useState } from "react"

function Counter() {
  const [count, setCount] = useState(0)
  console.log(`랜더링... count: ${count}`)

  return (
    <>
      <p>{count}번 클릭하셨습니다.</p>
      <button onClick={() => setCount(count + 1)}>클릭</button>
    </>
  )
}

브라우저 콘솔을 확인해보면, 5번의 로그가 찍히는 것을 볼 수 있는데요. 이를 통해, <Counter/> 컴포넌트 함수는 count 상태가 바뀔 때 마다 호출되는 것을 알 수 있습니다.

랜더링... count: 1
랜더링... count: 2
랜더링... count: 3
랜더링... count: 4
랜더링... count: 5

컴포넌트 함수가 다시 호출이 된다는 것은 함수 내부의 변수들이 모두 다시 초기화가 되고 함수의 모든 로직이 다시 실행된다는 것을 의미합니다.

다시 랜더링 되어도 동일한 참조값을 유지하려면?

우리는 대부분의 경우, 위와 같이 상태가 변할 때 마다 React 컴포넌트 함수가 호출되어 화면이 갱신되기를 바랍니다. 하지만 그에 따른 부작용으로 함수 내부의 변수들이 기존에 저장하고 있는 값들을 잃어버리고 초기화되는데요. 간혹 다시 랜더링이 되더라도 기존에 참조하고 있던 컴포넌트 함수 내의 값이 그대로 보존되야 하는 경우가 있습니다.

예를 들어, 카운팅이 자동으로 되도록 useEffect 훅(hook) 함수를 이용하여 위의 컴포넌트를 수정해보겠습니다.

useEffect 훅 함수는 별도의 포스트로 다루었으니 참고 바랍니다.

import React, { useState, useEffect } from "react"

function AutoCounter() {
  const [count, setCount] = useState(0)
  console.log(`랜더링... count: ${count}`)

  useEffect(() => {
    const intervalId = setInterval(() => setCount((count) => count + 1), 1000)
    return () => clearInterval(intervalId)
  }, [])

  return <p>자동 카운트: {count}</p>
}

자, 여기서 만약에 카운트를 자동으로 시작하지 않고 버튼을 이용하여 시작하고 정지하고 싶다면 어떻게 해야 할까요?? 🤔

import React, { useState, useEffect } from "react"

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

  let intervalId

  const startCounter = () => {
    // 💥 매번 새로운 값 할당
    intervalId = setInterval(() => setCount((count) => count + 1), 1000)
  }
  const stopCounter = () => {
    clearInterval(intervalId)
  }

  return (
    <>
      <p>자동 카운트: {count}</p>
      <button onClick={startCounter}>시작</button>
      <button onClick={stopCounter}>정지</button>
    </>
  )
}

여기서 가장 큰 걸릿돌은 안에서 선언된 intervalId 변수를 startCounter() 함수와 stopCounter() 함수가 공유할 수 있도록 해줘야 한다는 것입니다. 그럴려면 intervalId 변수를 두 함수 밖에서 선언해야하는데 그럴 경우, count 상태값이 바뀔 때 마다 컴포넌트 함수가 호출되어 intervalId도 매번 새로운 값으로 바뀔 것입니다. 따라서, 브라우저 메모리에는 미처 정리되지 못한 intervalId 들이 1초에 하나식 쌓여나갈 것입니다. 💥

클래스를 이용해서 React 컴포넌트를 작성할 시절에는, 이와 같은 문제를 해결하는 가장 명료한 방법은 인스턴스(instance) 변수에 이러한 값들을 저장하는 것이 었습니다. 하지만 최근처럼 대부분 함수를 이용해서 React 컴포넌트를 작성할 때는 일반적으로 useRef 훅(hook) 함수를 사용해서 이러한 문제를 해결합니다.

useRef 사용하기

useRef 함수는 current 속성을 가지고 있는 객체를 반환하는데, 인자로 넘어온 초기값을 current 속성에 할당합니다. 이 current 속성은 값을 변경해도 상태를 변경할 때 처럼 React 컴포넌트가 다시 랜더링되지 않습니다. React 컴포넌트가 다시 랜더링될 때도 마찬가지로 이 current 속성의 값이 유실되지 않습니다.

useRef 훅 함수가 반환하는 객체의 이러한 독특한 성질을 이용하여 startCounter()stopCounter() 함수를 구현해보았습니다.

import React, { useState, useRef } from "react"

function ManualCounter() {
  const [count, setCount] = useState(0)
  const intervalId = useRef(null)
  console.log(`랜더링... count: ${count}`)

  const startCounter = () => {
    intervalId.current = setInterval(() => setCount((count) => count + 1), 1000)
    console.log(`시작... intervalId: ${intervalId.current}`)
  }

  const stopCounter = () => {
    clearInterval(intervalId.current)
    console.log(`정지... intervalId: ${intervalId.current}`)
  }

  return (
    <>
      <p>자동 카운트: {count}</p>
      <button onClick={startCounter}>시작</button>
      <button onClick={stopCounter}>정지</button>
    </>
  )
}

위 컴포넌트를 브라우저에서 실행하면 콘솔에 아래와 같은 로그가 찍히는데요. 시작 버튼을 누르면 새로운 intervalId가 생성되고, 정지 버튼을 누르면 기존 intervalId가 정리되는 것을 확인할 수 있습니다.

랜더링... count: 0
시작... intervalId: 17
랜더링... count: 1
랜더링... count: 2
랜더링... count: 3
랜더링... count: 4
랜더링... count: 5
정지... intervalId: 17
시작... intervalId: 32
랜더링... count: 6
랜더링... count: 7
랜더링... count: 8
정지... intervalId: 32

전체 코드

본 포스트에서 작성한 코드는 아래에서 확인하시고 직접 실행해보실 수 있습니다. <Counter />, <AutoCounter/>, <ManualCounter/>을 동시에 실행하지 마시고, 하나씩 실행하시면 콘솔에서 로그를 확인하는 게 수월하실 겁니다.

마치면서

useRef 훅 함수가 다른 React Hooks에 비해서 사용 빈도가 떨어지는 이유는 아무래도 살펴본 것처럼 용도가 극히 제한적이기 때문일 것입니다. useRef 훅 함수를 사용하는 또 다른 경우가 있는데, DOM 노드나 React 엘리먼트에 직접 접근하기 위해서 입니다. 이 부분에 대해서는 추후 포스트를 통해서 다뤄보도록 하겠습니다.






Engineering Blog  by Dale Seo