Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes