O que é FormData
FormData é o formato que organiza o envio dos dados de um formulário. Em vez de estruturar o conteúdo em um JSON, o FormData carrega os campos como pares de chave e valor no corpo da requisição.
O FormData é comum quando o formulário envia conteúdo direto para o servidor, especialmente com arquivos. O navegador monta o corpo com os campos e os arquivos selecionados, e a requisição leva esse conteúdo ao destino.
Pares de chave e valor
O FormData representa cada campo como um par. O nome do campo é a chave, e o valor digitado é o valor. O corpo da requisição carrega esses pares para o servidor processar.
A estrutura permite múltiplos campos. Um formulário de cadastro envia nome, e-mail e telefone como pares. O servidor lê cada chave e usa o valor correspondente.
nome: Luiz
email: luiz@exemplo.com
telefone: 11 99999-0000FormData e arquivos
O FormData também permite enviar arquivos. O campo do arquivo é um dos pares, e o conteúdo é carregado junto. O servidor recebe o arquivo com o contexto do formulário.
O envio de arquivos exige o formato correto no corpo. O FormData define o tipo de conteúdo adequado. A integração com um upload aproveita o mesmo corpo para campos e arquivos.
FormData ou JSON
A escolha entre FormData e JSON acompanha o contrato da API. O JSON é estruturado e comum para dados simples. O FormData atende ao envio de formulários com arquivos.
O backend define o formato esperado. Conferir a documentação da API evita enviar o conteúdo no formato errado. A requisição correta leva o payload no formato que o servidor entende.
Para implementar o envio de formulários e arquivos com o formato certo, o Desenvolvimento Colaborativo da Dev Side Studio oferece orientação na construção das chamadas.
Dúvidas frequentes
Perguntas frequentes sobre FormData
- FormData e JSON são a mesma coisa?
- Não. JSON é um formato estruturado para dados. FormData organiza os campos de um formulário no envio. Cada formato atende a um contexto diferente.
- O que é enviado no FormData?
- Os campos do formulário, como pares de chave e valor. Arquivos também podem ser enviados no formato. O corpo da requisição carrega o conteúdo.
- Preciso usar FormData em toda requisição de formulário?
- Depende do backend e do desenho da aplicação. Algumas APIs esperam FormData, outras aceitam JSON. O contrato da API define o formato esperado.
- Um arquivo pode ser enviado com FormData?
- Sim. O FormData permite enviar campos e arquivos juntos no mesmo corpo. Isso facilita o envio de um formulário que inclui um upload.
Para continuar
Recursos relacionados
Documentação
FormData na MDN
A API FormData e o envio de campos e arquivos no navegador.
Abrir recursoDocumentação
Envio de formulários
Como os dados de um formulário são enviados a um servidor.
Abrir recursoAplicação na formação
Developer Workspace
O FormData organiza o envio de dados de um formulário no corpo da requisição.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.