Bug Tracker

Opened 4 years ago

Closed 4 years ago

#11719 closed enhancement (fixed)

Deprecate .bind("ready") event

Reported by: dmethvin Owned by: dmethvin
Priority: low Milestone: 1.8
Component: event Version: 1.7.2
Keywords: Cc:
Blocked by: Blocking:

Description

The "ready" event is error prone because users may attach an event handler after it has fired. It is much more natural for ready semantics to follow the Promise model; if handlers are added after the document is ready then they will fire. We're adding a ready Promise in 1.8 (see #11470) and of course the standard $(fn) or $().ready(fn) continue to work without change.

Let's deprecate the ready event as of 1.8; there is no hurry to remove it, but let's help users avoid dumb errors caused by dumb APIs.

Change History (2)

comment:1 Changed 4 years ago by dmethvin

  • Component changed from unfiled to event
  • Milestone changed from None to 1.8
  • Owner set to dmethvin
  • Priority changed from undecided to low
  • Status changed from new to assigned

Just to be absolutely clear what is being deprecated here, it is these forms:

$(document).bind("ready", fn);
$(document).on("ready", fn);

Where "ready" is a custom event name that is only fired once by jQuery when the document becomes ready.

comment:2 Changed 4 years ago by dmethvin

  • Resolution set to fixed
  • Status changed from assigned to closed

Documentation updated.

Note: See TracTickets for help on using tickets.