Converter curl para Node.js

Q: O que é o módulo http do Node.js?

Os módulos http e https são módulos nativos do Node.js para fazer requisições HTTP sem dependências. Eles fornecem controle de baixo nível sobre streams de requisição/resposta. Para alternativas de alto nível, o curl2code também suporta axios, node-fetch, got, ky e superagent.

Q: http vs axios vs node-fetch vs got — qual devo usar?

http não possui dependências, mas é verboso. axios oferece uma API limpa com interceptores e parsing automático de JSON. node-fetch espelha a Fetch API do navegador. got é rico em recursos com retries, paginação e streams. Escolha com base nas necessidades do projeto. Para JavaScript no navegador, veja nosso conversor de curl para JavaScript.

Q: Como lidar com autenticação no Node.js?

Defina o cabeçalho Authorization no objeto de opções. Para autenticação Basic, use Buffer.from(user + ':' + pass).toString('base64'). Com axios, use a opção de configuração auth integrada. O curl2code converte flags -u e tokens Bearer para todas as bibliotecas Node.js suportadas.

Q: Como enviar dados de formulário multipart no Node.js?

Com o módulo http nativo, construa o corpo multipart manualmente ou use o pacote form-data. Com axios, passe uma instância de FormData como o corpo. O Node.js 18+ possui uma classe FormData integrada. O curl2code lida com flags -F para cada variante de biblioteca.

Q: Como lidar com erros HTTP no Node.js?

Com http, escute o evento 'error' na requisição e verifique response.statusCode. Com axios, erros são lançados para códigos de status não-2xx e podem ser capturados em try/catch. Com got, use o mesmo padrão somado à lógica de retry integrada em caso de falha.

Q: Como lidar com respostas em streaming no Node.js?

O módulo http retorna um readable stream por padrão — direcione-o com response.pipe(fs.createWriteStream('file')). Com got, use got.stream(url). Com axios, defina responseType: 'stream'. O streaming é ideal para arquivos grandes e evita carregar respostas inteiras na memória.

Q: Como definir timeouts em requisições HTTP no Node.js?

Com http, passe timeout nas opções e escute o evento 'timeout', então chame req.destroy(). O Axios aceita timeout em milissegundos. O Got suporta tanto timeout.request quanto retries automáticos integrados com backoff configurável.

Q: Como usar um proxy com Node.js?

O módulo http nativo requer tunelamento de proxy manual. Use os pacotes https-proxy-agent ou http-proxy-agent. O Axios suporta proxies via configuração proxy. O Got usa a opção agent com agentes de proxy. O curl2code converte as flags -x e --proxy apropriadamente.

Q: Como enviar uma requisição POST com corpo JSON em Node.js?

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL para Node.js usando o curl2code. O código gerado usa axios.post(url, { key: 'value' }). O curl2code detecta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código do axios.

Q: Como adicionar autorização com token Bearer em Node.js?

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e ele gerará o código do axios com o cabeçalho de autenticação: headers: { Authorization: 'Bearer YOUR_TOKEN' }. O curl2code detecta tokens Bearer tanto de flags -H "Authorization: Bearer ..." quanto de --oauth2-bearer. Para Basic auth, use -u user:pass.

Converta comandos curl para código Node.js usando o módulo integrado http. O curl2code é executado inteiramente no seu navegador via WebAssembly — suas chaves de API e dados permanecem privados. Para JavaScript no lado do navegador, veja nosso conversor de curl para JavaScript. Se você prefere Python, tente curl para Python. Abaixo você encontrará exemplos prontos para usar.

Como copiar o curl do seu navegador

1
Abra o DevTools
Pressione F12 ou Ctrl+Shift+I para abrir as ferramentas de desenvolvedor do seu navegador.
2
Vá para a aba Network
Clique na aba Network e realize a ação que dispara a requisição HTTP.
3
Copiar como cURL
Clique com o botão direito na requisição → Copy → Copy as cURL. Depois cole acima.

Exemplos de código Node.js

1Requisição GET simples

comando 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 com corpo JSON

comando 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();

3Requisição com Bearer Token

comando 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());
  });
});

4Upload de formulário multipart

comando 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);

5Cabeçalhos personalizados

comando 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());
  });
});

Perguntas Frequentes

O que é o módulo http do Node.js?

