자바스크립트 fetch만 써도 웹개발 API 연결이 충분할까?
검색창 하나를 만들며 fetch부터 시험했습니다
후기의 출발점은 작은 상품 검색입니다
검색어는 바뀌었는데 결과는 이전 단어로 돌아간다면 API 연결이 끝났다고 할 수 있을까요? 저는 자바스크립트 fetch로 검색 데이터를 읽는 흐름을 실습하면서, 짧은 호출 코드보다 응답을 받아들이는 기준이 중요하다고 느꼈습니다.
이번 후기는 Node.js 24.12.0의 내장 fetch와 Response 객체로 직접 실행한 결과를 바탕으로 합니다. data URL과 모의 응답을 사용해 정상 데이터, 오류 상태, 빈 본문, 취소, 응답 순서 등을 확인했으며 실습 범위는 데이터 처리와 결과 선택의 정확성에 한정했습니다. 브라우저의 화면 렌더링 속도는 측정하지 않았습니다.
- 입력: 상품명인 ‘키’와 ‘키보드’를 차례로 조회하는 상황입니다.
- 출력: 상품 배열을 읽고 최신 요청의 결과만 채택하도록 구성했습니다.
처음 코딩을 배우는 독자라면 지식백과의 코딩 항목도 함께 참고할 수 있습니다. 여기서는 문법을 넓게 다루기보다 작은 요청 하나를 끝까지 처리하는 경험에 집중합니다.
설치할 것이 없어서 시작은 가벼웠습니다
데이터를 받는 일과 화면 상태를 나눕니다
마음에 들었던 점은 별도 HTTP 클라이언트 패키지 설치 없이 실습을 시작할 수 있다는 것입니다. 주소를 정하고 fetch를 호출한 뒤 응답 본문을 읽는 흐름이 드러나므로, 웹개발 입문자가 요청과 데이터의 관계를 따라가기 좋았습니다.
다만 호출 한 줄이 검색 기능 전체를 완성해 주지는 않습니다. 저는 실습 결과를 화면에 연결한다면 어떤 상태가 필요한지 먼저 적었고, 이 구분이 있어야 빈 목록을 장애로 오해하거나 검색 중에 같은 버튼을 계속 누르는 상황을 줄일 수 있다고 봤습니다.
- 대기와 로딩: 아직 검색하지 않은 상태와 데이터를 기다리는 상태를 구별합니다.
- 성공과 빈 결과: 요청이 정상이어도 상품 배열이 비어 있으면 별도 안내가 필요합니다.
- 실패: 사용자가 다음 행동을 선택할 수 있도록 재시도 버튼이나 검색어 유지 여부를 정합니다.
fetch 자체에는 별도 이용료가 없지만 호출 대상 API의 요금과 서버 비용은 따로 확인해야 합니다. 작은 조회 화면에서는 이 단순함이 장점이고, 상태 처리를 직접 설계해야 하는 점은 개발 비용으로 남습니다.
404를 만나니 성공 판단부터 달라졌습니다
catch만으로 HTTP 오류를 걸러낼 수 없습니다
이번 실습에서는 404 상태를 가진 Response 객체를 만들어 ok 값을 확인했고, 결과는 false였습니다. HTTP 오류 상태만으로 fetch가 거부되지는 않는다는 동작은 [MDN의 fetch 문서](https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch)로 확인했으며, 실제 서버의 404 응답을 받은 실험과는 구분합니다.
이를 코드에 적용한다면 응답 상태 확인을 본문 사용보다 앞에 둡니다. 정상 상품 데이터와 오류 메시지를 구분하도록 처리 순서를 나눴습니다.
- 먼저 response.ok를 확인하고, 실패 상태라면 오류 처리 흐름으로 넘깁니다.
- 성공한 응답은 API 계약에 맞게 본문을 읽고 상품 배열을 꺼냅니다.
- 오류 응답에 상세 메시지가 필요하다면 오류용 형식으로 따로 해석합니다.
요청의 완료와 원하는 데이터의 도착은 따로 확인합니다. 성공 조건을 적어 두면 코드 리뷰에서도 같은 기준으로 이야기할 수 있습니다.
독자 여러분의 API도 실패할 때 상품 배열 대신 메시지 객체를 보내나요? 그 차이를 확인하지 않고 목록 그리기 함수에 넘기면, 배열 처리 오류까지 생겨 원인을 찾기 어려워집니다.
빈 응답에는 JSON 변환을 붙이지 않았습니다
본문을 읽기 전에 응답 계약을 확인합니다
가장 선명했던 결과는 204 상태의 빈 Response였습니다. ok는 true였지만 json()을 호출하자 SyntaxError가 발생했습니다. 성공 상태이면 무조건 JSON 데이터가 있다고 생각하면 안 된다는 점을 직접 확인한 셈입니다.
상품 목록 조회에서는 JSON 배열을 받더라도, 삭제 기능은 본문 없이 성공 상태만 반환하도록 설계할 수 있습니다. 저는 공통 요청 함수를 만든다면 ‘JSON을 받는 요청’과 ‘본문이 없는 요청’을 호출부에서 구별할 수 있게 두는 편이 읽기 쉽다고 느꼈습니다.
- 목록 조회: 기대하는 응답이 배열인지, items 속성을 가진 객체인지 먼저 확인합니다.
- 본문 없는 성공: API 명세에서 약속한 상태를 확인하고 JSON 파싱을 생략합니다.
- 예상 밖 본문: 로그인 페이지나 오류 HTML이 온 경우를 빈 배열로 덮지 않습니다.
모든 실패를 빈 목록으로 바꾸면 화면은 조용해져도 실제 장애와 검색 결과 없음이 섞입니다. 프로그래밍 튜토리얼을 응용할 때는 코드의 줄 수보다 서버가 무엇을 돌려준다고 약속했는지를 먼저 확인하는 습관이 도움이 됩니다.
빠른 타이핑에서는 응답 순서가 더 중요했습니다
먼저 요청해도 나중에 끝날 수 있습니다
‘키’에는 100밀리초, ‘키보드’에는 10밀리초의 인위적인 대기를 넣고 각각 데이터를 읽었습니다. 실습의 완료 순서는 ‘키보드 → 키’였으며, 이 수치는 네트워크 성능이 아닌 상황 재현용 설정입니다.
응답이 올 때마다 결과를 교체한다면 마지막에 끝난 ‘키’가 최신 검색어 ‘키보드’의 결과를 덮을 수 있습니다. 요청마다 번호를 붙여 현재 번호와 같은 응답만 채택하도록 바꿨습니다.
- 요청 번호: 검색을 시작할 때 증가시키고 각 작업이 자기 번호를 보관합니다.
- 반영 조건: 본문을 읽은 뒤에도 최신 번호인지 확인한 다음 결과를 바꿉니다.
- 상태 갱신: 이전 요청의 오류나 종료 처리가 새 요청의 안내를 덮지 않게 같은 기준을 적용합니다.
검색 입력이 빠른 화면에서는 ‘무엇이 마지막에 도착했나’보다 ‘사용자가 마지막으로 무엇을 요청했나’를 기준으로 삼습니다.
취소된 signal을 fetch에 전달하는 별도 실습에서는 AbortError도 확인했습니다. 취소와 최신 결과 판별은 역할이 다르므로, 결과를 채택하는 조건부터 명시하는 편이 이해하기 쉬웠습니다.
기능이 늘면 직접 관리할 코드도 늘어납니다
가벼운 시작과 유지보수 부담을 함께 봅니다
직접 써보며 느낀 장점은 요청부터 데이터 해석까지 흐름을 따라가기 쉽다는 것입니다. 반면 여러 화면에 같은 상태 확인과 오류 처리를 복사한다고 생각하니, 처음의 짧은 코드가 계속 짧게 유지되지는 않겠다는 단점도 보였습니다.
저라면 상품 조회 하나에서는 fetch로 시작하고, 반복되는 요구가 드러날 때 공통 함수나 관련 도구의 도입을 검토합니다. 기능 개수보다 중복된 책임을 기준으로 삼으면, 필요하지 않은 추상화를 먼저 만드는 일을 줄일 수 있습니다.
- 오류 표시가 제각각이면 공통 오류 형식부터 정해 호출부의 판단을 단순하게 만듭니다.
- 동일 데이터의 재사용이 필요하면 저장 기간과 갱신 조건을 먼저 정의합니다.
- 자동 재시도를 붙이기 전에는 조회와 저장 요청의 실패 후 영향을 구별합니다.
용어가 낯설다면 지식백과의 프로그래밍 항목을 보조 자료로 참고할 수 있습니다. 제 선택 기준은 추가 도구가 팀의 반복 작업을 실제로 줄이는가이며, 특정 패키지를 쓰는 것 자체가 목표는 아닙니다.
키보드 검색이 키 결과로 돌아가지 않게 만들었습니다
같은 입력을 다시 넣어 수정 결과를 확인합니다
마지막으로 앞서 사용한 두 검색어를 그대로 넣고, 요청 번호를 검사하는 코드가 어떤 결과를 남기는지 확인했습니다. 화면 대신 결과를 채택한 배열을 관찰 대상으로 삼아 수정 전후의 차이를 명확하게 기록했습니다.
- ‘키’를 첫 번째 요청으로 등록하고 100밀리초의 대기를 적용합니다.
- 곧이어 ‘키보드’를 두 번째 요청으로 등록하고 10밀리초의 대기를 적용합니다.
- 먼저 끝난 두 번째 요청은 현재 번호와 같으므로 ‘키보드’를 결과 배열에 넣습니다.
- 뒤늦게 끝난 첫 번째 요청은 번호가 다르므로 결과 배열을 바꾸지 않습니다.
화면에 옮길 때는 로딩 종료와 오류 안내에도 번호 검사를 적용해야 합니다. 첫 요청이 늦게 실패하더라도 두 번째 요청의 정상 목록을 오류 화면으로 바꾸지 않도록, 사용자의 마지막 검색 의도를 기준으로 삼는 것입니다.
번호 검사가 없을 때 완료 기록에는 ‘키보드’ 다음 ‘키’가 들어갔습니다. 조건을 적용한 뒤에는 결과 배열에 ‘키보드’만 남았고, 배열이 기대값과 같은지 확인하는 assertion도 통과했습니다.

- 이전글서버 렌더링과 클라이언트 렌더링, 웹개발의 기준이 바뀐다 26.11.21
- 다음글카페에서 웹개발 코딩할 때 바로 쓰는 숨은 팁들 26.10.14
등록된 댓글이 없습니다.
