Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

FormData.get()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨outubro de 2018⁩.

Nota: This feature is available in Web Workers.

O método get() da interface FormData retorna o primeiro valor associado com a chave fornecida de um objeto do tipo FormData.

Nota: Este método está disponível em Web Workers.

Sintaxe

js
formData.get(nome);

Parâmetros

nome

Um USVString representando o nome da chave que queira retornar.

Retorno

Um FormDataEntryValue contendo o valor.

Exemplo

A linha abaixo cria um objeto vazio do tipo FormData.

js
var formData = new FormData();

Se adicionarmos dois valores usuario_nome usando FormData.append:

js
formData.append("usuario_nome", "Sabrina");
formData.append("usuario_nome", "Antônio");

A função get() abaixo apenas irá retornar o primeiro valor usuario_nome incluido:

js
formData.get("usuario_nome"); // Retorna "Sabrina"

Especificações

Specification
XMLHttpRequest
# dom-formdata-get

Compatibilidade com navegadores

Veja também