Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

FormData.get() — ler o primeiro valor

FormData.get(name) lê o primeiro valor com o nome indicado: uma string ou um objeto File. Se não existir nenhuma entrada, devolve null em vez de uma string vazia.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

formData.get(name)

Chame FormData.get numa instância usando formData.get(name). O método devolve o valor da primeira entrada correspondente sem alterar os dados. O resultado é uma string, um objeto File ou null quando não existe nenhuma entrada.

São permitidos nomes repetidos: get(name) lê apenas o primeiro valor; getAll(name) devolve todos os valores. Uma string vazia "" é um valor existente, não uma entrada em falta. Verifique value === null em vez de se basear em if (!value).

Esta é uma Web API, não uma funcionalidade da linguagem ECMAScript. O exemplo não usa o DOM e funciona sem alterações tanto nos navegadores que disponibilizam FormData.get como em Node.js 24. Mostra um nome repetido, um valor vazio e uma entrada em falta.

Exemplos

const data = new FormData();
data.append("color", "blue");
data.append("color", "green");
data.append("note", "");

console.log(JSON.stringify({
  first: data.get("color"),
  empty: data.get("note"),
  missing: data.get("unknown")
}));

Resultado

{"first":"blue","empty":"","missing":null}

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes