curl-ді Node.js тіліне түрлендіру

Q: Node.js http модулі дегеніміз не?

http және https модульдері — ешқандай тәуелділіксіз HTTP сұрауларын жасауға арналған Node.js-тің кірістірілген модульдері. Олар сұрау/жауап ағындарын (streams) төменгі деңгейде басқаруды қамтамасыз етеді. Жоғары деңгейлі баламалар үшін curl2code сонымен қатар axios, node-fetch, got, ky және superagent кітапханаларын қолдайды.

Q: http, axios, node-fetch және got — қайсысын қолданған жөн?

http — тәуелділіксіз, бірақ тым егжей-тегжейлі. axios интерцепторлары мен автоматты JSON парсингі бар таза API ұсынады. node-fetch браузердегі Fetch API-ін қайталайды. got қайталаулар, пагинация және ағындар сияқты мүмкіндіктерге бай. Жоба қажеттіліктеріне қарай таңдаңыз. Браузерлік JavaScript үшін біздің curl-ді JavaScript-ке түрлендіргішті қараңыз.

Q: Node.js-те аутентификацияны қалай өңдеуге болады?

Опциялар объектісінде Authorization тақырыбын орнатыңыз. Basic аутентификациясы үшін Buffer.from(user + ':' + pass).toString('base64') қолданыңыз. axios-та кірістірілген auth конфигурация опциясын қолданыңыз. curl2code барлық қолдау көрсетілетін Node.js кітапханалары үшін -u және Bearer токен жалаушаларын түрлендіреді.

Q: Node.js-те multipart форма деректерін қалай жіберуге болады?

Кірістірілген http модулімен multipart body-ді қолмен құрастырыңыз немесе form-data пакетін қолданыңыз. axios-та body ретінде FormData данасын жіберіңіз. Node.js 18+ нұсқасында кірістірілген FormData класы бар. curl2code әрбір кітапхана нұсқасы үшін -F жалаушаларын өңдейді.

Q: Node.js-те HTTP қателерін қалай өңдеуге болады?

http модулінде сұраудағы 'error' оқиғасын тыңдаңыз және response.statusCode тексеріңіз. axios-та 2xx емес күй кодтары үшін қателер лақтырылады және оларды try/catch арқылы ұстауға болады. got кітапханасында осы үлгіні және сәтсіздік кезіндегі кірістірілген қайталау логикасын қолданыңыз.

Q: Node.js-те стримингтік жауаптарды қалай өңдеуге болады?

http модулі әдепкі бойынша оқылатын ағынды (readable stream) қайтарады — оны response.pipe(fs.createWriteStream('file')) арқылы бағыттаңыз. got-та got.stream(url) қолданыңыз. axios-та responseType: 'stream' орнатыңыз. Стриминг үлкен файлдар үшін өте қолайлы және жауаптарды толығымен жадқа жүктеуден сақтайды.

Q: Node.js HTTP сұрауларында таймауттарды қалай орнатуға болады?

http модулінде опцияларда timeout жіберіңіз және 'timeout' оқиғасын тыңдаңыз, содан кейін req.destroy() шақырыңыз. Axios timeout-ты миллисекундпен қабылдайды. Got timeout.request-ты да, реттелетін кідірісі бар кірістірілген автоматты қайталауларды да қолдайды.

Q: Node.js-те проксиді қалай қолдануға болады?

Кірістірілген http модулі прокси туннельдеуді қолмен жасауды талап етеді. https-proxy-agent немесе http-proxy-agent пакеттерін қолданыңыз. Axios proxy конфигурациясы арқылы проксилерді қолдайды. Got прокси агенттерімен agent опциясын қолданады. curl2code -x және --proxy жалаушаларын тиісінше түрлендіреді.

Q: Node.js ортасында JSON денесі бар POST сұрауын қалай жіберуге болады?

curl2code құралын пайдаланып, curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL сияқты curl POST командасын Node.js кодына түрлендіріңіз. Жасалған код axios.post(url, { key: 'value' }) функциясын пайдаланады. curl2code құралы JSON мазмұны бар -d/--data жалаушаларын автоматты түрде анықтайды және axios кодында тиісті Content-Type тақырыбын орнатады.

Q: Node.js ортасында Bearer токенімен авторизацияны қалай қосуға болады?

curl2code құралына curl -H "Authorization: Bearer YOUR_TOKEN" URL командасын беріңіз, ол келесі авторизация тақырыбы бар axios кодын жасайды: headers: { Authorization: 'Bearer YOUR_TOKEN' }. curl2code құралы Bearer токендерін -H "Authorization: Bearer ..." және --oauth2-bearer жалаушаларынан анықтайды. Basic auth үшін -u user:pass пайдаланыңыз.

