curl을 TypeScript(으)로 변환
curl2code는 fetch API를 사용하여 curl 명령을 적절한 타입 어노테이션이 포함된 TypeScript 코드로 변환합니다. 변환은 WebAssembly를 통해 브라우저에서 실행되므로 데이터가 기기를 절대 떠나지 않습니다. 일반 JavaScript의 경우 curl to JavaScript 변환기를 확인하세요. 서버 측 코드의 경우 curl to Node.js를 참조하세요. 아래는 일반적인 시나리오에 대한 타입 정의가 포함된 예제입니다.
브라우저에서 curl을 복사하는 방법
- 1
DevTools 열기
F12 또는 Ctrl+Shift+I를 눌러 브라우저 개발자 도구를 엽니다.
- 2
Network 탭으로 이동
Network 탭을 클릭하고 HTTP 요청을 트리거하는 동작을 수행합니다.
- 3
cURL로 복사
요청을 마우스 오른쪽 버튼으로 클릭 → Copy → Copy as cURL을 선택합니다. 그런 다음 위에 붙여넣으세요.
자주 묻는 질문 (FAQ)
curl2code는 TypeScript를 위해 무엇을 생성하나요?
curl2code는 전체 타입 어노테이션이 포함된 브라우저 네이티브 fetch API를 사용하여 TypeScript 코드를 생성합니다. 생성된 코드에는 타입이 지정된 요청 옵션, 적절한 Response 처리 및 타입 안정성이 보장된 JSON 파싱이 포함됩니다. TypeScript는 일반 JavaScript에서 사용되는 것과 동일한 Fetch API에 컴파일 타임 안전성을 추가합니다.
TypeScript fetch와 JavaScript fetch의 차이점은 무엇인가요?
런타임 API는 동일하지만 TypeScript는 정적 타입 검사를 추가합니다. 타입이 지정된 Headers, RequestInit, Response 객체를 사용할 수 있습니다. 커스텀 응답 형태의 경우 인터페이스를 정의하고 await response.json() as MyType과 같이 캐스팅하세요. 서버 측 TypeScript의 경우 curl to Node.js 변환기를 확인하세요.
TypeScript에서 인증을 어떻게 처리하나요?
Fetch와 동일하게 타입이 지정된 Authorization 객체에 HeadersInit 헤더를 전달하세요. TypeScript는 타입이 지정된 헤더 헬퍼를 사용할 때 헤더 이름의 오타를 방지해 줍니다. curl2code는 -u 및 -H 'Authorization: ...' curl 플래그로부터 적절하게 타입이 지정된 인증 헤더를 생성합니다.
TypeScript로 폼 데이터를 어떻게 보내나요?
브라우저의 FormData API를 사용하세요. TypeScript에는 이를 위한 내장 타입 정의가 있습니다. 타입이 지정된 파라미터와 함께 formData.append('file', file)를 호출합니다. 컴파일러가 빌드 타임에 일치하지 않는 타입을 잡아냅니다. curl2code는 -F 플래그를 적절하게 타입이 지정된 FormData 호출로 변환합니다.
TypeScript에서 타입 안전하게 에러를 처리하는 방법은 무엇인가요?
try/catch와 함께 async/await를 사용하세요. catch 절의 에러를 unknown으로 타이핑하고 instanceof로 범위를 좁힙니다. 파싱 전에 response.ok를 확인하세요. API 전용 에러 형식을 위해 인터페이스로 타입이 지정된 에러 응답을 정의합니다. 이를 통해 모든 에러 경로가 처리되었음을 컴파일 타임에 보장받을 수 있습니다.
TypeScript에서 API 응답의 타입을 어떻게 지정하나요?
예상되는 응답 형태에 대한 인터페이스를 정의한 다음 const data: MyAPI = await response.json()을 사용하세요. 런타임 유효성 검사를 위해 zod 또는 io-ts와 함께 사용할 수도 있습니다. 이 패턴은 코드베이스 전체에서 타입 안정성을 보장합니다. 다른 언어에서의 유사한 타입 경험을 원하신다면 curl to Go 또는 curl to Rust를 참조하세요.
TypeScript에서 fetch에 타임아웃을 어떻게 설정하나요?
AbortController를 사용하세요. TypeScript에는 Abort API에 대한 전체 타입 정의가 포함되어 있습니다. const controller = new AbortController()를 생성하고 fetch에 signal을 전달한 뒤 setTimeout으로 중단(abort)합니다. AbortSignal.timeout(ms) 단축 표기법은 현대 TypeScript lib 타겟에서 타입이 지정되어 있습니다.
TypeScript에서 CORS를 어떻게 처리하나요?
CORS 처리는 JavaScript와 동일합니다. 이는 브라우저 보안 기능이지 TypeScript 기능이 아닙니다. 필요에 따라 mode: 'cors' 및 credentials: 'include'를 설정하면 TypeScript가 올바른 RequestMode 및 RequestCredentials 열거형 값을 사용하도록 보장합니다. CORS가 적용되지 않는 서버 측 요청의 경우 curl to Node.js를 참조하세요.
TypeScript에서 JSON 바디를 포함한 POST 요청을 보내는 방법은 무엇인가요?
curl2code를 사용하여 curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL과 같은 curl POST 명령어를 TypeScript로 변환하세요. 생성된 코드는 const response: Response = await fetch(url, { method: 'POST', body: JSON.stringify(data) })를 사용합니다. curl2code는 JSON 콘텐츠가 포함된 -d/--data 플래그를 자동으로 감지하고 fetch 코드에 적절한 Content-Type 헤더를 설정합니다.
TypeScript에서 Bearer 토큰 인증을 추가하는 방법은 무엇인가요?
curl -H "Authorization: Bearer YOUR_TOKEN" URL을 curl2code에 입력하면 headers: { Authorization: `Bearer ${token}` }와 같은 인증 헤더가 포함된 fetch 코드가 생성됩니다. curl2code는 -H "Authorization: Bearer ..." 및 --oauth2-bearer 플래그 모두에서 Bearer 토큰을 감지합니다. Basic auth의 경우 -u user:pass를 사용하세요.
TypeScript에서 Content-Type 헤더를 설정하는 방법은 무엇인가요?
curl2code는 curl -H "Content-Type: application/json" URL을 적절한 헤더가 포함된 fetch 코드로 변환합니다: headers: { 'Content-Type': 'application/json' } as HeadersInit. -d 데이터의 경우 curl은 기본적으로 application/x-www-form-urlencoded를 사용하며, -F 폼 업로드의 경우 multipart/form-data를 사용합니다. curl2code는 각각을 올바른 fetch API에 매핑합니다.