jQuery метод .locked()

Определение и применение

jQuery метод .locked() объекта Callbacks возвращает логическое значение, которое указывает на то, заблокирован ли список обратных вызовов, или нет.

jQuery синтаксис:

Синтаксис 1.7:
callbacks.locked()

Добавлен в версии jQuery

Пример использования

// возвращаем объект Callbacks и инициализируем переменную этим значением
let myCallbacks = $.Callbacks();

// создаем функции и инициализируем переменные этими значениями
const fn1 = (val) => console.log("1 " + val),
            fn2 = (val) => console.log("2 " + val);

// добаляем функцию обратного вызова в список обратных вызовов объекта
myCallbacks.add( fn1 ); 

// вызываем все ранее добавленные функции обратного вызова с заданным аргументом
myCallbacks.fire( "hello" );

// вывод в консоль:
1 hello

// проверяем заблокирован ли список
myCallbacks.locked();
false

// блокируем список обратных вызовов в текущем состоянии
myCallbacks.lock();

// вызываем все ранее добавленные функции обратного вызова с заданным аргументом
myCallbacks.fire( "hello" );

// вызов функций не произойдет так как список заблокирован

// проверяем заблокирован ли список
myCallbacks.locked();
true

// добаляем вторую функцию обратного вызова в список обратных вызовов объекта
myCallbacks.add( fn2 ); 

// вызываем все ранее добавленные функции обратного вызова с заданным аргументом
myCallbacks.fire( "hello" );

// вызов функций не произойдет так как список заблокирован

В этом примере мы рассмотрели базовое использование функции $.Callbacks(), которую мы вызвали без параметра и возвратили объект Callbacks. После этого инициализировали две переменные, которые содержат стрелочную функцию.

После этого с помощью метода .add() объекта Callbacks мы добавили функцию в список обратных вызовов объекта Callbacks, и с помощью метода .fire() этого объекта вызываем все ранее добавленные функции обратного вызова с заданным аргументом. В результате чего мы вывели в консоль текстовое сообщение.

Далее с помощью метода callbacks.locked() мы определяем заблокирован ли список обратных вызовов, или нет, по очевидным причинам мы получаем логическое значение false, которое указывает на то, что список не заблокирован. После этого мы используем метод .lock(), который блокирует список обратных вызовов, и с помощью метода .fire() этого объекта вызываем все ранее добавленные функции обратного вызова с заданным аргументом. По той причине, что список заблокирован вызов нашей функции не произошел.

С помощью метода .locked() мы определяем заблокирован ли список обратных вызовов, и получаем логическое значение true, которое свидетельствует, что наш список действительно заблокирован. И наконец, с помощью метода .add() объекта Callbacks мы добавили функцию в список обратных вызовов объекта Callbacks, и с помощью метода .fire() этого объекта вызываем все ранее добавленные функции обратного вызова с заданным аргументом. Как вы можете заметить вызов наших функций не произошел по причине того, что список заблокирован.