form-data-kit

library to parse, stringify, and expand FormData

Install

npm install form-data-kit

Usage

import { parse, stringify, expand } from 'form-data-kit';

parse(query: string): FormData
stringify(formData: FormData): string
expand(formData: FormData): object

Parse

Parse takes a search param / query string, like the one from an url, and returns FormData

import { parse } from "form-data-kit";

parse("one=foo&two=bar");
// FormData {
// 	[Symbol(state)]: [ { name: 'one', value: 'foo' }, { name: 'two', value: 'bar' } ]
// }

Stringify

Parse takes FormData, and returns a search param / query string

import { stringify } from "form-data-kit";

const formData = new FormData();
formData.set("one", "foo");
formData.set("two", "bar");

stringify(formData);
// one=foo&two=bar

Expand

Expands formData into an object. This method supports nesting, using . and [number] syntax.

import { expand } from "form-data-kit";

const formData = new FormData();
formData.append("one", "1");
formData.append("two", "2");
formData.append("nested.three", "3");
formData.append("array[0]", "4");
formData.append("array[1].five", "5");

expand(formData);
// {
// 	one: '1',
// 	two: '2',
// 	nested: {
// 		three: '3',
// 	},
// 	array: ['4', { five: '5' }],
// }