annotate default/node_modules/jquery/src/core/ready-no-deferred.js @ 0:1d038bc9b3d2 default tip

Up:default
author Liny <dev@neowd.com>
date Sat, 31 May 2025 09:21:51 +0800
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
1 define( [
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
2 "../core",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
3 "../var/document",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 "../var/isFunction"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 ], function( jQuery, document, isFunction ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 "use strict";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 var readyCallbacks = [],
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 whenReady = function( fn ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 readyCallbacks.push( fn );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 executeReady = function( fn ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 // Prevent errors from freezing future callback execution (gh-1823)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 // Not backwards-compatible as this does not execute sync
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 window.setTimeout( function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 fn.call( document, jQuery );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 jQuery.fn.ready = function( fn ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 whenReady( fn );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 jQuery.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 // Is the DOM ready to be used? Set to true once it occurs.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 isReady: false,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 // A counter to track how many items to wait for before
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 // the ready event fires. See #6781
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 readyWait: 1,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 ready: function( wait ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 // Abort if there are pending holds or we're already ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43 // Remember that the DOM is ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44 jQuery.isReady = true;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 // If a normal DOM Ready event fired, decrement, and wait if need be
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 if ( wait !== true && --jQuery.readyWait > 0 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 whenReady = function( fn ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 readyCallbacks.push( fn );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 while ( readyCallbacks.length ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 fn = readyCallbacks.shift();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 if ( isFunction( fn ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57 executeReady( fn );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 whenReady();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 // Make jQuery.ready Promise consumable (gh-1778)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67 jQuery.ready.then = jQuery.fn.ready;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 /**
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70 * The ready event handler and self cleanup method
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
71 */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
72 function completed() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
73 document.removeEventListener( "DOMContentLoaded", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 window.removeEventListener( "load", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75 jQuery.ready();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78 // Catch cases where $(document).ready() is called
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
79 // after the browser event has already occurred.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
80 // Support: IE9-10 only
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
81 // Older IE sometimes signals "interactive" too soon
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
82 if ( document.readyState === "complete" ||
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
83 ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
84
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
85 // Handle it asynchronously to allow scripts the opportunity to delay ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
86 window.setTimeout( jQuery.ready );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
87
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
88 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
89
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
90 // Use the handy event callback
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
91 document.addEventListener( "DOMContentLoaded", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
92
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
93 // A fallback to window.onload, that will always work
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
94 window.addEventListener( "load", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
95 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
96
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
97 } );