curl командаларын кірістірілген http модулін пайдаланып, Node.js кодына түрлендіріңіз. curl2code толығымен браузеріңізде WebAssembly арқылы орындалады — API кілттеріңіз бен деректеріңіз құпия сақталады. Браузер жағындағы JavaScript үшін біздің curl-ді JavaScript-ке түрлендіргішімізді қараңыз. Егер Python-ды қаласаңыз, curl-ді Python-ға қолданып көріңіз. Төменде пайдалануға дайын мысалдарды таба аласыз.

Браузерден curl-ді қалай көшіруге болады

1
DevTools-ты ашу
Браузердің әзірлеуші құралдарын ашу үшін F12 пернесін немесе Ctrl+Shift+I басыңыз.
2
Network қойындысына өтіңіз
Network қойындысын басып, HTTP сұрауын тудыратын әрекетті орындаңыз.
3
cURL ретінде көшіру
Сұрауды оң жақ түймемен басыңыз → Copy → Copy as cURL. Содан кейін оны жоғарыдағы өріске қойыңыз.

Node.js кодының мысалдары

1Қарапайым GET сұрауы

curl командасы

curl https://api.example.com/users

Node.js · http

import https from 'https';

const req = https.get('https://api.example.com/users', function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

2JSON денесі бар POST сұрауы

curl командасы

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

Node.js · http

import https from 'https';

const options = {
  hostname: 'api.example.com',
  path: '/users',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  }
};

const req = https.request(options, function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({
  'name': 'John',
  'email': 'john@example.com'
}));
req.end();

3Bearer токені бар сұрау

curl командасы

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

Node.js · http

import https from 'https';

const options = {
  hostname: 'api.example.com',
  path: '/me',
  headers: {
    'Authorization': 'Bearer token123'
  }
};

