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.

Note: This feature is available in Web Workers.

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()).

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 FormData conté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

Veja também