[QUEST] Remove jQuery

[simonihmig]

This is an issue to track the progress on implementing the RFC386 to remove jQuery by default.

Work items

Deprecation phase (3.x)

ember.js

• add a (universal, non-silenceable) deprecation warning to Ember.$()
  🔒@simonihmig, PR: Add deprecation for Ember.$() #17489
• add a deprecation warning to this.$() in an Ember.Component
  🔒@simonihmig, PR: Add deprecation for this.$() in curly components #17488
• make sure user sees deprecation warning of jQuery integration itself, i.e. neither the jquery-integration optional feature flag is set to false nor @ember/jquery has been installed.
  🔒@simonihmig, PR: [INTERNAL] Improve jQuery deprecation message ember-cli/ember-cli#8399
• wrap all jQuery related code for svelte
  🔒@simonihmig, PR: Add svelte support for jQuery deprecations #17525

@ember/jquery

• Add support for Component.$()
  🔒@simonihmig, WIP PR: Add support for Component.$() as part of RFC386 ember-jquery#27
• Add jQuery-based EventDispatcher replacement
  🔒@simonihmig, WIP PR: WIP: Add jQuery-based event dispatcher as part of RFC386 ember-jquery#31
• Make import $ from 'jquery'; work
  🔒@simonihmig, PR: Add jQuery shim as part of RFC386 ember-jquery#33

ember-cli

• Update app blueprint, stage 1: Update @ember/jquery to latest version
  PR: blueprints: Update dependencies ember-cli/ember-cli#8396
• Update app blueprint, stage 2: remove jQuery
  🔒@CyrilleR, PR: Remove jQuery from app blueprint ember-cli/ember-cli#8394

@ember/test-helpers

• Add a deprecation warning to this.$() in component integration tests, based on setupRenderingTest()
  🔒@simonihmig, PR: Add deprecation for this.$ in rendering tests ember-test-helpers#543

ember-cli-babel

• Do not transpile import $ from 'jquery'; to Ember.$ if the right version of @ember/jquery is present
  🔒@simonihmig, PR: Avoid transpiling jquery module to Ember.$ if @ember/jquery is present ember-cli-babel#261

ember-data

• Make ember-data work with ember-fetch
  🔒@tchak PR: [FEAT fetch] use ember-fetch instead of jQuery warp-drive-data/warp-drive#5386

ember-fetch

• Provide a replacement API for jQuery's prefilter

Website

• Add a deprecation guide
  🔒@simonihmig PR: Deprecation guide for jQuery removal ember-learn/deprecation-app#255

Removal phase (4.0)

ember.js

• remove deprecated functions
• remove the jQuery specific code paths in the EventDispatcher

Collaboration

If someone wants to start work on a specific item, please post this here so I can update the list.

[rwjblue]

Thanks for putting the meta issue together @simonihmig!

[simonihmig]

@chriskrycho you mentioned in Discord that you could take over the ember-fetch/prefilter part. Is this still the case, can I assign you to this task? 👆

[chriskrycho]

Depends on when we want it done by. I'm starting a new job two weeks from today (very much still in Ember land), so I'm in wrapping-up-all-the-things mode now and will be in starting-all-the-things mode for the first couple weeks after that. I'm happy to do it, but given all fo that it'll probably be the second or third week of February before it's viable.

[bobisjan]

Thanks for this issue 👏!

I have a question if FastBoot should be included in this quest with deprecating and removing

• najax from fastboot,
• ajax initializer from ember-cli-fastboot?

[rwjblue]

@simonihmig - We need to add svelte support to the deprecations added in #17489 and #17488. The basic process is:

• add an entry in packages/@ember/deprecated-features/index.ts
• import that constant and use it to wrap all deprecated code paths in an if (I think this actually means all code that would be using the preexisting jQueryDisabled flag also gets the new guard)

Some recent examples:

• [DEPRECATION]Deprecate send action (RFC #335) #16744
• Deprecate Ember.merge #16956

[dcyriller]

@simonihmig you may want to add a lock on the item: "Update app blueprint"

[simonihmig]

@dcyriller cool, done! 👍

I am just thinking, switching the app blueprints to remove jQuery by default is certainly blocked by the outstanding ember-data issue. If that is not resolved by the time Ember 3.9 lands, we should probably do an intermediate step and update the blueprints to just bump the @ember/jquery version to 0.6.0, so an ember new app does not see any deprecations. And then switch to no jQuery mode as soon as ember-data is ready. @rwjblue agree?

[dcyriller]

@simonihmig understood! By chance, ember-cli/ember-cli#8396 would implement this intermediate step.

[rwjblue]

@simonihmig agree, I think that’s being done in ember-cli/ember-cli#8396