CKTIS / JavaScript
FormData — crear y examinar datos de formulario
FormData almacena pares nombre-valor ordenados, incluso cuando los nombres se repiten. Aprende la diferencia entre append() y set(), a iterar con entries() y a enviar los datos mediante fetch().
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
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 es una interfaz de la API Web, no una parte de ECMAScript en sí. Almacena una lista ordenada de pares nombre-valor; los nombres pueden repetirse. Los valores son cadenas u objetos File. Puedes proporcionar un Blob, que se almacena como un archivo. Para los demás valores se aplican las reglas de conversión a cadena de Web IDL. Pasar un valor de tipo Symbol a append() o set() lanza una excepción TypeError durante esa conversión; no se almacena ninguna cadena.
append(name, value) añade una entrada y conserva las entradas anteriores con el mismo nombre. FormData.set, llamado como data.set(name, value), reemplaza la primera entrada coincidente y elimina las demás entradas con ese nombre. Si el nombre no existe, añade una entrada al final. Para un Blob, puedes proporcionar un tercer argumento, filename.
FormData.entries, llamado como data.entries(), devuelve un iterador de pares [name, value] en el orden de las entradas. En el ejemplo, set("tag", "api") deja una sola entrada tag en la posición de la primera entrada, por lo que aparece antes de name. No es un objeto simple: al convertirlo en un objeto no se conservarán varios valores con el mismo nombre.
Al enviarlo con fetch(url, { method: "POST", body: data }), no establezcas manualmente el encabezado Content-Type: el navegador crea multipart/form-data con un parámetro boundary adecuado. El ejemplo no envía ninguna solicitud. Comprueba la disponibilidad de la API en el navegador de destino; la presencia de Node 24 en un repositorio no demuestra que los navegadores sean compatibles.
Ejemplos
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}`);
}Resultado
tag=api name=Ada
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.