Os módulos http e https são módulos nativos do Node.js para fazer requisições HTTP sem dependências. Eles fornecem controle de baixo nível sobre streams de requisição/resposta. Para alternativas de alto nível, o curl2code também suporta axios, node-fetch, got, ky e superagent.

http vs axios vs node-fetch vs got — qual devo usar?

http não possui dependências, mas é verboso. axios oferece uma API limpa com interceptores e parsing automático de JSON. node-fetch espelha a Fetch API do navegador. got é rico em recursos com retries, paginação e streams. Escolha com base nas necessidades do projeto. Para JavaScript no navegador, veja nosso conversor de curl para JavaScript.

Como lidar com autenticação no Node.js?

Defina o cabeçalho Authorization no objeto de opções. Para autenticação Basic, use Buffer.from(user + ':' + pass).toString('base64'). Com axios, use a opção de configuração auth integrada. O curl2code converte flags -u e tokens Bearer para todas as bibliotecas Node.js suportadas.

Como enviar dados de formulário multipart no Node.js?

Com o módulo http nativo, construa o corpo multipart manualmente ou use o pacote form-data. Com axios, passe uma instância de FormData como o corpo. O Node.js 18+ possui uma classe FormData integrada. O curl2code lida com flags -F para cada variante de biblioteca.

Como lidar com erros HTTP no Node.js?

Com http, escute o evento 'error' na requisição e verifique response.statusCode. Com axios, erros são lançados para códigos de status não-2xx e podem ser capturados em try/catch. Com got, use o mesmo padrão somado à lógica de retry integrada em caso de falha.

Como lidar com respostas em streaming no Node.js?

O módulo http retorna um readable stream por padrão — direcione-o com response.pipe(fs.createWriteStream('file')). Com got, use got.stream(url). Com axios, defina responseType: 'stream'. O streaming é ideal para arquivos grandes e evita carregar respostas inteiras na memória.

Como definir timeouts em requisições HTTP no Node.js?

Com http, passe timeout nas opções e escute o evento 'timeout', então chame req.destroy(). O Axios aceita timeout em milissegundos. O Got suporta tanto timeout.request quanto retries automáticos integrados com backoff configurável.

Como usar um proxy com Node.js?

O módulo http nativo requer tunelamento de proxy manual. Use os pacotes https-proxy-agent ou http-proxy-agent. O Axios suporta proxies via configuração proxy. O Got usa a opção agent com agentes de proxy. O curl2code converte as flags -x e --proxy apropriadamente.

Como enviar uma requisição POST com corpo JSON em Node.js?

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL para Node.js usando o curl2code. O código gerado usa axios.post(url, { key: 'value' }). O curl2code detecta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código do axios.

Como adicionar autorização com token Bearer em Node.js?

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e ele gerará o código do axios com o cabeçalho de autenticação: headers: { Authorization: 'Bearer YOUR_TOKEN' }. O curl2code detecta tokens Bearer tanto de flags -H "Authorization: Bearer ..." quanto de --oauth2-bearer. Para Basic auth, use -u user:pass.

Como definir o cabeçalho Content-Type em Node.js?

O curl2code converte curl -H "Content-Type: application/json" URL para o código do axios com o cabeçalho correto: headers: { 'Content-Type': 'application/json' }. Para dados -d, o curl define por padrão application/x-www-form-urlencoded; para uploads de formulário com -F, ele usa multipart/form-data. O curl2code mapeia cada um para a API correta do axios.

Links úteis

Documentação do http

nodejs.org

Referência da biblioteca padrão

github.com

Página de manual do curl

curl.se

Guias do curl

Códigos de erro do curl

Consulte qualquer código de saída do curl — causas, correções e dicas de depuração.

Baixar arquivos com curl

Salve arquivos com -o, -O, siga redirecionamentos, retome downloads e mais.

SSL, TLS e proxy

Configure certificados, versões TLS, proxies HTTP/SOCKS e DNS personalizado.

Como copiar o curl do seu navegador

Exemplos de código Node.js

1Requisição GET simples

2POST com corpo JSON

3Requisição com Bearer Token

4Upload de formulário multipart

5Cabeçalhos personalizados

Perguntas Frequentes

Links úteis

Guias do curl

Converter curl para outras linguagens

Exemplos de código Node.js

1Requisição GET simples

2POST com corpo JSON

3Requisição com Bearer Token

4Upload de formulário multipart

5Cabeçalhos personalizados