Skip to content

Release 4.6.0 - #644

Open
kevindb wants to merge 78 commits into
mainfrom
release-4.6.0
Open

kevindb wants to merge 78 commits into
mainfrom
release-4.6.0

Conversation

@kevindb

@kevindb kevindb commented Nov 11, 2026 •

Copy link
Copy Markdown
Member

Summary

Release 4.6.0: the version bump, the rebuilt dist and the 4.6.0 CDN snippets and SRI hash are in. After the merge, tagging v4.6.0 on the merge commit publishes it to npm.

No breaking changes are intended. Behavior changes only where the old behavior was a bug, differed from a native form submission, or differed between the plugin's own transports. Details are in docs/research/4x-behavior-changes.md.

Worth checking before upgrading:

  • Spaces encode as + on every jQuery version. On jQuery 3 and 4, formSerialize, fieldSerialize and GET query strings used %20. Servers decode both the same way.
  • Bundlers get the module build. The browser field is gone, so bundlers use dist/jquery.form.mjs (or dist/jquery.form.js for CommonJS). The new jsdelivr and unpkg fields keep bare CDN URLs on the minified file.
  • Iframe uploads reject with parsererror when the response does not parse for the dataType, as XHR requests do. An error status that also fails to parse reports its statusText.
  • target and iframeTarget strings are only selectors, never parsed as HTML; one that starts with < matches nothing. This removes the lookup CodeQL alert 10 flagged.
  • The CommonJS factory uses the window it is given, so it works in Node without a global DOM.

Other fixes: a lone UTF-16 surrogate in fields, the clicked button, data or extraData is sent as U+FFFD instead of throwing URIError on every transport. An iframe upload leaves out a clicked button disabled by its fieldset. LICENSE-MIT is published with the package.

Docs and repository:

  • The README is a landing page (installation, usage for script tag, ESM, CommonJS and AMD, CDN snippets for jsDelivr and cdnjs, compatibility) that links to the docs site for the API and options. Options that were only documented in the README are now on the docs site.
  • A Deprecations section on the API page lists each debug warning and its replacement. Replacing $.fieldValue to change what is serialized now warns under debug; use jQuery valHooks.
  • The docs layout drops html5shiv, the Chrome Frame meta and an unused analytics block. The quick start covers npm.
  • license is the SPDX expression (LGPL-2.1-or-later OR MIT) (same terms) and homepage is the docs site, in every manifest.
  • A bug report issue form replaces the old template, and security reports go to private reporting. Dependabot version updates are on for GitHub Actions and grouped npm dev dependencies. The unused root _config.yml is gone.

Tests (no effect on the published files): the suite runs on Chromium, Firefox and WebKit with jQuery 1.7.2, 3.7.1 and 4.0.0. A serialization oracle compares formToArray with the browser's own FormData. End-to-end tests post through every transport to a Node server and compare with a native submit. Published-file tests load the packed package by script tag, AMD, import map, CommonJS and ESM. The required matrix checks are renamed to jQuery <version> on <browser>, and branch protection on main now requires test and those nine checks. The Playwright browser cache is keyed on the runner image, after ubuntu-latest moved to 26.04 and restored a WebKit build that could not load its libraries.

Both items in #544 are resolved; it will be closed with a comment when 4.6.0 is published.

Evidence

  • Before (main, 4.5.0): 912 tests passed, 2 expected failures.
  • After (this branch, locally): npm test: 1199 passed on Chromium and 1184 on WebKit (35 skipped), coverage 100%, no expected failures left. Firefox passes in Docker.
  • CI: every check passes, including the Firefox, WebKit and end-to-end jobs on all three jQuery versions. The release workflow rehearsal (workflow_dispatch on this branch) passed.

Merge Danger

Door: two-way

The merge can be reverted. Publishing 4.6.0 to npm afterwards cannot be undone.

Blast Radius: consumers

Code that compares serialized strings sees + for spaces on jQuery 3 and 4. Bundles pick the module build instead of the minified one. A target written as an HTML string no longer creates elements.

🤖 Generated with Claude Code

Coverage stays on Chromium; npm test runs suite-webkit in a second Vitest run.
…andom forms

Known differences are a named allowlist; any other difference fails with its seed.
npm run test:e2e runs them; scripts/test-docker.sh --e2e runs them in Docker with Firefox.
…ed-file pages

Adds jsdom 30.1.3 for the Node-side checks.
…he global one

ADR-0001: same files and factory; the classic body now starts by reading its globals from root.
Add installation and usage, point Download at npm and the release tags, and rewrite File Uploads.
ubuntu-latest moved to 26.04 and restored a WebKit build for 24.04 that cannot load its libraries.
@kevindb
kevindb marked this pull request as ready for review November 14, 2026 14:04

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant