Interceptors

interceptor를 사용하면 요청이 만들어지기 전이나 응답을 받은 후에 코드를 실행할 수 있습니다. 인증 토큰 추가, 로깅, 응답 변환과 같은 공통 로직을 중앙에서 관리하는 데 유용합니다.

Import


import { interceptors } from "next-nexus";

Interceptor 등록하기

interceptor는 전역으로 등록되며, 고유한 이름으로 식별됩니다.


// 보통 중앙 설정 파일에서 등록합니다.
 
// 요청 헤더에 인증 정보를 추가하는 요청 인터셉터
interceptors.request.use("auth", async (config) => {
  const headers = new Headers(config.headers);
  headers.set("authorization", "Bearer <token>");
  return { ...config, headers };
});
 
// 로깅을 위한 응답 인터셉터
interceptors.response.use("timing", async (res, req) => {
  console.log(`'${req.endpoint}' 요청에 ${res.headers.get('X-Response-Time')} 소요됨`);
  return res;
});

Interceptor 적용하기

등록된 interceptor를 요청에 적용하려면, definition의 interceptors 배열에 해당 이름을 추가합니다.


import { createNexusDefinition } from 'next-nexus'
 
export const createApiDefinition = createNexusDefinition({
  baseURL: 'https://api.example.com',
});
 
// 이 definition은 'auth'와 'timing' 인터셉터를 실행합니다.
const definition = createApiDefinition<{ items: unknown[] }>({
  method: 'GET',
  endpoint: '/protected',
  interceptors: ['auth', 'timing'],
});

참고 (Notes)

실행 순서: interceptors 배열에 나열된 순서대로 실행됩니다.
스코프 (Scope): 서버 전용 코드와 클라이언트 전용 코드를 주의해서 다루세요. 서버 전용 모듈(예: Node.js 라이브러리)을 사용하는 interceptor는 클라이언트에서 실행되는 definition에 사용되어서는 안 됩니다.
오류 (Errors): interceptor 내에서 오류를 던지면(throw) 요청이 실패하고 NexusError가 전파됩니다.
직렬화 (Serialization): interceptor 이름은 직렬화되므로, RSC의 서버-클라이언트 경계를 넘어 안전하게 동작합니다.

함께 보기

Definitions