form-parse/index.js

A helper for converting the values of a form into a single object.

var controls = require('form-controls');
var reduce = require('reduce');
var square = require('squares');
var submittable = require('is-submittable');
var value = require('dom-value');


/**
 * Retrieves a single JS object representing the values filled in
 * the `form` element's controls.
 *
 * @param {HTMLElement} form        Root element to parse (usually a <form>)
 * @param {Function} [transformer]  Allows transforming values.
 * @return {Object}
 */
module.exports = function (form, transformer) {
  return reduce(controls(form), function (acc, el) {
    if (!submittable(el)) return acc;
    var val = transformer
      ? transformer.call(form, el.name, value(el), el)
      : value(el);
    return square.set(acc, el.name, val);
  }, {});
};