Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

FormData — creare ed esaminare i dati di un modulo

FormData memorizza coppie nome-valore ordinate, anche con nomi ripetuti. Scopri la differenza tra append() e set(), come iterare con entries() e come inviare i dati usando fetch().

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

Sintassi

const data = new FormData();
data.append(name, value);
data.set(name, value);
data.set(name, blob, filename);
for (const [name, value] of data.entries()) { /* ... */ }

FormData è un’interfaccia della Web API, non fa parte di ECMAScript. Memorizza un elenco ordinato di coppie nome-valore; i nomi possono ripetersi. I valori sono stringhe o oggetti File. Puoi fornire un Blob, che viene memorizzato come file. Per gli altri valori si applicano le regole di conversione in stringa di Web IDL. Passare un valore di tipo Symbol a append() o set() genera un’eccezione TypeError durante la conversione; non viene memorizzata alcuna stringa.

append(name, value) aggiunge una voce mantenendo quelle precedenti con lo stesso nome. FormData.set, chiamato come data.set(name, value), sostituisce la prima voce corrispondente e rimuove le altre con quel nome. Se il nome non esiste, aggiunge una voce alla fine. Per un Blob, puoi fornire un terzo argomento, filename.

FormData.entries, chiamato come data.entries(), restituisce un iteratore di coppie [name, value] nell’ordine delle voci. Nell’esempio, set("tag", "api") lascia una sola voce tag nella posizione della prima voce, quindi questa compare prima di name. Non è un semplice oggetto: la conversione in oggetto non conserverà più valori con lo stesso nome.

Quando lo invii con fetch(url, { method: "POST", body: data }), non impostare manualmente l’intestazione Content-Type: il browser crea multipart/form-data con un parametro boundary corrispondente. L’esempio non invia richieste. Verifica la disponibilità dell’API nel browser di destinazione; la presenza di Node 24 in un repository non dimostra il supporto nei browser.

Esempi

const data = new FormData();
data.append("tag", "javascript");
data.append("tag", "web");
data.set("name", "Ada");
data.set("tag", "api");

for (const [name, value] of data.entries()) {
  console.log(`${name}=${value}`);
}

Risultato

tag=api
name=Ada

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti