8000 Prepare a 4.0 upgrade guide · Issue #5365 · jquery/jquery · GitHub
[go: up one dir, main page]
Skip to content
8000

Prepare a 4.0 upgrade g 8000 uide #5365

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
mgol opened this issue Aug 29, 2022 · 3 comments · Fixed by jquery/jquery.com#250
Closed

Prepare a 4.0 upgrade guide #5365

mgol opened this issue Aug 29, 2022 · 3 comments · Fixed by jquery/jquery.com#250
Assignees
@timmywil
Labels
Docs
Milestone
4.0.0

Comments

@mgol
Copy link
Member
mgol commented Aug 29, 2022

An incomplete list of items to cover:

Undocumented but still mention

The undocumented jQuery.fn.init API no longer accepts the third root parameter: #5096
@mgol mgol mentioned this issue Aug 29, 2022
Merged
2 tasks
@mgol mgol added this to the 4.0.0 milestone Aug 29, 2022
@mgol mgol changed the title Prepare a 4.0 upgrade guide Prepare a 4.0 blog post & an upgrade guide Nov 20, 2023
@mgol
Copy link
Member Author
mgol commented Nov 20, 2023

Moving this to the jQuery repo for easier commit/PR/issue references.

@mgol mgol transferred this issue from jquery/jquery.com Nov 20, 2023
@mgol mgol added Docs Discuss in Meeting Reserved for Issues and PRs that anyone would like to discuss in the weekly meeting. labels Nov 20, 2023
@mgol
Copy link
Member Author
mgol commented Nov 20, 2023 •
edited
Loading

Summary of the major 4.0.0 changes

Each list is sorted by modules alphabetically, with the exception of Core which always comes first.

Breaking changes

  • Core: Move the factory to separate exports
    • 46f6e3d
    • This is about the Node.js behavior for windowless environments where require( "jquery" )( window ) is required
  • Core: Remove deprecated jQuery APIs
    • 58f0c00
    • jQuery.isArray, jQuery.parseJSON, jQuery.nodeName, jQuery.isFunction, jQuery.isWindow, jQuery.camelCase, jQuery.type, jQuery.now, jQuery.isNumeric, jQuery.cssProps
    • Also:
  • Core: Drop support for IE <11, iOS <11, Firefox <65, Android Browser & PhantomJS
    • cf84696
    • Also:
      • Core: Drop support for Edge Legacy (i.e. non-Chromium Microsoft Edge)
  • Core: Remove private copies of push, sort & splice from the jQuery prototype
  • Core: Exclude callbacks & deferred modules in the slim build as well
    • fbc44f5
    • Also:
      • Build: Reduce the slim build header comment & jQuery.fn.jquery
      • Build: Explicitly exclude the queue module from the slim build
  • Core: Drop the root parameter of jQuery.fn.init (undocumented)
  • Ajax: Drop the json to jsonp auto-promotion logic
  • Ajax: Avoid CSP errors in the script transport for async requests
    • 07a8e4a
    • Make more requests use the <script src> part of the script transport
  • Ajax: Don't auto-execute scripts unless dataType provided
  • Attributes: Drop the toggleClass(boolean|undefined) signature
  • CSS: Don't automatically add "px" to properties with a few exceptions
  • CSS: Remove the opacity CSS hook
    • 865469f
    • The consequence is .css( "opacity" ) will now return an empty string for detached elements in standard-compliant browsers and "1" in IE & the legacy Edge. That behavior is shared by most other CSS properties which we're not normalizing either.
  • Data: Separate data & css/effects camelCase implementations
    • 8fae212
    • The data one no longer special-cases ms-
  • Data:Event:Manipulation: Prevent collisions with Object.prototype
    • 9d76c0b
    • Breaks code using hasOwnProperty
  • Deferred: Drop jQuery.Deferred.getStackHook (renamed since 3.7.0 to jQuery.Deferred.getErrorHook)
    • 258ca1e
    • Used to pass the original error to jQuery.Deferred.exceptionHook (previously we recommended passing stack but that breaks source maps)
  • Event: Stop shimming focusin & focusout events
  • Event: Avoid collisions between jQuery.event.special & Object.prototype
    • bcaeb00
    • Affects code calling hasOwnProperty on jQuery.event.special
  • Manipulation: Avoid concatenating strings in buildFragment
    • 9c98e4e
    • Needed for Trusted Types support - the breaking aspect of it is likely minimal
  • Manipulation: Don't remove CDATA sections from scripts
  • Selector: Drop support for legacy pseudos
  • Selector: Backport jQuery selection context logic to selector-native

Other notable changes

  • Core: Remove IE-specific support tests, rely on document.documentMode
  • Core: Migrate from AMD to ES modules 🎉
  • Core: Add exports to package.json, export slim & esm builds
  • Core:Manipulation: Add basic TrustedHTML support
  • Ajax: Support binary data (including FormData)
    • a7ed9a7
    • Possible minor breaking change: prefilters are now applied before data is converted to a string
  • Deferred: Respect source maps in jQuery.Deferred.exceptionHook
    • 0b9c503
    • Affects errors in Promise callbacks for which jQuery print errors as they are typically human error rather than an exception to handle in code
  • Selector: reduce size, simplify setDocument

@petecooper petecooper mentioned this issue Dec 26, 2023
Open
@Geekhyt Geekhyt mentioned this issue Jan 3, 2024
Open
@jquery jquery deleted a comment from Mooenz Jan 6, 2024
@jquery jquery locked as off-topic and limited conversation to collaborators Jan 6, 2024
@timmywil timmywil removed the Discuss in Meeting Reserved for Issues and PRs that anyone would like to discuss in the weekly meeting. label Jan 6, 2024
@timmywil timmywil closed this as completed Jan 6, 2024
@mgol mgol changed the title Prepare a 4.0 blog post & an upgrade guide Prepare a 4.0 upgrade guide Jul 15, 2024
@mgol
Copy link
Member Author
mgol commented Jul 15, 2024

We'll use this issue to track just the upgrade guide work.

@mgol mgol reopened this Jul 15, 2024
timmywil added a commit to timmywil/jquery.com that referenced this issue Sep 16, 2024
@timmywil
Upgrade: add 4.0 upgrade guide [wip] [skip ci]
56f5ac7 
Fixes jquery/jquery#5365
timmywil added a commit to timmywil/jquery.com that referenced this issue Sep 29, 2024
@timmywil
Upgrade: add 4.0 upgrade guide [wip] [skip ci]
fc749e3 
Fixes jquery/jquery#5365
timmywil added a commit to timmywil/jquery.com that referenced this issue Mar 31, 2025
@timmywil
Upgrade: add 4.0 upgrade guide [wip] [skip ci]
d2e8977 
Fixes jquery/jquery#5365
timmywil added a commit to timmywil/jquery.com that referenced this issue Mar 31, 2025
@timmywil
Upgrade: add 4.0 upgrade guide
1169312 
Fixes jquery/jquery#5365
@mgol mgol marked this as a duplicate of #5659 May 11, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees

@timmywil timmywil

Labels
Docs
Milestone
4.0.0
Development

Successfully merging a pull request may close this issue.

Upgrade: add 4.0 upgrade guide timmywil/jquery.com
2 participants
@timmywil @mgol
0