fetchData
Node.js 런타임 필요 ('qsu/node')이 함수는 node:fetch를 조금 더 쉽게 사용하면서도 응답 상태에 상관 없이 데이터를 반환받기 위해 사용됩니다. 기본적으로 GET method를 사용하지만 별도 옵션으로 POST 등의 method도 사용할 수 있습니다.
요청 URL의 Content-Type에 따라 반환하는 데이터 형식이 string이거나 object일 수 있습니다.
응답에 실패했거나 204 (No Content) 응답 코드일 때, 에러가 발생했을 때에도 별도의 exception 없이 nullNone을 반환합니다.
다만 onError 이벤트를 통해 에러를 받아볼 수 있습니다.
Parameters
| 이름 | 타입 | 필수 | 기본값 |
|---|---|---|---|
url | stringstr | ● | – |
httpRequestOptions | HTTPRequestOption | – | – |
| 요청 옵션입니다. 아래 표를 참고하세요. | |||
HTTPRequestOption| 이름 | 타입 | 필수 | 기본값 |
|---|---|---|---|
auth | objectdict | – | – |
| 인증 정보입니다. 아래 표를 참고하세요. | |||
get | booleanbool | – | – |
Same as method: 'get' | |||
post | booleanbool | – | – |
Same as method: 'post' | |||
put | booleanbool | – | – |
Same as method: 'put' | |||
delete | booleanbool | – | – |
Same as method: 'delete' | |||
patch | booleanbool | – | – |
Same as method: 'patch' | |||
toStream | booleanbool | – | – |
timeout | numberint | – | – |
method | 'get' | 'post' | 'put' | 'delete' | 'patch' | – | – |
host | stringstr | – | – |
| If this value is not specified, the URL must be a full path. | |||
queryParameters | objectdict | – | – |
body | object | string | FormData | nulldict | str | FormData | None | – | – |
bodyType | 'text' | 'json' | 'form-data' | 'x-www-form-urlencoded' | – | – |
headers | object | nulldict | None | – | – |
onError | functionCallable | – | – |
| (error) => void | |||
auth| 이름 | 타입 | 필수 | 기본값 |
|---|---|---|---|
apiKey | stringstr | – | – |
| 'x-API-key' header | |||
bearer | stringstr | – | – |
| 'Authorization Bearer' header | |||
Returns
Promise<string | object | null>
str | dict | None
Examples
javascript
console.log(await fetchData('https://github.com'), { get: true });python
print(fetchData('https://github.com'), { 'get': True })