자바스크립트 클로저의 원리와 실무 해결 방안

자바스크립트에서 클로저(Closure)는 함수가 선언될 당시의 주변 환경(Lexical Environment)을 기억하여, 함수가 외부에서 호출될 때도 그 환경에 접근할 수 있게 하는 강력한 기능입니다. 하지만 반복문 내에서 비동기 이벤트 핸들러를 등록할 때 클로저의 특성을 정확히 이해하지 못하면 의도치 않은 버그가 발생하곤 합니다.

가장 흔한 사례는 반복문을 돌며 여러 요소에 클릭 이벤트를 할당하는 경우입니다.

- 항목 1
- 항목 2
- 항목 3
- 항목 4

아래는 초보 개발자들이 자주 실수하는 전형적인 코드 패턴입니다.

function attachEvents() {
  var items = document.getElementsByTagName("li");
  for (var i = 0; i < items.length; i++) {
    items[i].onclick = function() {
      // 모든 항목을 클릭했을 때 마지막 인덱스 값만 출력됨
      console.log("선택된 인덱스:", i);
    };
  }
}

위 코드에서 onclick 핸들러가 실행되는 시점은 이미 반복문이 종료된 이후입니다. var 키워드로 선언된 변수 i는 함수 스코프를 가지므로, 모든 핸들러는 동일한 변수 i를 공유하게 되고 결과적으로 루프의 최종 값만을 참조하게 됩니다.

이러한 문제를 해결하고 각 핸들러가 고유한 상태를 유지하게 만드는 여러 가지 기법을 살펴보겠습니다.

1. 즉시 실행 함수(IIFE)를 활용한 스코프 분리

각 반복 단계에서 새로운 스코프를 생성하여 현재의 인덱스 값을 고정(Capturing)하는 방식입니다.

function solveWithIIFE() {
  var elements = document.getElementsByTagName("li");
  for (var i = 0; i < elements.length; i++) {
    (function(capturedIdx) {
      elements[capturedIdx].onclick = function() {
        alert("현재 인덱스: " + capturedIdx);
      };
    })(i);
  }
}

2. 클로저를 반환하는 팩토리 함수 사용

이벤트 핸들러 자체를 외부 함수에서 생성하여 반환함으로써 인덱스 값을 클로저 내부에 보존합니다.

function createHandler(index) {
  return function() {
    console.log("데이터 인덱스:", index);
  };
}

function solveWithFactory() {
  var targets = document.querySelectorAll("li");
  for (var i = 0; i < targets.length; i++) {
    targets[i].onclick = createHandler(i);
  }
}

3. DOM 객체에 데이터 바인딩

인덱스 값을 자바스크립트 클로저에 의존하지 않고, DOM 엘리먼트의 속성으로 직접 저장하는 방법입니다.

function solveByProperty() {
  var nodes = document.getElementsByTagName("li");
  for (var i = 0; i < nodes.length; i++) {
    nodes[i].indexRef = i; // 객체 속성에 저장
    nodes[i].onclick = function() {
      alert("바인딩된 값: " + this.indexRef);
    };
  }
}

4. Function 생성자 활용

Function 생성자를 사용하면 매번 새로운 함수 인스턴스가 생성되며 독립적인 실행 컨텍스트를 형성합니다.

function solveByFunctionConstructor() {
  var list = document.getElementsByTagName("li");
  for (var i = 0; i < list.length; i++) {
    list[i].onclick = new Function("alert('번호: ' + " + i + ");");
  }
}

클로저와 Context(this)의 관계 이해

클로저 내부에서 this 키워드를 사용할 때는 주의가 필요합니다. 내부 함수는 자신을 포함하는 외부 함수의 this를 자동으로 상속받지 않습니다.

var globalName = "Global Window";

var component = {
  globalName: "Local Object",
  getNameHandler: function() {
    // 내부에서 익명 함수를 반환하면 전역 객체에 바인딩되는 경우가 많음
    return function() {
      return this.globalName;
    };
  }
};

console.log(component.getNameHandler()()); // "Global Window" 출력

위 예시에서 getNameHandler가 반환한 함수는 전역 컨텍스트에서 실행되므로 this는 전역 객체를 가리키게 됩니다. 만약 Local Object를 참조하고 싶다면 화살표 함수를 사용하거나 bind, call, apply 메서드를 통해 명시적으로 컨텍스트를 지정해야 합니다.

현대적인 해결책: 블록 스코프 (let)

ES6 이상의 환경에서는 var 대신 let을 사용하여 반복문 내에서 간단하게 독립적인 스코프를 생성할 수 있습니다.

function modernSolve() {
  const items = document.querySelectorAll("li");
  for (let i = 0; i < items.length; i++) {
    // let은 블록 단위 스코프를 가지므로 각 반복마다 새로운 i가 생성됨
    items[i].onclick = () => console.log("Index:", i);
  }
}

현대적인 자바스크립트 개발에서는 클로저의 복잡한 구조를 피하기 위해 let 키워드를 사용하거나 배열 메서드(forEach, map 등)를 활용하여 스코프 문제를 자연스럽게 해결하는 것이 권장됩니다.

태그: JavaScript closures scope IIFE event-handling

11월 9일 13:57에 게시됨