사용자가 검색창에 키보드를 칠 때마다 비동기 요청을 보내는데 이전 요청이 뒤늦게 응답하여 검색 결과가 뒤죽박죽 꼬이거나, 화면을 이동했는데도 백그라운드에서 실행 중인 네트워크 응답 때문에 에러가 발생하는 현상을 경험해봤을까?
다만 대부분의 개발자들은 디바운스(Debounce)로 타이핑 이벤트 횟수만 줄일 뿐 이미 브라우저 밖으로 출발한 이전 HTTP 요청 자체를 취소하는 방법은 잘 모르는 경우가 많다.
이번에는 비동기 fetch 요청을 깔끔하게 중단시키는 AbortController API가 정확히 뭔지, 왜 필요한지, 실무 코드에 어떻게 적용하는지 완벽하게 정리해서 소개하겠다.
AbortController는 웹 브라우저 표준 API로, DOM 요청(Fetch 포함)이나 비동기 작업이 완료되기 전에 중간에 취소(Abort)할 수 있는 신호를 보낼 수 있게 해준다.
실무 개발에서 단일 페이지 애플리케이션(SPA)을 개발할 때 자주 발생하는 두 가지 대표적인 비동기 문제가 있다.
첫째는 race condition(경합 상태)이다. 예를 들어 검색창에 '자바'를 치고 빠르게 '자바스크립트'를 검색했을 때, '자바'에 대한 서버 응답이 더 늦게 도착하면 최종 결과창에 '자바' 검색 데이터가 출력되는 심각한 UX 오류가 발생한다.
둘째는 컴포넌트 언마운트 시의 메모리 누수와 불필요한 네트워크 대역폭 소비다. 사용자가 페이지를 이미 떠났음에도 불구하고 수 메가바이트 크기의 JSON 응답을 받아와 DOM을 변경하려 시도하면서 콘솔 오류를 뿜어낸다.
AbortController 객체는 아주 단순한 구조로 되어 있으며, 크게 두 가지 핵심 요소로 동작한다.
1) controller.signal: controller가 갖고 있는 AbortSignal 객체다. 이 신호를 fetch() 함수의 options 객체에 전달하여 네트워크 요청과 컨트롤러를 연결한다.
2) controller.abort(): 이 메서드를 호출하는 순간 연결된 AbortSignal에 취소 신호가 전달되며, 진행 중이던 네트워크 요청이 즉시 중단된다.
실제 실무 검색 입력창에서 기존 요청을 Cancel하고 최신 요청만 유지하는 코드를 살펴보자.
✗ 잘못된 방식 (이전 요청을 그냥 내버려 두는 경우)
let currentSearch = '';
async function searchData(keyword) {
currentSearch = keyword;
// 이전 요청이 아직 진행 중이어도 그대로 두고 새 요청을 보냄
// 네트워크 지연 속도에 따라 경합 상태(Race Condition) 발생 원인이 됨
try {
const response = await fetch(`/api/search?q=${encodeURIComponent(keyword)}`);
const data = await response.json();
// 뒤늦게 들어온 이전 응답이 현재 검색어를 덮어버릴 수 있음
document.getElementById('result').innerText = JSON.stringify(data);
} catch (error) {
console.error('검색 실패:', error);
}
}위 코드는 네트워크 환경이 불안정하거나 데이터 응답 순서가 뒤바뀌면 사용자가 입력한 검색 결과와 화면에 뜨는 데이터가 일치하지 않는 치명적인 버그가 터진다.
✓ 올바른 방식 (AbortController 적용으로 이전 요청 즉시 취소)
let searchController = null;
async function searchData(keyword) {
// 1. 이미 진행 중인 요청이 있다면 취소(abort) 실행
if (searchController) {
searchController.abort();
}
// 2. 새 요청을 위한 AbortController 인스턴스 생성
searchController = new AbortController();
const signal = searchController.signal;
try {
// 3. fetch 옵션에 signal 전달
const response = await fetch(`/api/search?q=${encodeURIComponent(keyword)}`, { signal });
const data = await response.json();
document.getElementById('result').innerText = JSON.stringify(data);
} catch (error) {
// 4. 취소로 인한 에러인지 표준 에러인지 명확히 구분 처리
if (error.name === 'AbortError') {
console.log('이전 검색 요청이 성공적으로 취소되었습니다.');
} else {
console.error('실제 네트워크 오류 발생:', error);
}
} finally {
// 성공 혹은 실제 오류 처리 후 컨트롤러 참조 정돈
if (searchController && searchController.signal === signal) {
searchController = null;
}
}
}결과 및 동작 확인:
검색창에 연속으로 키를 입력하면 개발자 도구 Network 탭에 이전 fetch 요청들의 Status가 (canceled)로 바뀌는 것을 확인할 수 있다.
JavaScript 실행 흐름에서는 Promise가 reject 되며 `error.name` 값이 `'AbortError'`인 DOMException이 던져진다.
✗ 잘못된 것:
catch (error) 블록에서 에러 종류를 구분하지 않고 `alert('데이터 로딩 실패!')`를 호출하는 경우다.
사용자가 검색어를 빠르게 입력할 때마다 요청이 취소되면서 화면에 에러 팝업이 무더기로 뜨는 참사가 발생한다.
✓ 올바른 것:
반드시 `if (error.name === 'AbortError')` 조건문으로 취소 예외 상황을 걸러내고, 취소된 경우에는 아무런 사용자 경고를 노출하지 않도록 로직을 작성해야 한다.
✗ 잘못된 것:
`const controller = new AbortController();`를 전역에 한 번만 선언해 두고 `abort()`를 호출한 뒤 다음 fetch에서 동일한 `controller.signal`을 재사용하는 경우다.
한 번 `abort()`가 호출된 Signal은 `aborted: true` 상태가 고정되므로, 이후 전달되는 모든 fetch 요청은 실행되기도 전에 즉시 취소된다.
✓ 올바른 것:
요청을 취소하고 새로운 네트워크 요청을 보낼 때마다 매번 `new AbortController()`를 통해 새로운 인스턴스를 생성하여 전달해야 한다.
| 비교 항목 | 전통적인 비동기 처리 | AbortController 적용 방식 |
|---|---|---|
| 경합 상태(Race Condition) | 응답 순서 불일치로 데이터 꼬임 발생 | 신규 요청 시 이전 요청을 즉시 중단하여 해결 |
| 네트워크 리소스 | 취소 불가로 무의미한 다운로드 계속 진행 | 브라우저 단에서 즉시 패킷 수신 중단 |
| 메모리 관리 | 언마운트 후에도 비동기 콜백 실행 위험 존재 | 이벤트 및 네트워크 연결이 깔끔하게 해제됨 |
| 구현 난이도 | 플래그 변수 추가 등 복잡한 조건문 필요 | signal 옵션 지정만으로 깔끔하게 구현 가능 |
JavaScript AbortController는 프론트엔드 비동기 데이터 처리에서 경합 상태와 불필요한 네트워크 리소스 낭비를 막아주는 필수 API다. 검색 자동완성, 탭 전환, 대용량 파일 다운로드 취소 등 다양한 실무 상황에서 아주 강력하게 작용한다. 작은 최적화 습관이 모여서 웹 애플리케이션의 반응성과 안정성이라는 큰 효과를 만든다는 점을 잊지 말자. 이 글의 실전 예제 코드를 참고해 지금 작성 중인 검색이나 페이지네이션 비동기 로직에 적용하면, 한결 쾌적하고 버그 없는 유저 경험을 얻을 수 있을 것이다.