jQuery метод .notify()

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

jQuery метод .notify() запускает событие прогресса выполнения с определенными аргументами, которое позволяет вызвать обработчики состояния объекта Deferred, находящегося на стадии выполнения (функции прогресса выполнения progressCallbacks - deferred.progress() и deferred.then()).

Когда метод .notify() вызывается, любые добавленные объектом Deferred функции прогресса выполнения (progressCallbacks) вызываются. Обратные вызовы выполняются в порядке их добавления. Каждому обратному вызову могут передоваться дополнительные аргументы от метода .notify().

Любые вызовы метода .notify(), добавленные после того как объект Deferred переходит в состояние resolved (успешное выполнение), или rejected (выполнение отклонено) будут игнорированы.

Если у Вас есть необходимость указывать определенный контекст исполнения, то вы можете воспользоваться методом deferred.notifyWith().

jQuery синтаксис:

Синтаксис 1.7:

deferred.notify()
deferred.notify( args )

args - Any

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

Значения параметров

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

Пример использования jQuery метода .progress() и .notify()

Нажмите ▶, затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.

index.html

HTML

<button class="start">Старт</button> <meter value="0" min="0" max="100" low="40" high="70" optimum="90"></meter
><span></span>
<p></p>

main.js

JavaScript

$(document).ready(function () {
    let dfd = $.Deferred()

    dfd.progress(function (p) {
        $('meter').attr('value', p)
        $('span').html(p)
    }).done(function () {
        $('p').html('операция завершена')
    })

    $('.start').click(function () {
        for (let i = 10; i <= 100; i = i + 10) {
            setTimeout(() => {
                dfd.notify(i)
                if (i == 100) {
                    dfd.resolve()
                }
            }, i * 50)
        }
    })
})

В этом примере мы инициализируем переменную, которая содержит объект Deferred, созданный с помощью фабричной функции $.Deferred(). С помощью метода .progress() добавляем обработчик, вызываемый когда объект Deferred создает уведомления о ходе выполнения. Когда это происходит мы с помощью метода .attr() устанавливаем новое значение атрибуту value элемента <meter> значением, полученным от метода .notify(). Кроме того, мы с помощью метода .html() помещаем это значение в качестве содержимого элемента <span>.

При нажатии на элемент <button>, благодаря установленному обработчику событий "click" на элементе мы запускаем цикл, который увеличивает значение переменной i до 100 с шагом 10. Внутри цикла с помощью метода setTimeout мы выполняем функцию после определенной задержки, которая с помощью метода .notify() запускает событие прогресса выполнения, и в качестве аргумента использует текущее значение переменной цикла.

При достижении переменной значения равному 100 мы с помощью метода .resolve() изменяем состояние объекта Deferred на resolved (успешное выполнение). Обратите внимание, что у нас на объекте Deferred с помощью метода .done() установлен обработчик, который будет вызван при изменении состояния объекта Deferred на resolved и с помощью метода .html() задаст содержимое элемента текстовой информацией.