Skip to Content
NFSFU234FormValidation v3 is here — file upload validation, config-driven rules, and more.
v3 (current)Changelog

Changelog

All notable changes to the NFSFU234FormValidation Library will be documented in this file. The format is based on Keep a Changelog  and adheres to Semantic Versioning.

3.0.2  (2026-08-25)

3.0.1  (2026-08-25)

[3.0.0] — NFSFU234 Open Source Day (2026-08-25)

The biggest release in this library’s history — a redesigned developer experience, automated API documentation, real test coverage, a cleaner architecture, and significantly expanded validation capabilities for long-term maintenance.

Published as part of NFORSHIFU234 Dev’s first NFSFU234 Open Source Day, alongside NFSFU234 Tour Guide  and the new NFSFU234 ShotSweep .

⚠️ Breaking

  • Removed .hashPassword(), .verifyPassword(), and .passwordMatch(), and the bcryptjs runtime dependency entirely. Client-side password hashing was never a real security feature — it doesn’t protect a password in transit, and most real backends already have their own hashing story. This library now validates and generates; it does not perform cryptography. generatePassword()’s shouldHash option is also removed. checkPassword() and generatePassword() are otherwise unaffected.
  • .submit() and .validate() are now always async and always return a Promise, including code paths that previously returned synchronously. Consumers checking results directly must now await the result or use .then().
  • .validateInput() is now async too and consistently returns a Promise.

Added

  • Bare form-less instantiation: new NFSFU234FormValidation(null) explicitly skips form resolution, novalidate, and submit-listener setup while still allowing utility methods to be used safely.
  • Static AJAX API: added NFSFU234FormValidation.ajax() for making requests without an instance or form. The existing instance method delegates to the static implementation.
  • TypeDoc API documentation: added JSDoc coverage across the main public API, typedoc.json, and npm run docs:build, generating both HTML API documentation and a JSON API model.
  • File/image validation: added validateFile() and validateAllFile() support for required/min/max file counts, MIME types/extensions, maximum file size, and image dimension limits.
  • Real test suite: added Jest, jsdom, and ts-jest coverage for configuration, validation behavior, file validation, exception handling, and format utilities.
  • CI hardening: type-checking and the complete test suite now run on pushes and pull requests to main. npm publishing and GitHub releases are gated behind successful validation and build jobs.
  • Site-wide configuration registry: added configureForms() and autoInit() for declaring validation rules across multiple forms.
  • Declarative field rules: configuration can now define field-level required, type, minLength, maxLength, pattern, and message rules.
  • Radio and checkbox validation are now included in .validate() and .submit().
  • Added .nvmrc pinning Node 22 for development and CI.
  • Added release-dry-run.yml for validating the release process before publishing.
  • Added npm-package artifact uploads from CI.
  • Added browser and Next.js App Router example applications.
  • Added a flexible constructor API supporting automatic form detection, utility-only instances, form IDs, form elements, and configuration objects.
  • Refactored form resolution into shared helpers.

Changed

  • Scoped the package to @nfsfu234/form-validation under the nfsfu234 npm organization.
  • Switched release automation from tag-triggered publishing to trunk-based semantic releases on pushes to main.
  • Added next and alpha prerelease channels and maintenance-range branches.
  • Updated Conventional Commit release rules.
  • Updated CI workflows to use the Node version pinned in .nvmrc.
  • Updated actions/setup-node from v3 to v4.
  • Replaced the archived actions/create-release@v1 with softprops/action-gh-release@v2.
  • Documented tsdown as the recommended successor to tsup, while leaving migration as future maintenance work.
  • Corrected the documentation website’s license information to match the library’s MIT license.
  • Rewrote the package description and reduced the keyword list to remove misleading backend/server-side terminology.
  • Updated the package homepage to the current live domain.
  • Unified .validate() and .submit() around the same validation pipeline.
  • Corrected FormValidationOptions to accurately represent runtime-supported options and replaced duplicated any types with the real interfaces.

Fixed

  • Fixed form-type detection in submit().
  • Fixed SSR-safety issues involving invalid log levels.
  • Fixed ExceptionHandler’s error_1 fallthrough behavior.
  • Fixed npm package entry points and exports so Node, bundlers, and CDN consumers resolve the package correctly.
  • Removed unused runtime dependencies including browserify-related packages and build-only CSS tooling.
  • Fixed the togglePasswordVisibility hideIcon copy-paste bug.
  • Replaced unsafe radio/checkbox message casts with type-safe narrowing.
  • Fixed inline validation messages being appended to the wrong location in multi-field parents.
  • Added direct CSS package imports.
  • Removed unconditional constructor logging.
  • Fixed radio, checkbox, and textarea validators failing to fall back to the instance form.
  • Fixed .validateAllRadio() form propagation.
  • Fixed .validateAllInput() dropping custom error messages.
  • Corrected JSDoc describing validation options versus configured validation rules.
  • Fixed .validateAllSelect() and .validateAllTextarea() missing the form ?? this.form fallback.
  • Added missing default option objects to .validateSelect() and .validateTextarea().
  • Added explicit form guards to all validateAll* methods.
  • Documented the internal/public parameter ordering of checkPassword().
  • Tightened options: any parameters across the validation API to use FormValidationOptions.

