Node.js네트워크

fetch로 JSON 요청

Node.js 18+의 내장 `fetch`로 외부 API를 호출하고 JSON 응답을 읽는 기본 패턴입니다.

마지막 수정 2026년 3월 19일

기본 패턴

javascript
const response = await fetch("https://api.example.com/users/1");

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const user = await response.json();
console.log(user.name);

설명

  • 최근 Node.js에서는 브라우저와 비슷한 fetch를 기본 제공하므로 가벼운 API 호출에 바로 쓸 수 있습니다.
  • response.ok로 성공 여부를 확인하고, JSON이면 response.json()으로 파싱합니다.
  • 타임아웃이나 취소 처리가 필요하면 AbortController를 같이 붙이는 패턴이 자주 쓰입니다.

짧은 예제

javascript
const controller = new AbortController();
setTimeout(() => controller.abort(), 3000);

await fetch(url, { signal: controller.signal });

빠른 정리

호출의미
fetch(url)요청 보내기
response.ok2xx 성공 여부
response.json()JSON 파싱
AbortController요청 취소

주의할 점

HTTP 404나 500도 네트워크 자체는 성공일 수 있으니, catch만 믿지 말고 response.ok를 꼭 확인하세요.