fired()?callbacks.fired() returns a Boolean: true if fire() or fireWith() has run at least once on that list (since jQuery 1.7). It does not invoke handlers.
callbacks.fired() // false before any fire
callbacks.fire("x")
callbacks.fired() // true after
fire() → run handlers (action)
fired() → boolean status (question)| Need | Use |
|---|---|
| Has the list been invoked? | cbs.fired() |
| Invoke handlers | cbs.fire(args…) |
| Is the list shut down? | cbs.disabled() |
| Create the list | $.Callbacks([flags]) |
fired()Call it anytime you need a yes/no on whether the list has already published.
add() handlers.fired() before any fire — expect false.fire() or fireWith() when ready.fired() again — expect true from then on.| Piece | Required? | Role |
|---|---|---|
| Callbacks object | Yes | From $.Callbacks() |
| Arguments | None | fired() takes no parameters |
| Return | — | Boolean — has the list fired? |
function fired(callbacks):
return callbacks.hasBeenInvokedAtLeastOnce
// After fire() or fireWith() succeeds:
// hasBeenInvokedAtLeastOnce = true
// Later ignored fires (e.g. once) keep it trueKeep these facts handy when checking Callbacks status.
| Topic | Detail |
|---|---|
| Syntax | callbacks.fired() |
| Since | jQuery 1.7 |
| Returns | true / false |
| Sets flag | fire() / fireWith() |
| Does not fire | Read-only check |
| Related status | disabled(), locked() |
Watch fired() flip from false to true after you fire the list.
Short, copy-ready snippets. Open DevTools Console, or use Try It Yourself for a live editor.
fire()Official style: fire the list, then call fired().
var foo = function (value) {
console.log("foo: " + value);
};
var callbacks = $.Callbacks();
callbacks.add(foo);
callbacks.fire("hello");
callbacks.fire("world");
console.log(callbacks.fired()); // truefoo with add().fired() returns true because invocation happened.fired().A fresh list has not been invoked yet.
var cbs = $.Callbacks();
cbs.add(function () { /* ... */ });
console.log(cbs.fired()); // false
cbs.fire();
console.log(cbs.fired()); // truefired() is false.true.onceIgnored second fires do not reset the flag.
var cbs = $.Callbacks("once");
cbs.add(function (msg) { console.log(msg); });
cbs.fire("first");
console.log(cbs.fired()); // true
cbs.fire("second"); // ignored
console.log(cbs.fired()); // still truefire() to run handlers.fired() stays true — “has ever fired,” not “will fire again.”fireWith() Also CountsCustom-context fires mark the list the same way.
var cbs = $.Callbacks();
cbs.add(function (label) {
console.log(this.id + ": " + label);
});
console.log(cbs.fired()); // false
cbs.fireWith({ id: "box" }, ["ready"]);
console.log(cbs.fired()); // truefalse.this.fired() becomes true.fire and fireWith count as “invoked.”Do not confuse status checks with actions.
fired() never runs handlersUse fire() to publish. fired() only answers a yes/no question.
Calling fire() with no handlers still marks the list as fired.
disabled()A list can be fired and still enabled, or disabled without ever firing. Check both when debugging.
fired()Flags belong on $.Callbacks("once memory") at creation time.
callbacks.fired() has shipped since jQuery 1.7 with $.Callbacks. It works in all modern browsers with jQuery loaded.
Boolean status helper — true after fire() or fireWith() has run at least once.
Bottom line: Call fired() with no arguments. Pair it with fire() for publish and disabled() / locked() for other statuses.
| Approach | Cost | Best for |
|---|---|---|
fired() | O(1) | Status checks / guards |
fire() | O(n) handlers | Actually invoking the list |
| Own boolean flag | O(1) | Fine, but fired() is built-in |
Reading fired() is cheap. Prefer it over maintaining a separate hasFired variable next to a Callbacks list.
fire() and fireWith().true even when later fires are ignored.disabled() for shutdown status.One line: fired() answers “has this Callbacks list been invoked at least once?” — it never runs the handlers itself.
Learn how to permanently shut down a Callbacks list.
7 people found this page helpful