Removed

  • Removed the unused src/ts/index.ts duplicate implementation.
  • Removed the unused parallel form-submission implementation in src/ts/formSubmission/submitHandler.ts.
  • Removed the empty, unreferenced password handler.
  • Removed approximately 300 lines of commented-out legacy code.

Housekeeping

  • Moved the standalone browser demonstration from tests/index.html to examples/browser/.
  • Moved generated TypeScript declarations alongside compiled JavaScript output.
  • Added a complete Next.js App Router playground demonstrating validation, AJAX requests, password utilities, browser compatibility, package information, installation examples, API playground, and browser integration.
  • Updated the playground to consume the published npm package instead of local source files.

Release

Part of NFORSHIFU234 Dev’s open-source ecosystem and released for NFSFU234 Open Source Day alongside NFSFU234 Tour Guide  and the new NFSFU234 ShotSweep .

For documentation and examples, visit the NFSFU234 Form Validation website .

[3.0.0-beta] - 2024-08-25

Important Notes

  • 🚨 Repository Transfer: This repository has been moved from nforshifu234dev’s personal account to the NFSFU234FormValidation organization. Access it under the NFSFU234FormValidation organization by clicking here .

Added

  • Framework Compatibility: Added support for React JS and Vite, allowing seamless integration with these frameworks.
  • TypeScript Upgrade: The library has been upgraded from Vanilla JavaScript to TypeScript for enhanced code efficiency and debugging.
  • Error Handling Enhancements: Introduced the ErrorMessage and ErrorHandler interfaces for clearer error insights, allowing errors to be handled as HTML elements, text, or null.
  • Revamped Methods: Redesigned submit and validate methods to return a Promise resolving to an ErrorMessageInterface, providing detailed feedback on validation results.

Updated

  • Class and ID Renaming: Updated the js-required class to nfsfu234-fv-required and the jsSubmit ID to nfsfu234-fv-form to maintain a consistent naming convention.
  • Website Improvements: Ongoing work to enhance the website for a more user-friendly experience, with final changes expected by the stable release.

Removed

  • None

[2.4.4] - 2024-03-01

IMPORTANT INFORMATION

🚨 Repository Transfer: This repository has been moved from nforshifu234dev’s personal account to the NFSFU234FormValidation organization. You can now access it under the NFSFU234FormValidation organization by clicking here .

Added

  • Added a new CODE_OF_CONDUCT file to promote a welcoming and inclusive community.

Updated

  • Modified the CONTRIBUTING.md file to provide updated guidelines for contributors.
  • Updated the LICENSE file to reflect the project’s license.
  • Modified the Package Information file to ensure accurate information.

Removed

  • The web folder has been removed and transferred to its own repository. You can now find it in its dedicated repository here .

[2.4.3] - 2024-01-25

Important Note

  • When utilizing the JsDelivr CDN URL to access the NFSFU234FormValidation Library with the @latest tag, be aware that, in some instances, it might not include the latest updates. To ensure the inclusion of the most recent code, consider using the specific version number (e.g., 2.4.3).

  • This observation was made during the release of version 2.4.2.

Added

  • Added redirect() function, used for redirecting a user to a specific url or path

Updated

  • Website UI has been updated.
  • copy-webpack-plugin was updated to v12.0.2 from v11.0.0
  • css-minimizer-webpack-plugin was updated to v6.0.0 from 5.0.1

Changed

  • Modified the _getFormDetails() function

    • Fixed the bug, formValidator.getFormDetails is not a function. This was due to a bundling error during the rlease of v2.3.2
    • Had to add index variable when selcting textareas, and select tags. It was returning errors in previous versions.

  • Modified the _loading() function

    • Here I added the ability for the loading() function to select inut feilds with the type search

  • Modified the submit() function

    • Modfied this function in the else part when checking if a button exists. The console error was a mess.

  • Modified the validateInput() function

    • Modifed this function to be able to check for date type in any input feild.
    • Modified this function to display the prorper error message if an input is of type url and is required

Removed

  • None

[2.3.2] - 2023-11-27

Added

  • none

Changed

  • Modified the ReadMe.md file
  • Modified the function call attribute for verifyPassword() function.
  • Modified the _togglePasswordVisibility() function to ensure more flexiblity to icon display during toggling more than one password input feild
  • Updated the _getFormDetails(). In the previous version, only inputs feilds were affected with the updates but now all for elements inputs, textareas, select.

Removed

  • none

[2.3.1] - 2023-11-25

Information 🥳🥂

Added

  • verifyPassword(). Asynchronously compares two passwords, supporting both hashed and plaintext formats. More information in the ReadMe file.

  • getFormDetails(). It gets the values of all form elements in a form. Be it inputs, textareas, selects or even checkboks & radio elements. Find More information in the ReadMe file num

