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 integrados do Node.js para fazer pedidos HTTP sem quaisquer dependências. Fornecem controlo de baixo nível sobre streams de pedido/resposta. Para alternativas de nível superior, o curl2code também suporta axios, node-fetch, got, ky e superagent.

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

O http não tem dependências, mas é verboso. O axios oferece uma API limpa com intercetores e análise automática de JSON. O node-fetch espelha a Fetch API do navegador. O got é rico em funcionalidades com tentativas, paginação e streams. Escolha com base nas necessidades do projeto. Para JavaScript no navegador, consulte o nosso conversor de curl para JavaScript.

Q: Como gerir a 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 o axios, use a opção de configuração auth integrada. O curl2code converte as flags -u e de token Bearer para todas as bibliotecas Node.js suportadas.

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

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

Q: Como gerir erros HTTP no Node.js?

Com o http, oiça o evento 'error' no pedido e verifique o response.statusCode. Com o axios, são lançados erros para códigos de estado não-2xx, que podem ser capturados em try/catch. Com o got, use o mesmo padrão mais a lógica de tentativas integrada em caso de falha.

Q: Como gerir respostas de streaming no Node.js?

O módulo http devolve uma stream legível por predefinição — encaminhe-a com response.pipe(fs.createWriteStream('file')). Com o got, use got.stream(url). Com o axios, defina responseType: 'stream'. O streaming é ideal para ficheiros grandes e evita carregar respostas inteiras na memória.

Q: Como definir timeouts em pedidos HTTP no Node.js?

Com o http, passe timeout nas opções e oiça o evento 'timeout', depois chame req.destroy(). O axios aceita timeout em milissegundos. O got suporta tanto timeout.request como tentativas automáticas integradas com backoff configurável.

Q: Como usar um proxy com o Node.js?

O módulo http integrado requer tunelamento de proxy manual. Use os pacotes https-proxy-agent ou http-proxy-agent. O axios suporta proxies através da configuração proxy. O got usa a opção agent com agentes de proxy. O curl2code converte as flags -x e --proxy adequadamente.

Q: Como enviar um pedido POST com um 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 utiliza axios.post(url, { key: 'value' }). O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código axios.

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

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código axios com o cabeçalho de autenticação: headers: { Authorization: 'Bearer YOUR_TOKEN' }. O curl2code deteta tokens Bearer tanto de flags -H "Authorization: Bearer ..." como de --oauth2-bearer. Para Basic auth, utilize -u user:pass.

Converta comandos curl para código Node.js utilizando o módulo incorporado http. O curl2code é executado inteiramente no seu navegador através de WebAssembly — as suas chaves de API e dados permanecem privados. Para JavaScript no lado do navegador, veja o nosso conversor de curl para JavaScript. Se preferir Python, experimente curl para Python. Abaixo encontrará exemplos prontos a usar.

Como copiar o curl do seu navegador

1
Abrir as DevTools
Prima F12 ou Ctrl+Shift+I para abrir as ferramentas de programador do seu navegador.
2
Ir para o separador Network
Clique no separador Network e realize a ação que despoleta o pedido HTTP.
3
Copiar como cURL
Clique com o botão direito no pedido → Copy → Copy as cURL. Depois cole-o acima.

Exemplos de Código Node.js

1Pedido 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();

3Pedido 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 integrados do Node.js para fazer pedidos HTTP sem quaisquer dependências. Fornecem controlo de baixo nível sobre streams de pedido/resposta. Para alternativas de nível superior, o curl2code também suporta axios, node-fetch, got, ky e superagent.

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

O http não tem dependências, mas é verboso. O axios oferece uma API limpa com intercetores e análise automática de JSON. O node-fetch espelha a Fetch API do navegador. O got é rico em funcionalidades com tentativas, paginação e streams. Escolha com base nas necessidades do projeto. Para JavaScript no navegador, consulte o nosso conversor de curl para JavaScript.

Como gerir a 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 o axios, use a opção de configuração auth integrada. O curl2code converte as flags -u e de token Bearer para todas as bibliotecas Node.js suportadas.

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

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

Como gerir erros HTTP no Node.js?

Com o http, oiça o evento 'error' no pedido e verifique o response.statusCode. Com o axios, são lançados erros para códigos de estado não-2xx, que podem ser capturados em try/catch. Com o got, use o mesmo padrão mais a lógica de tentativas integrada em caso de falha.

Como gerir respostas de streaming no Node.js?

O módulo http devolve uma stream legível por predefinição — encaminhe-a com response.pipe(fs.createWriteStream('file')). Com o got, use got.stream(url). Com o axios, defina responseType: 'stream'. O streaming é ideal para ficheiros grandes e evita carregar respostas inteiras na memória.

Como definir timeouts em pedidos HTTP no Node.js?

Com o http, passe timeout nas opções e oiça o evento 'timeout', depois chame req.destroy(). O axios aceita timeout em milissegundos. O got suporta tanto timeout.request como tentativas automáticas integradas com backoff configurável.

Como usar um proxy com o Node.js?

O módulo http integrado requer tunelamento de proxy manual. Use os pacotes https-proxy-agent ou http-proxy-agent. O axios suporta proxies através da configuração proxy. O got usa a opção agent com agentes de proxy. O curl2code converte as flags -x e --proxy adequadamente.

Como enviar um pedido POST com um 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 utiliza axios.post(url, { key: 'value' }). O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código axios.

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

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código axios com o cabeçalho de autenticação: headers: { Authorization: 'Bearer YOUR_TOKEN' }. O curl2code deteta tokens Bearer tanto de flags -H "Authorization: Bearer ..." como de --oauth2-bearer. Para Basic auth, utilize -u user:pass.

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

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

Links Úteis

Documentação do http

nodejs.org

Referência da Biblioteca Padrão

github.com

Página Man 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.

Transferir ficheiros com curl

Guarde ficheiros com -o, -O, siga redirecionamentos, retome transferências 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

1Pedido GET Simples

2POST com Corpo JSON

3Pedido 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

1Pedido GET Simples

2POST com Corpo JSON

3Pedido com Bearer Token

4Upload de Formulário Multipart

5Cabeçalhos Personalizados