Bug Tracker

Opened 6 years ago

Closed 6 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:


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 6 years ago by dmethvin

Component: unfiledevent
Milestone: None1.8
Owner: set to dmethvin
Priority: undecidedlow
Status: newassigned

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 6 years ago by dmethvin

Resolution: fixed
Status: assignedclosed

Documentation updated.

Note: See TracTickets for help on using tickets.