Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
FormData()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
Nota: This feature is available inWeb Workers.
OFormData() construtor cria um novo objetoFormData.
Nota:Este recurso está disponível emWeb Workers.
Sintaxe
var formData = new FormData(form);Parâmetros
formOptionalUm elemento HTML
<form>— quando especifico, o objetoFormDataserá preenchido com as chaves/valores atuais do formulário usando a propriedadename de cada elemento para as chaves e seu valor enviado para os valores. Também condificará conteúdo de entrada do arquivo.
Exemplo
A linha a seguir cria um objeto FormData vázio:
var formData = new FormData(); // Currently emptyVocê poderia adicionar uma chave/valor usandoFormData.append:
formData.append("username", "Chris");Ou você pode especificicar o opcionalform argument ao criar o objetoFormData, para o popular com valores de forma especifica:
<form name="myForm"> <div> <label for="username">Enter name:</label> <input type="text" name="username" /> </div> <div> <label for="useracc">Enter account number:</label> <input type="text" name="useracc" /> </div> <div> <label for="userfile">Upload file:</label> <input type="file" name="userfile" /> </div> <input type="submit" value="Submit!" /></form>Nota:Todos os elementos de entrada têm um atributo 'name'. Para que possa acessar seus valores mais tarde.
var myForm = document.getElementById("myForm");formData = new FormData(myForm);Especificações
| Specification |
|---|
| XMLHttpRequest # dom-formdata |