Got 어댑터

Got HTTP 클라이언트를 사용하는 Node.js 전용 어댑터입니다. 고성능과 풍부한 기능을 제공합니다.

설치

먼저 got을 설치해야 합니다:

npm install got
# 또는
yarn add got

기본 사용법

import { NeopleDFClient, NeopleCyphersClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
});

사용자 지정 Got 인스턴스

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const customGot = got.extend({
  timeout: {
    request: 30000,
  },
  headers: {
    'User-Agent': 'MyApp/1.0.0',
  },
  retry: {
    limit: 3,
    methods: ['GET', 'POST'],
  },
});

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: customGot,
});

고급 설정

재시도 정책

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    retry: {
      limit: 5,
      methods: ['GET', 'POST', 'PUT', 'DELETE'],
      statusCodes: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
      errorCodes: [
        'ETIMEDOUT',
        'ECONNRESET',
        'EADDRINUSE',
        'ECONNREFUSED',
        'EPIPE',
        'ENOTFOUND',
        'ENETUNREACH',
        'EAI_AGAIN',
      ],
      calculateDelay: ({ attemptCount }) => {
        // 지수 백오프 구현
        return Math.min(1000 * Math.pow(2, attemptCount - 1), 30000);
      },
    },
  }),
});

훅(Hooks) 사용

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    hooks: {
      beforeRequest: [
        options => {
          console.log('요청 전송:', options.url?.toString());
          console.log('헤더:', options.headers);
        },
      ],
      afterResponse: [
        response => {
          console.log('응답 받음:', response.statusCode);
          return response;
        },
      ],
      beforeError: [
        error => {
          console.error('오류 발생:', error.message);
          return error;
        },
      ],
    },
  }),
});

캐싱

인메모리 캐싱

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const cache = new Map();

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    cache: cache,
    cacheOptions: {
      shared: false,
      cacheHeuristic: 0.1,
      immutableMinTimeToLive: 24 * 3600 * 1000, // 24시간
      ignoreCargoCult: false,
    },
  }),
});

프록시 설정

HTTP/HTTPS 프록시

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    agent: {
      http: new HttpsProxyAgent('http://proxy.example.com:8080'),
      https: new HttpsProxyAgent('https://proxy.example.com:8080'),
    },
  }),
});

SOCKS 프록시

npm install socks-proxy-agent

import got from 'got';
import { SocksProxyAgent } from 'socks-proxy-agent';
import { NeopleDFClient } from 'neople-sdk-js';

const socksAgent = new SocksProxyAgent('socks5://127.0.0.1:1080');

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    agent: {
      http: socksAgent,
      https: socksAgent,
    },
  }),
});

타임아웃 설정

세분화된 타임아웃

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    timeout: {
      lookup: 100, // DNS 조회
      connect: 50, // 소켓 연결
      secureConnect: 50, // TLS 핸드셰이크
      socket: 1000, // 소켓 비활성
      send: 10000, // 요청 전송
      response: 1000, // 첫 번째 응답 바이트
      request: 30000, // 전체 요청
    },
  }),
});

HTTP/2 지원

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    http2: true,
    allowH2: true,
  }),
});

에러 처리

상세한 에러 정보

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  onError: error => {
    if (error instanceof got.HTTPError) {
      console.error('HTTP 에러:', {
        statusCode: error.response.statusCode,
        statusMessage: error.response.statusMessage,
        headers: error.response.headers,
        body: error.response.body,
      });
    } else if (error instanceof got.RequestError) {
      console.error('요청 에러:', error.message);
    } else if (error instanceof got.TimeoutError) {
      console.error('타임아웃 에러:', error.message);
    }
  },
});

성능 최적화

Keep-Alive 연결

import got from 'got';
import http from 'http';
import https from 'https';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    agent: {
      http: new http.Agent({
        keepAlive: true,
        keepAliveMsecs: 1000,
        maxSockets: 10,
        maxFreeSockets: 10,
      }),
      https: new https.Agent({
        keepAlive: true,
        keepAliveMsecs: 1000,
        maxSockets: 10,
        maxFreeSockets: 10,
      }),
    },
  }),
});

디버깅

상세 로깅

import got from 'got';
import { NeopleDFClient } from 'neople-sdk-js';

const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    hooks: {
      beforeRequest: [
        options => {
          console.log('🚀 요청 시작:', {
            method: options.method,
            url: options.url?.toString(),
            headers: options.headers,
          });
        },
      ],
      afterResponse: [
        response => {
          console.log('✅응답 완료:', {
            statusCode: response.statusCode,
            headers: response.headers,
            timing: response.timings,
          });
          return response;
        },
      ],
    },
  }),
});

마이그레이션

Axios에서 Got으로

// Before (Axios)
const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'axios',
  axiosInstance: axios.create({
    timeout: 30000,
    proxy: {
      host: 'proxy.example.com',
      port: 8080,
    },
  }),
});

// After (Got)
const client = new NeopleDFClient(apiKey, {
  httpAdapter: 'got',
  gotInstance: got.extend({
    timeout: {
      request: 30000,
    },
    agent: {
      https: new HttpsProxyAgent('http://proxy.example.com:8080'),
    },
  }),
});

Got 어댑터

On this page