Changed

  • Updated the babel, jest and webpack packages to versions 7.23.3, 29.7.0, and 5.89.0 respectively

  • New instructions to install NFSFU234 Form Validation Library via npm, yarn in the Installation Section

  • Updated the documentation for the illustration for how to use the generateRandomPassword() function . Removed the parameters from the illustration because this function does not allow parameters yet.

  • Updated the isURL() function to properly check and validate URLS.

  • Updated the private function , _getFormDetails() function. The function could only get form data based on only if the form element has the data-attr-name attribute. Then i thought to myself since a lot of forms use the name attribute why not add that attribute to the list. Find out more information in the getFormDetails() function that has been made visible

Removed

  • Removed the Independence Day Banner.

[2.3.0-patch] - 2023-10-01

Fixed

  • Fixed the error of the new features isOnline() and reset() is not working in the initial v2.3.0.

[2.3.0] - 2023-10-01

Added

  • Added isOnline() function to check if a browser is connected to the internet or not
  • Added reset() function to reset all the inputs to an empty value

Changed

  • Added comments to describe the loading() function released in the previous version(v2.2.0) in the nfsfu234-form-validation.js file located in the src folder

  • Reviewd and edited the displayError() function list details in the web/json/function-list.json file,

[2.2.0] - 2023-09-25

Added

  • Added loading() function, this function is used to add your loading message incase you wished to have a custom loading animation or text if you choose not to use the defualt submit function. This function takes 2 parameters. See more information in the ReadMe

  • Added a new HTML class, js-spin to be added to the previous spin class for adding spining effect to an element.

[2.1.0] - 2023-09-09

Added

  • Added the displayError() function which accepts 1 parameter of data type object. See more details and how to use it in the ReadMe

[2.0.0] - 2023-08-26

Breaking Change

  • Renamed the minified CSS output file from nfsfu234-formValidation.min.css to nfsfu234FormValidation.min.css, impacting how users refrence the minified CSS

Other Changes

  • Updated the banner from the versioning banner to a more static and elegant banner.

[1.2.4] - 2023-08-26

Changed

  • Improved the ajax() function for a more clean experience.

Fixed

  • Fixed the issue of custom ajax request body not sending in browser rather getting the form details.

[1.2.3] - 2023-08-25

Fixed

  • Fixed the bcrypt is not defined issue from both browser and node environments.

[1.2.2] - 2023-08-25

Fixed

  • Fixed the Netlify website issue and added the neccessary file for the website.

[1.2.1] - 2023-08-25

Added

[1.1.1] - 2023-08-23

Added

  • validate() function for optional validations and more flexibility before submitting a form.

[1.0.1] - 2023-08-20

Changed

  • Improved the ajax() function for a more smoother experience.

Fixed

  • Fixed ajax() function to be able to correctly collect the URL from the ajaxOptions parameter or uses the current page URL.

[1.0.0] - 2023-08-15

🚀 Hello, World! My First Library - NFSFU234 Form Validation Library 📚

I’m thrilled to introduce the first release of the NFSFU234 Form Validation Library! This marks a significant milestone as it’s my very first library ever created. I’m excited to share with you a suite of functions designed to validate and interact with various form elements. Whether you’re a developer building web applications or working with Node.js, these functions provide a solid foundation for accurate and reliable validation solutions.

Added

  • submit() function for form validation and submission.
  • ajax(AJAXOptions) function for making AJAX requests.
  • getAJAXResponse() function for retrieving responses from AJAX requests.
  • generateRandomPassword() function for generating random passwords.
  • checkPassword(password, shouldIncludeSymbol) function for password strength validation.
  • isEmail(email) function for email format validation.
  • isURL(url) function for URL format validation.
  • isZipcode(zipcode) function for ZIP code validation.
  • containsOnlyIntegers(inputValue) function for integer content validation.
  • countString(inputValue) function for character counting.
  • togglePasswordVisibility(form, icons) function for enabling password visibility toggle.
  • validateInput(input) function for input field validation.
  • validateAllInput() function for validating all input fields.
  • validateSelect(select) function for select field validation.
  • validateAllSelect() function for validating all select fields.
  • validateTextarea(textarea) function for textarea field validation.
  • validateAllTextarea() function for validating all textarea fields.
  • validateCheckbox(checkbox) function for checkbox field validation.
  • validateAllCheckbox() function for validating all checkbox fields.
  • validateRadio(radioName) function for radio button group validation.
  • validateAllRadio() function for validating all radio button groups.
  • restrictInputLengthWithCounter(inputElement, counterContainer, options) function for input length restriction with a character counter.
  • checkType(variable) function for determining the type of a variable.
  • getPageUrl() function for retrieving the current page URL.

Changed

  • Improved validation logic for better accuracy.
  • Enhanced error message handling for better user feedback.

Fixed

  • Resolved issue with incorrect error messages being displayed.

Removed

  • None

As my very first library creation, the NFSFU234 Form Validation Library holds a special place in my journey. 🌱 I’m eager to present these functions that have been crafted with care to streamline form validation processes. 🛠️ Your feedback and support are invaluable as I embark on this exciting journey of library development. 🚀 Thank you for being part of it! 🙏

Last updated on
CreditsisZip