Skip to main content

forms

Helpers for serializing, resetting, and populating HTML forms, plus native validation and submit handling.

Import: @rtorcato/browser-common/forms

📖 MDN: HTMLFormElement

Browser support​

APIChromeEdgeFirefoxSafariiOS SafariBaseline
FormData✅ 5+✅ 12+✅ 4+ [1]✅ 5+✅ 5+Widely available
HTMLFormElement.reportValidity✅ 40+✅ 17+✅ 49+✅ 10.1+✅ 10.3+Widely available
  1. Firefox: Before Firefox 7, specifying a Blob as the data to append to the object, the filename reported in the Content-Disposition HTTP header was an empty string, resulting in errors on some servers. Starting with Firefox 7, the filename blob is sent.

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: FormData · HTMLFormElement.reportValidity

Example​

import { serializeForm, isFormValid, onFormSubmit } from '@rtorcato/browser-common/forms'

const off = onFormSubmit(myForm, (event) => {
  if (!isFormValid(myForm)) return
  const data = serializeForm(myForm)
  console.log(data)
})

off()

Exports​

  • serializeForm(form) — returns form field values as Record<string, string>
  • resetForm(form) — resets the form to its initial values
  • setFormValues(form, values) — writes values onto matching named fields
  • isFormValid(form) — runs the browser's built-in checkValidity()
  • onFormSubmit(form, callback) — listens for submit, calls preventDefault() first; returns an unsubscribe function

See the API reference for full signatures.