FormData
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Nota: This feature is available in Web Workers.
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/pt-br/web/api/xmlhttprequest_api/index.md)
A interface FormData fornece uma maneira fácil de construir um conjunto de pares chave/valor representando campos de um elemento form e seus valores, os quais podem ser facilmente enviados utilizado o método send() do XMLHttpRequest. Essa interface utiliza o mesmo formato que um form utilizaria se o tipo de codificação estivesse configurado como "multipart/form-data".
Um objeto FormData pode ser usado diretamente em uma estrutura for...of em vez de entries(): for (var p of myFormData) é o mesmo que for (var p of myFormData.entries()).
Nota: Esse recurso está disponível em https://developer.mozilla.org/pt-BR/docs/Web/API/Web_Workers_API
Construtor
FormData()-
Cria um novo objeto
FormData.
Métodos
FormData.append-
Acrescenta um novo valor em uma chave existente dentro de um objeto
FormData, ou adiciona a chave se ela ainda não existir. FormData.delete-
Apaga um par chave/valor de um objeto
FormData. FormData.get-
Retorna o primeiro valor associado com uma dada chave de dentro de um objeto
FormData. FormData.getAll-
Retorna uma matriz de todos os valores associados a uma determinada chave de dentro de um
FormData. FormData.has-
Retorna um valor boleano indicando se um objeto
FormDatacontém um certo par chave/valor. FormData.set-
Define um novo valor para uma chave existente dentro de um objeto
FormData, ou adiciona a chave/valor se ele ainda não existir.
Nota:
Para ser claro, a diferença entre FormData.set() e FormData.append() é que, se a chave especificada não existir, FormData.set() irá substituir o valor existente por um novo, enquanto FormData.append() irá acrescentar um novo valor no final dos valores existentes. Veja as suas páginas dedicadas para código de exemplo.
Especificações
| Specification |
|---|
| XMLHttpRequest Standard # interface-formdata |
Compatibilidade com navegadores
BCD tables only load in the browser