`typescript
import formToObject from 'form_to_object';

// Define your form data interface
interface UserSettingsForm {
name: string;
email: string;
settings: {
theme: 'light' | 'dark';
notifications: boolean;
};
}

// Pass the interface as a generic type parameter
const data = formToObject('settingsForm');

if (data) {
console.log(data.name); // string
console.log(data.settings.theme); // 'light' | 'dark'
}
`

You can also use CSS selectors (class, attribute, etc.):

`typescript
// By ID (with or without #)
formToObject('#myForm');
formToObject('myForm');

// By class
formToObject('.registration-form');

// By attribute
formToObject('form[data-type="checkout"]');

// By DOM reference
const form = document.querySelector('form') as HTMLFormElement;
formToObject(form);
`

Options

| Option name | Default | Description |
|---------------------------------------------|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
| includeEmptyValuedElements | boolean (default false) | Return field names as keys with empty value "" instead of just ignoring them. |
| w3cSuccessfulControlsOnly | boolean (default false) | TBA, WIP |
| selectNameWithEmptyBracketsReturnsArray | boolean (default true) | field names like name="select[]" always return an array [a,b] instead or array of arrays [0: [a,b]]. |
| checkBoxNameWithEmptyBracketsReturnsArray | boolean (default true) | checkboxes with field names like name=checkbox[] always return an array [a,b] instead or array of arrays [0: [a,b]]`. |

Browser support

IE 8, Firefox 3.5, Chrome, Safari, Opera 10, every mobile browser.

Example