formdata-node

What is formdata-node?

The formdata-node package is a Node.js module that allows you to create, manipulate, and encode multipart/form-data streams. It can be used to submit forms and upload files via HTTP requests in a way that is compatible with browser FormData API.

What are formdata-node's main functionalities?

Creating FormData

This feature allows you to create a new FormData instance and append fields to it, similar to how you would in a browser environment.

const { FormData } = require('formdata-node');
const formData = new FormData();
formData.append('key', 'value');

Appending Files

This feature enables appending files to the FormData instance, which can then be used to upload files to a server.

const { FormData, fileFromPath } = require('formdata-node');
const formData = new FormData();
formData.append('file', fileFromPath('./path/to/file.txt'));

Retrieving FormData Content

This feature allows you to iterate over the entries in the FormData object, enabling you to access the keys and values that have been appended.

const { FormData } = require('formdata-node');
const formData = new FormData();
formData.append('key', 'value');
for (const [key, value] of formData) {
  console.log(key, value);
}

Encoding FormData

This feature is used to encode the FormData into a Blob, which can then be used to send the data over an HTTP request.

const { FormData, formDataToBlob } = require('formdata-node');
const formData = new FormData();
formData.append('key', 'value');
const blob = formDataToBlob(formData);

Other packages similar to formdata-node

form-data

The 'form-data' package is similar to 'formdata-node' and is used to create readable 'multipart/form-data' streams. It can be used in the Node.js environment and is compatible with 'request' library. It differs in API and internal implementation but serves a similar purpose.

busboy

Busboy is a Node.js module for parsing incoming HTML form data. It's different from 'formdata-node' as it focuses on parsing form data rather than creating it, but it can handle multipart/form-data, which is commonly used for file uploads.

multiparty

Multiparty is a Node.js module for parsing multipart/form-data requests, which is used for uploading files. Unlike 'formdata-node', which is for creating and encoding form data, 'multiparty' is designed for the server-side to parse incoming data.

README

FormData

FormData implementation for Node.js. Built over Readable stream and async generators.

Installation

You can install this package from npm:

npm install --save formdata-node

Or with yarn:

yarn add formdata-node

API

constructor FormData()

Initialize new FormData instance

Instance methods

set(name, value[, filename]) -> {void}

Set a new value for an existing key inside FormData, or add the new field if it does not already exist.

• {string} name – The name of the field whose data is contained in value
• {any} value – The field value. You can pass any JavaScript primitive type (including null and undefined), Buffer or Readable stream. Note that Arrays and Object will be converted to string by using String function.
• {string} [filename = undefined] – A filename of given field. Can be added only for Buffer and Readable .

append(name, value[, filename]) -> {void}

Appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist.

• {string} name – The name of the field whose data is contained in value
• {any} value – The field value. You can pass any JavaScript primitive type (including null and undefined), Buffer or Readable stream. Note that Arrays and Object will be converted to string by using String function.
• {string} [filename = undefined] – A filename of given field. Can be added only for Buffer and Readable .

get(name) -> {string | Buffer | stream.Readable}

Returns the first value associated with the given name. Buffer and Readable values will be returned as-is.

• {string} – A name of the value you want to retrieve.

getAll(name) -> {string[] | Buffer[] | stream.Readable[]}

Returns all the values associated with a given key from within a FormData object.

• {string} – A name of the value you want to retrieve.

has(name) -> {boolean}

Check if a field with the given name exists inside FormData.

• {string} – A name of the field you want to test for.

delete(name) -> {void}

Deletes a key and its value(s) from a FormData object.

• {string} name – The name of the key you want to delete.

keys() -> {iterator}

Returns an iterator allowing to go through the FormData keys

values() -> {iterator}

Returns an iterator allowing to go through the FormData values

entries() -> {iterator}

Returns an iterator allowing to go through the FormData key/value pairs

[Symbol.iterator]() -> {iterator}

An alias of FormData#entries

Related packages

• then-busboy – Promise-based wrapper around Busboy. Process multipart/form-data content and returns it as a single object. Will be helpful to handle your data on the server-side applications.