const req = https.get(options, function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

4Multipart формасын жүктеу

curl командасы

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

Node.js · http

import https from 'https';
import FormData from 'form-data';
import * as fs from 'fs';

const form = new FormData();
form.append('file', fs.readFileSync('document.pdf'), 'document.pdf');
form.append('description', 'My file');

const options = {
  hostname: 'api.example.com',
  path: '/upload',
  method: 'POST',
  headers: form.getHeaders()
};

const req = https.request(options, function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

form.pipe(req);

5Реттелетін тақырыптар

curl командасы

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

Node.js · http

import https from 'https';

const options = {
  hostname: 'api.example.com',
  path: '/data',
  headers: {
    'X-API-Key': 'abc123',
    'Accept': 'application/json',
    'X-Request-ID': 'req-456'
  }
};

const req = https.get(options, function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

Жиі қойылатын сұрақтар

Node.js http модулі дегеніміз не?

http және https модульдері — ешқандай тәуелділіксіз HTTP сұрауларын жасауға арналған Node.js-тің кірістірілген модульдері. Олар сұрау/жауап ағындарын (streams) төменгі деңгейде басқаруды қамтамасыз етеді. Жоғары деңгейлі баламалар үшін curl2code сонымен қатар axios, node-fetch, got, ky және superagent кітапханаларын қолдайды.

http, axios, node-fetch және got — қайсысын қолданған жөн?

http — тәуелділіксіз, бірақ тым егжей-тегжейлі. axios интерцепторлары мен автоматты JSON парсингі бар таза API ұсынады. node-fetch браузердегі Fetch API-ін қайталайды. got қайталаулар, пагинация және ағындар сияқты мүмкіндіктерге бай. Жоба қажеттіліктеріне қарай таңдаңыз. Браузерлік JavaScript үшін біздің curl-ді JavaScript-ке түрлендіргішті қараңыз.

Node.js-те аутентификацияны қалай өңдеуге болады?

Опциялар объектісінде Authorization тақырыбын орнатыңыз. Basic аутентификациясы үшін Buffer.from(user + ':' + pass).toString('base64') қолданыңыз. axios-та кірістірілген auth конфигурация опциясын қолданыңыз. curl2code барлық қолдау көрсетілетін Node.js кітапханалары үшін -u және Bearer токен жалаушаларын түрлендіреді.

Node.js-те multipart форма деректерін қалай жіберуге болады?

Кірістірілген http модулімен multipart body-ді қолмен құрастырыңыз немесе form-data пакетін қолданыңыз. axios-та body ретінде FormData данасын жіберіңіз. Node.js 18+ нұсқасында кірістірілген FormData класы бар. curl2code әрбір кітапхана нұсқасы үшін -F жалаушаларын өңдейді.

Node.js-те HTTP қателерін қалай өңдеуге болады?

http модулінде сұраудағы 'error' оқиғасын тыңдаңыз және response.statusCode тексеріңіз. axios-та 2xx емес күй кодтары үшін қателер лақтырылады және оларды try/catch арқылы ұстауға болады. got кітапханасында осы үлгіні және сәтсіздік кезіндегі кірістірілген қайталау логикасын қолданыңыз.

Node.js-те стримингтік жауаптарды қалай өңдеуге болады?

http модулі әдепкі бойынша оқылатын ағынды (readable stream) қайтарады — оны response.pipe(fs.createWriteStream('file')) арқылы бағыттаңыз. got-та got.stream(url) қолданыңыз. axios-та responseType: 'stream' орнатыңыз. Стриминг үлкен файлдар үшін өте қолайлы және жауаптарды толығымен жадқа жүктеуден сақтайды.

Node.js HTTP сұрауларында таймауттарды қалай орнатуға болады?

http модулінде опцияларда timeout жіберіңіз және 'timeout' оқиғасын тыңдаңыз, содан кейін req.destroy() шақырыңыз. Axios timeout-ты миллисекундпен қабылдайды. Got timeout.request-ты да, реттелетін кідірісі бар кірістірілген автоматты қайталауларды да қолдайды.

Node.js-те проксиді қалай қолдануға болады?

Кірістірілген http модулі прокси туннельдеуді қолмен жасауды талап етеді. https-proxy-agent немесе http-proxy-agent пакеттерін қолданыңыз. Axios proxy конфигурациясы арқылы проксилерді қолдайды. Got прокси агенттерімен agent опциясын қолданады. curl2code -x және --proxy жалаушаларын тиісінше түрлендіреді.

Node.js ортасында JSON денесі бар POST сұрауын қалай жіберуге болады?

curl2code құралын пайдаланып, curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL сияқты curl POST командасын Node.js кодына түрлендіріңіз. Жасалған код axios.post(url, { key: 'value' }) функциясын пайдаланады. curl2code құралы JSON мазмұны бар -d/--data жалаушаларын автоматты түрде анықтайды және axios кодында тиісті Content-Type тақырыбын орнатады.

Node.js ортасында Bearer токенімен авторизацияны қалай қосуға болады?

curl2code құралына curl -H "Authorization: Bearer YOUR_TOKEN" URL командасын беріңіз, ол келесі авторизация тақырыбы бар axios кодын жасайды: headers: { Authorization: 'Bearer YOUR_TOKEN' }. curl2code құралы Bearer токендерін -H "Authorization: Bearer ..." және --oauth2-bearer жалаушаларынан анықтайды. Basic auth үшін -u user:pass пайдаланыңыз.

Node.js ортасында Content-Type тақырыбын қалай орнатуға болады?

curl2code құралы curl -H "Content-Type: application/json" URL командасын тиісті тақырыбы бар axios кодына түрлендіреді: headers: { 'Content-Type': 'application/json' }. -d деректері үшін curl әдепкі бойынша application/x-www-form-urlencoded мәнін пайдаланады; -F форма жүктеулері үшін ол multipart/form-data мәнін қолданады. curl2code әрқайсысын дұрыс axios API интерфейсіне сәйкестендіреді.

Пайдалы сілтемелер

http құжаттамасы

nodejs.org

Стандартты кітапхана анықтамалығы

github.com

curl нұсқаулығы (Man Page)

curl.se

curl нұсқаулықтары

curl қате кодтары

Кез келген curl шығу кодын іздеңіз — себептері, түзетулері және жөндеу кеңестері.

curl арқылы файлдарды жүктеу

Файлдарды -o, -O арқылы сақтаңыз, қайта бағыттауларды орындаңыз, жүктеуді жалғастырыңыз және тағы басқа.

SSL, TLS және прокси

Сертификаттарды, TLS нұсқаларын, HTTP/SOCKS проксилерін және реттелетін DNS-ті конфигурациялау.

Браузерден curl-ді қалай көшіруге болады

Node.js кодының мысалдары

1Қарапайым GET сұрауы

2JSON денесі бар POST сұрауы

3Bearer токені бар сұрау

4Multipart формасын жүктеу

5Реттелетін тақырыптар

Жиі қойылатын сұрақтар

Пайдалы сілтемелер

curl нұсқаулықтары

curl-ді басқа тілдерге түрлендіру

Node.js кодының мысалдары

1Қарапайым GET сұрауы

2JSON денесі бар POST сұрауы

3Bearer токені бар сұрау

4Multipart формасын жүктеу

5Реттелетін тақырыптар