@@ -1,6 +1,6 @@
# get-form-values
# formxtr
Get the value of a form using `HTMLFormElement.elements` .
Extract form values through the DOM .
## Installation
@@ -8,19 +8,65 @@ The library is not yet out on any package manager. Installing through the URL is
## Usage
For an example form:
```html
<!-- ... -->
<form id="form">
<input type="text" name="username" />
<input type="password" name="password" />
<button type="submit" name="type" value="client">Log In As Client</button>
<button type="submit" name="type" value="admin">Log In As Admin</button>
</form>
<!-- ... --->
```
Use the library as follows (code is in TypeScript, but can work with JavaScript as well):
```typescript
import getFormValues from '@theoryofnekomata/get-form-values';
import getFormValues from '@theoryofnekomata/formxtr ';
const form = document.getElementById('form')
const form: HTMLFormElement = document.getElementById('form');
// optional, but just in case there are multiple submit buttons in the form,
// individual submitters can be considered
const submitter = form.querySelector('[type="submit"]')
const submitter = form.querySelector('[type="submit"][name="type"][value="client"]');
const values = getFormValues(form, submitter);
const processResult = (result: Record<string, unknown>) => {
throw new Error('Not yet implemented.');
};
// Best use case is with event handlers
form.addEventListener('submit', async e => {
const { target: form, submitter } = e;
e.preventDefault();
const values = getFormValues(form, submitter);
// Get the form values and send as request to some API
const response = await fetch(
'https://example.com/api/log-in',
{
method: 'POST',
body: JSON.stringify(values),
headers: {
'Content-Type': 'application/json',
},
},
);
if (response.ok) {
const result = await response.json();
const values = getFormValues(form, submitter)
processResult(result);
}
})
```
## Tests
The library has been tested on JSDOM through Jest, and the real DOM using
Cypress.
The library has been tested on JSDOM through Jest, and the real DOM using Cypress.