Bug Tracker

Opened 5 years ago

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

Resolution: fixed
Status: assignedclosed

Documentation updated.

Note: See TracTickets for help on using tickets.