L'oggetto FormData in JavaScript

#ajax   #JavaScript  

Le API livello 2 di XMLHttpRequest, le chiamate asincrone al server con ajax per intenderci, hanno incluso il supporto all'interfaccia FormData. Questo oggetto può essere usato come parametro del metodo send() della chiamata ajax e conterrà tutti i valori di un form associati al loro name.

Per istanziare un oggetto FormData è sufficiente usare il codice seguente

var formData = new FormData(document.getElementById('myForm'));

L'oggetto FormData ha vari metodi:

• FormData.append(name, value, filename)
      Aggiunge un nuovo valore all'oggetto FormData già esistente
• FormData.delete(name)
      Elimina un valore dall'oggetto sulla base del name passato come parametro
• FormData.get(name)
      Restituisce il primo valore del name passato come parametro
• FormData.getAll(name)
      Restituisce un array contenete tutti i valori del name passato come parametro
• FormData.has(name)
      Restituisce un valore booleano che indica se l'oggetto contiene un valore con il name specificato
• FormData.set(name, value, filename)
      Setta il valore di un name già presente nell'oggetto

I due parametri filename sono opzionali e possono indicare il nome del file con riferimento al server quando un blob o un file sono passati come parametro.