Fetch API의 `keepalive` 옵션으로 백그라운드 요청 놓치지 않기
사용자가 페이지를 닫거나 이동해도 백그라운드에서 네트워크 요청을 계속 처리하게 해주는 Fetch API의 `keepalive` 옵션에 대해 알아봅니다. 데이터 손실 방지와 사용자 경험 개선을 위한 이 기능의 작동 방식, 사용 사례, 주의사항, 그리고 `navigator.sendBeacon`과의 비교까지 상세히 설명합니다.
페이지를 떠나도 요청은 계속된다: Fetch API keepalive 옵션
사용자가 웹 페이지를 닫거나 새로고침할 때, 백그라운드에서 실행 중이던 네트워크 요청이 중간에 끊겨버리는 경험, 다들 있으시죠? 특히 사용자의 중요한 데이터를 서버로 전송하거나, 비동기적으로 처리해야 하는 작업의 경우, 이 끊김은 심각한 데이터 손실이나 사용자 경험 저하로 이어질 수 있습니다. 예를 들어, 사용자가 작성하던 긴 글을 저장하기 직전에 페이지를 닫아버리거나, 설문 조사 제출 후 페이지 이동 중 요청이 실패하는 상황을 상상해보세요.
이런 문제를 해결하기 위해 Fetch API는 keepalive 옵션을 제공합니다. 이 옵션을 사용하면, 페이지가 닫히거나 사용자가 다른 페이지로 이동하더라도 브라우저가 백그라운드에서 해당 네트워크 요청을 완료할 수 있도록 보장합니다. 즉, 사용자의 액션과는 독립적으로 요청을 끝까지 보내는 것이죠.
keepalive 옵션이란?
keepalive는 Fetch API의 init 객체에서 사용할 수 있는 Boolean 값의 옵션입니다. 기본값은 false이며, true로 설정하면 브라우저가 페이지를 닫은 후에도 해당 요청을 백그라운드에서 계속 처리합니다. 이는 서비스 워커(Service Worker) 없이도 유사한 백그라운드 요청 기능을 구현할 수 있게 해줍니다.
keepalive의 작동 방식
keepalive 옵션을 true로 설정하면, 브라우저는 해당 요청을 브라우저 프로세스의 수명 주기 관리 하에 두게 됩니다. 일반적인 Fetch 요청은 해당 탭이나 창의 수명 주기에 종속되어, 탭이 닫히면 요청도 취소됩니다. 하지만 keepalive 요청은 브라우저가 백그라운드에서 이 요청을 계속 처리할 수 있도록, 탭의 수명 주기와 분리됩니다. 물론, 브라우저 자체가 종료되면 요청은 중단됩니다.
언제 keepalive를 사용해야 할까?
keepalive는 다음과 같은 상황에서 유용하게 활용될 수 있습니다.
- 데이터 로깅 및 분석: 사용자가 페이지를 떠나기 직전의 상태나 중요한 이벤트를 서버로 전송할 때
- 장기 실행 작업 트리거: 사용자 세션이 종료된 후에도 서버에서 특정 작업을 시작하도록 요청할 때 (예: 보고서 생성)
- 오프라인 데이터 동기화: 서비스 워커와 함께 사용하여, 네트워크가 불안정하거나 사용자가 페이지를 떠난 후에도 데이터를 안전하게 동기화할 때 (주의:
keepalive자체는 오프라인 기능을 제공하지 않으며, 서비스 워커와 결합 시 시너지를 낼 수 있습니다.) - 사용자 활동 기록: 사용자가 페이지를 나가기 전, 마지막으로 완료한 작업이나 입력 내용을 기록할 때
keepalive 사용 시 주의사항
keepalive 옵션은 강력하지만, 몇 가지 제약 사항과 주의할 점이 있습니다.
- 요청 메서드 제한:
keepalive는POST,PUT,DELETE,SEND등 Body를 포함하는 메서드와 함께 사용될 때 가장 효과적입니다.GET과 같은 메서드에서는 Body를 보낼 수 없으므로keepalive의 의미가 퇴색됩니다. - Body 크기 제한: 브라우저 구현에 따라
keepalive요청의 Body 크기에 제한이 있을 수 있습니다. 너무 큰 데이터를 전송하려고 하면 실패할 수 있습니다. - 응답 처리의 복잡성:
keepalive요청은 페이지가 닫힌 후에 완료될 수 있으므로, 응답을 받는 시점을 예측하기 어렵습니다. 따라서 응답 처리는 단순한 성공/실패 여부 확인 정도로 제한하거나, 서비스 워커를 통해 별도로 관리하는 것이 좋습니다. - 리소스 사용: 백그라운드에서 계속 실행되므로, 과도하게 사용하면 브라우저의 성능에 영향을 줄 수 있습니다. 신중하게 사용해야 합니다.
- 브라우저 지원: 모든 브라우저에서
keepalive옵션을 완벽하게 지원하는 것은 아닙니다. 특히 구형 브라우저에서는 지원되지 않을 수 있으므로, 사용 전에 호환성을 확인하는 것이 중요합니다. (최신 Chrome, Firefox, Edge 등은 지원합니다.)
코드 예제
예제 1: 간단한 데이터 전송
사용자가 페이지를 떠나기 전, 간단한 로그 데이터를 서버로 전송하는 예제입니다. navigator.sendBeacon과 유사하게 작동하지만, Fetch API의 일부로 사용할 수 있다는 장점이 있습니다.
1async function sendLogData(event) { 2 const data = { 3 userId: 'user123', 4 action: event.type, // 'click', 'leave' 등 5 timestamp: Date.now() 6 }; 7 8 try { 9 const response = await fetch('/api/log', { 10 method: 'POST', 11 headers: { 12 'Content-Type': 'application/json' 13 }, 14 body: JSON.stringify(data), 15 keepalive: true // 이 부분이 핵심! 16 }); 17 18 // 페이지가 닫힌 후에는 response를 즉시 처리하기 어려울 수 있습니다. 19 // 성공적인 요청 전송 자체에 의의를 두거나, 서버로부터의 응답이 꼭 필요하다면 20 // 다른 메커니즘(예: 서비스 워커)을 고려해야 합니다. 21 if (response.ok) { 22 console.log('Log data sent successfully (or queued for sending).'); 23 } else { 24 console.error('Failed to send log data.'); 25 } 26 } catch (error) { 27 console.error('Error sending log data:', error); 28 } 29} 30 31// 페이지를 떠날 때 이벤트 핸들러 등록 32window.addEventListener('beforeunload', (event) => { 33 // beforeunload 내에서 fetch 요청을 보내는 것은 권장되지 않습니다. 34 // 브라우저에 의해 차단될 수 있으며, keepalive의 효과를 제대로 보장하지 못합니다. 35 // 대신, 페이지 로드 시점에 또는 특정 사용자 액션 발생 시점에 keepalive 요청을 보내는 것이 더 안전합니다. 36 // 여기서는 개념 설명을 위해 beforeunload 시점에 호출하는 예시를 들지만, 실제 구현 시에는 주의가 필요합니다. 37 // sendLogData({ type: 'page_leave' }); 38}); 39 40// 특정 버튼 클릭 시 데이터 전송 예시 41const saveButton = document.getElementById('save-button'); 42if (saveButton) { 43 saveButton.addEventListener('click', async () => { 44 // ... 저장 로직 ... 45 await sendLogData({ type: 'save_attempt' }); 46 alert('데이터가 저장되었습니다!'); 47 }); 48} 49 50// 페이지 로드 시점에 한번 보내는 예시 51// sendLogData({ type: 'page_load' });
예제 2: Body 없이 keepalive 사용 (GET 요청의 경우)
GET 요청에는 body를 포함할 수 없으므로, keepalive: true를 사용하더라도 데이터 전송의 의미는 없습니다. 다만, 특정 URL에 대한 '접근' 기록 등의 용도로는 활용될 수 있습니다. 그러나 이 경우에도 navigator.sendBeacon이 더 적합할 수 있습니다.
1async function pingServer() { 2 try { 3 await fetch('/api/ping', { 4 method: 'GET', 5 keepalive: true // GET 요청에서는 큰 의미가 없을 수 있습니다. 6 }); 7 console.log('Ping request sent (or queued for sending).'); 8 } catch (error) { 9 console.error('Error sending ping request:', error); 10 } 11} 12 13// 페이지 언로드 시점에 ping 14// window.addEventListener('unload', pingServer);
keepalive vs navigator.sendBeacon()
keepalive 옵션은 navigator.sendBeacon() API와 유사한 목적을 가집니다. 둘 다 사용자가 페이지를 떠난 후에도 백그라운드에서 데이터를 전송할 수 있도록 합니다. 하지만 몇 가지 차이점이 있습니다.
- API 형태:
keepalive는 Fetch API의 옵션으로 통합되어 있어, 기존 Fetch 코드를 수정하기 용이합니다. 반면navigator.sendBeacon()은 별도의 함수입니다. - 응답 처리:
navigator.sendBeacon()은 성공적으로 전송되면true를 반환하지만, 서버 응답을 직접 받을 수는 없습니다.keepalive옵션이 있는 Fetch 요청은 이론적으로 응답을 받을 수 있으나, 앞서 언급했듯이 페이지가 닫힌 후에는 이를 처리하기 어렵습니다. - 지원:
navigator.sendBeacon()은 비교적 넓은 범위의 브라우저에서 지원됩니다.keepalive는 최신 브라우저 위주로 지원됩니다.
일반적으로, 단순히 데이터를 서버로 보내는 것이 목적이라면 navigator.sendBeacon()이 더 간결하고 명확할 수 있습니다. 하지만 이미 Fetch API를 사용하고 있고, 응답 처리에 대한 복잡성을 감수할 수 있다면 keepalive 옵션도 좋은 대안이 될 수 있습니다.
결론
Fetch API의 keepalive 옵션은 사용자가 페이지를 떠나는 상황에서도 중요한 네트워크 요청을 놓치지 않고 완료할 수 있도록 돕는 유용한 기능입니다. 이를 통해 데이터 손실을 방지하고 사용자 경험을 개선할 수 있습니다. 다만, 메서드 제한, Body 크기, 응답 처리의 복잡성, 브라우저 지원 등 고려해야 할 사항들을 충분히 인지하고 신중하게 사용해야 합니다. 특히, 응답 처리가 중요한 경우에는 서비스 워커와 같은 다른 메커니즘을 함께 고려하는 것이 좋습니다.
핵심 요약: keepalive: true는 페이지가 닫혀도 Fetch 요청을 백그라운드에서 계속 실행시켜, 중요한 데이터 전송을 보장합니다.
참고 자료: