REST API 업무 자동화 fetch 인증 페이지네이션 기준

응답을 주입해 페이지 종료와 HTTP 오류 확인

Node.js 24의 Response를 사용해 API 응답을 메모리에서 만듭니다. 네트워크나 인증 토큰 없이 HTTP 실패·다음 cursor·반복 cursor를 연습합니다. 실제 제공자의 인증 성공이나 호출 한도를 검증하는 예제는 아닙니다.

pagination-demo.mjs 전체 코드

async function readPages(fetchPage) {
  const seen = new Set();
  const items = [];
  let cursor = '';
  for (let page = 0; page < 5; page += 1) {
    if (seen.has(cursor)) throw new Error('반복 cursor');
    seen.add(cursor);
    const response = await fetchPage(cursor);
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    const data = await response.json();
    if (!Array.isArray(data.items)) throw new Error('items 배열 필요');
    items.push(...data.items);
    if (data.nextCursor === null) return items;
    if (typeof data.nextCursor !== 'string') throw new Error('cursor 형식 오류');
    cursor = data.nextCursor;
  }
  throw new Error('최대 페이지 초과');
}
const pages = {
  '': { items: ['a'], nextCursor: 'p2' },
  p2: { items: ['b'], nextCursor: null },
};
console.log((await readPages(async cursor => Response.json(pages[cursor]))).join(','));
for (const fetchPage of [
  async () => new Response('', { status: 401 }),
  async () => Response.json({ items: [], nextCursor: '' }),
]) {
  try { await readPages(fetchPage); }
  catch (error) { console.log(error.message); }
}

저장한 폴더에서 node pagination-demo.mjs로 실행합니다. 예상 출력은 다음과 같습니다.

a,b
HTTP 401
반복 cursor

직접 바꿔 보기: p2의 items에 c를 추가해 a,b,c가 나오는지 확인합니다. nextCursor를 숫자로 바꾸면 cursor 형식 오류여야 합니다. 실제 API에 적용할 때에는 해당 API의 cursor 필드·인증 헤더 계약을 사용해야 합니다.