Конвертировать curl в Node.js

Q: Что такое модуль Node.js http?

Модули http и https — это встроенные модули Node.js для выполнения HTTP-запросов без каких-либо зависимостей. Они обеспечивают низкоуровневый контроль над потоками запросов/ответов. В качестве высокоуровневых альтернатив curl2code также поддерживает axios, node-fetch, got, ky и superagent.

Q: http против axios против node-fetch против got — что использовать?

http не имеет зависимостей, но избыточен в коде. axios предлагает чистый API с интерцепторами и автоматическим парсингом JSON. node-fetch дублирует браузерный Fetch API. got богат функциями, такими как повторы, пагинация и потоки. Выбирайте исходя из потребностей проекта. Для браузерного JavaScript см. наш конвертер curl в JavaScript.

Q: Как обрабатывать аутентификацию в Node.js?

Установите заголовок Authorization в объекте опций. Для Basic-аутентификации используйте Buffer.from(user + ':' + pass).toString('base64'). В axios используйте встроенную опцию конфигурации auth. curl2code конвертирует флаги -u и токены Bearer для всех поддерживаемых библиотек Node.js.

Q: Как отправить multipart form data в Node.js?

Со встроенным модулом http создайте тело multipart вручную или используйте пакет form-data. В axios передайте экземпляр FormData в качестве тела. В Node.js 18+ есть встроенный класс FormData. curl2code обрабатывает флаги -F для каждого варианта библиотеки.

Q: Как обрабатывать ошибки HTTP в Node.js?

В http слушайте событие 'error' в запросе и проверяйте response.statusCode. В axios ошибки выбрасываются для статус-кодов, отличных от 2xx, и могут быть перехвачены в try/catch. В got используйте тот же паттерн плюс встроенную логику повторов при сбое.

Q: Как обрабатывать потоковые ответы в Node.js?

Модуль http по умолчанию возвращает читаемый поток — направьте его с помощью response.pipe(fs.createWriteStream('file')). В got используйте got.stream(url). В axios установите responseType: 'stream'. Стриминг идеально подходит для больших файлов и позволяет избежать загрузки всего ответа в память.

Q: Как установить таймауты в HTTP-запросах Node.js?

В 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: Как отправить POST-запрос с телом JSON в Node.js?

Преобразуйте команду curl POST, такую как curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL, в Node.js с помощью curl2code. Сгенерированный код использует axios.post(url, { key: 'value' }). curl2code автоматически обнаруживает флаги -d/--data с содержимым JSON и устанавливает соответствующий заголовок Content-Type в коде axios.

Q: Как добавить авторизацию через Bearer token в Node.js?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL в curl2code, и инструмент сгенерирует код axios с заголовком авторизации: headers: { Authorization: 'Bearer YOUR_TOKEN' }. curl2code распознает Bearer tokens как в флагах -H "Authorization: Bearer ...", так и в --oauth2-bearer. Для Basic auth используйте -u user:pass.

Конвертируйте команды curl в код Node.js с помощью встроенного модуля http. 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());
  });
});

2POST с телом JSON

команда 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();

3Запрос с Bearer-токеном

команда 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());
  });
});

4Загрузка Multipart Form

команда 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 — это встроенные модули Node.js для выполнения HTTP-запросов без каких-либо зависимостей. Они обеспечивают низкоуровневый контроль над потоками запросов/ответов. В качестве высокоуровневых альтернатив curl2code также поддерживает axios, node-fetch, got, ky и superagent.

http против axios против node-fetch против got — что использовать?

http не имеет зависимостей, но избыточен в коде. axios предлагает чистый API с интерцепторами и автоматическим парсингом JSON. node-fetch дублирует браузерный Fetch API. got богат функциями, такими как повторы, пагинация и потоки. Выбирайте исходя из потребностей проекта. Для браузерного JavaScript см. наш конвертер curl в JavaScript.

Как обрабатывать аутентификацию в Node.js?

Установите заголовок Authorization в объекте опций. Для Basic-аутентификации используйте Buffer.from(user + ':' + pass).toString('base64'). В axios используйте встроенную опцию конфигурации auth. curl2code конвертирует флаги -u и токены Bearer для всех поддерживаемых библиотек Node.js.

Как отправить multipart form data в Node.js?

Со встроенным модулом http создайте тело multipart вручную или используйте пакет form-data. В axios передайте экземпляр FormData в качестве тела. В Node.js 18+ есть встроенный класс FormData. curl2code обрабатывает флаги -F для каждого варианта библиотеки.

Как обрабатывать ошибки HTTP в Node.js?

В http слушайте событие 'error' в запросе и проверяйте response.statusCode. В axios ошибки выбрасываются для статус-кодов, отличных от 2xx, и могут быть перехвачены в try/catch. В got используйте тот же паттерн плюс встроенную логику повторов при сбое.

Как обрабатывать потоковые ответы в Node.js?

Модуль http по умолчанию возвращает читаемый поток — направьте его с помощью response.pipe(fs.createWriteStream('file')). В got используйте got.stream(url). В axios установите responseType: 'stream'. Стриминг идеально подходит для больших файлов и позволяет избежать загрузки всего ответа в память.

Как установить таймауты в HTTP-запросах Node.js?

В 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.

Как отправить POST-запрос с телом JSON в Node.js?

Преобразуйте команду curl POST, такую как curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL, в Node.js с помощью curl2code. Сгенерированный код использует axios.post(url, { key: 'value' }). curl2code автоматически обнаруживает флаги -d/--data с содержимым JSON и устанавливает соответствующий заголовок Content-Type в коде axios.

Как добавить авторизацию через Bearer token в Node.js?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL в curl2code, и инструмент сгенерирует код axios с заголовком авторизации: headers: { Authorization: 'Bearer YOUR_TOKEN' }. curl2code распознает Bearer tokens как в флагах -H "Authorization: Bearer ...", так и в --oauth2-bearer. Для Basic auth используйте -u user:pass.

Как установить заголовок Content-Type в Node.js?

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 сопоставляет каждый вариант с подходящим API axios.

Полезные ссылки

Документация http

nodejs.org

Справочник по стандартной библиотеке

github.com

Справочная страница curl (man)

curl.se

Руководства по curl

Коды ошибок curl

Найдите любой код завершения curl — причины, исправления и советы по отладке.

Скачивание файлов с curl

Сохраняйте файлы с -o, -O, следуйте редиректам, возобновляйте загрузки и многое другое.

SSL, TLS и прокси

Настройка сертификатов, версий TLS, HTTP/SOCKS-прокси и пользовательского DNS.

Как скопировать curl из браузера

Примеры кода на Node.js

1Простой GET-запрос

2POST с телом JSON

3Запрос с Bearer-токеном

4Загрузка Multipart Form

5Пользовательские заголовки

Часто задаваемые вопросы

Полезные ссылки

Руководства по curl

Конвертировать curl в другие языки

Примеры кода на Node.js

1Простой GET-запрос

2POST с телом JSON

3Запрос с Bearer-токеном

4Загрузка Multipart Form

5Пользовательские заголовки