Referência técnica e guia de arquitetura

Guia de cURL para JavaScript Fetch e Axios — Guia de referência

Converta comandos cURL brutos em código JavaScript Fetch API, TypeScript, Axios e Node.js de forma rápida, idiomática e 100% privada no navegador.

Parâmetros principais e controles

rawCurlstring

Comando cURL copiado do terminal ou da aba de rede do navegador.

Padrão: Auto
wrapInFunctionboolean

Envolve a requisição em uma função assíncrona reutilizável.

Padrão: true
checkResponseOkboolean

Verifica response.ok para capturar códigos de erro HTTP 4xx e 5xx.

Padrão: true
formatJsonAsObjectboolean

Estrutura o payload JSON como objeto literal em JavaScript.

Padrão: true

Dicas profissionais e melhores práticas

Como contornar erros de CORS no navegador

O cURL executa diretamente no sistema sem regras de CORS. Em caso de bloqueio no navegador, realize a chamada através de uma API Route no backend.

Sempre valide response.ok no Fetch nativo

O Fetch não rejeita promessas em respostas 404 ou 500. Valide sempre if (!response.ok) antes de extrair os dados com response.json().

Controle de timeout com AbortSignal.timeout

Informe signal: AbortSignal.timeout(5000) para abortar requisições travadas e evitar degradação na experiência do usuário.

Problemas comuns e solução de problemas

Erro 'TypeError: Failed to fetch' no navegador

Verifique nas ferramentas de desenvolvedor bloqueios de CORS ou incompatibilidade entre HTTP e HTTPS.

O JSON é enviado com barras de escape indesejadas

Habilite a formatação de JSON como objeto e garanta o envio do cabeçalho Content-Type: application/json.

Perguntas frequentes (FAQ)

Como o cURL Basic Auth (-u user:pass) é convertido para Fetch?▼

É mapeado para o cabeçalho Authorization: Basic <base64>, codificado com btoa('user:pass') no navegador ou Buffer no Node.js.

Por que o Fetch exige chamar await response.json()?▼

Porque a resposta é entregue como ReadableStream e precisa ser lida de forma assíncrona até a conclusão do buffer.

O conversor suporta comandos cURL em múltiplas linhas com contra-barra?▼

Sim, ele normaliza quebras de linha POSIX (\), cmd (^) e PowerShell (`) automaticamente.

Minhas credenciais ou chaves de API são armazenadas?▼

Não. Todo o processamento é estritamente local no seu navegador web sem qualquer telemetria.

Ferramentas e utilitários relacionados

Todas as ferramentas →