ЛУЧШИЙ САЙТ ДЛЯ ВЕБ-РАЗРАБОТЧИКОВ

JS Учебник

JS Старт JS Интро JS Установка JS Вывод JS Инструкции JS Синтаксис JS Комментарии JS Переменные JS Ключевое слово Let JS Ключевое слово Const JS Операторы JS Арифметические JS Присваивание JS Типы данных JS Функции JS Объекты JS События JS Строки JS Строковые методы JS Строковый поиск JS Строковые шаблоны JS Числа JS Числовые методы JS Массивы JS Методы массива JS Сортировка массива JS Итерация массива JS Массив Const JS Даты JS Форматы дат JS Методы получения дат JS Методы установки дат JS Математические JS Рандомные JS Булевы JS Сравнения JS Условия JS Switch JS Цикл For JS Цикл For In JS Цикл For Of JS Цикл While JS Break и Continue JS Итерации JS Наборы JS Карты JS Typeof JS Преобразование типов JS Побитовые JS Регулярные выражения JS Ошибки JS Область действия JS Хостинг JS Use Strict JS Ключевое слово this JS Функция стрелки JS Классы JS JSON JS Отладка JS Гид по стилю JS Лучшие практики JS Распространенные ошибки JS Производительность JS Зарезервированные слова

JS Версии

JS Версии JS 2009 (ES5) JS 2015 (ES6) JS 2016 JS 2017 JS 2018 JS IE/Edge JS История

JS Объекты

Определения объектов Свойства объекта Методы объекта Отображение объекта Доступ к объектам Конструкторы объектов Прототипы объектов Итерируемые объекты Наборы объектов Карты объектов Справочник объектов

JS Функции

Определения функций Параметры функции Обращение к функции Вызов функции Применение функции Закрытие функции

JS Классы

Введение Наследование класса Статические методы

JS Асинхронный

Обратные вызовы Асинхронный Промисы Async/Await

JS HTML DOM

DOM Введение DOM Методы DOM Документ DOM Элементы DOM HTML DOM Формы DOM CSS DOM Анимация DOM События DOM Слушатель событий DOM Навигация DOM Узлы DOM Коллекции DOM Узловые списки

JS Браузер BOM

JS Окно JS Скрин JS Локация JS История JS Навигатор JS Всплывающее оповещение JS Тайминг JS Куки

JS Веб API

Веб API Интро Веб-формы API Веб-история API Веб-хранилище API Веб-воркер API Веб-выборка API Веб-геолокация API

JS AJAX

AJAX Интро AJAX XMLHttp AJAX Запрос AJAX Отклик AJAX XML Файл AJAX PHP AJAX ASP AJAX База данных AJAX Приложения AJAX Примеры

JS JSON

JSON Введение JSON Синтаксис JSON и XML JSON Типы данных JSON Анализ JSON Stringify JSON Объекты JSON Массивы JSON Сервер JSON PHP JSON HTML JSON JSONP

JS и jQuery

jQuery Селекторы jQuery HTML jQuery CSS jQuery DOM

JS Примеры

JS Примеры JS HTML DOM JS HTML Input JS HTML Объекты JS HTML События JS Браузер JS Редактор JS Упражнения JS Викторина JS Сертификат

JS Справочники

JavaScript Объекты HTML DOM Объекты

JavaScript. W3Schools на русском. Уроки для начинающих

En Ua

JavaScript Промисы

"Я обещаю (promise) результат!"

"Продуцирование кода" ("Создание кода") - это код, который может занять некоторое время.

"Потребляющий код" - это код, который должен ждать результата.

Промис (promise - обещание) - это JavaScript объект, который связывает создание кода и использование кода.

JavaScript объект Промис

JavaScript объект Промис содержит как производящий код, так и вызовы потребляющего кода:

Синтаксис Промиса

let myPromise = new Promise(function(myResolve, myReject) {
// "Создание кода" (может занять некоторое время)

  myResolve(); // при успехе
  myReject();  // при ошибке
});

// "Потребляющий код" (необходимо дождаться выполнения Промиса)
myPromise.then(
  function(value) { /* код в случае успеха */ },
  function(error) { /* код в случае ошибки */ }
);

Когда производящий код получает результат, он должен вызвать один из двух обратных вызовов:

РезультатВызов
SuccessmyResolve(result value)
ErrormyReject(error object)

Свойства объекта Промис

JavaScript объект Промис может быть:

  • Pending (ожидает)
  • Fulfilled (выполнено)
  • Rejected (отклонено)

Объект Промис поддерживает два свойства: состояние и результат.

Пока объект Промис является "pending" (работает), результатом является undefined (не определен).

Пока объект Промис является "fulfilled" (выполнен), результатом является значение.

Пока объект Промис является "rejected" (отклонён), результатом является объект error (ошибка).

myPromise.statemyPromise.result
"pending"undefined
"fulfilled"результат значение
"rejected"объект error

Вы не можете получить доступ к свойствам Промиса состояние и результат.

Для обработки Промисов необходимо использовать метод Promise.


Как сделать Промис?

Вот как использовать Промис:

myPromise.then(
  function(value) { /* код в случае успеха */ },
  function(error) { /* код в случае ошибки */ }
);

Promise.then() принимает два аргумента: обратный вызов в случае успеха и другой в случае неудачи.

Оба варианта являются необязательными, поэтому вы можете добавить обратный вызов только в случае успеха или неудачи.

Пример

function myDisplayer(some) {
  document.getElementById("demo").innerHTML = some;
}

let myPromise = new Promise(function(myResolve, myReject) {
  let x = 0;

// Производящий код (это может занять некоторое время)

  if (x == 0) {
    myResolve("OK");
  } else {
    myReject("Error");
  }
});

myPromise.then(
  function(value) {myDisplayer(value);},
  function(error) {myDisplayer(error);}
);
Попробуйте сами »

JavaScript Примеры Промиса

Чтобы продемонстрировать использование промисов, мы будем использовать примеры обратного вызова из предыдущей главы:

  • Ожидание тайм-аута
  • Ожидание файла

Ожидание тайм-аута

Пример использования обратного вызова

setTimeout(function() { myFunction("I love You !!!"); }, 3000);

function myFunction(value) {
  document.getElementById("demo").innerHTML = value;
}
Попробуйте сами »

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

let myPromise = new Promise(function(myResolve, myReject) {
  setTimeout(function() { myResolve("I love You !!"); }, 3000);
});

myPromise.then(function(value) {
  document.getElementById("demo").innerHTML = value;
});
Попробуйте сами »

Ожидание файла

Пример использования обратного вызова

function getFile(myCallback) {
  let req = new XMLHttpRequest();
  req.open('GET', "mycar.html");
  req.onload = function() {
    if (req.status == 200) {
      myCallback(req.responseText);
    } else {
      myCallback("Error: " + req.status);
    }
  }
  req.send();
}

getFile(myDisplayer);
Попробуйте сами »

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

let myPromise = new Promise(function(myResolve, myReject) {
  let req = new XMLHttpRequest();
  req.open('GET', "mycar.htm");
  req.onload = function() {
    if (req.status == 200) {
      myResolve(req.response);
    } else {
      myReject("File not Found");
    }
  };
  req.send();
});

myPromise.then(
  function(value) {myDisplayer(value);},
  function(error) {myDisplayer(error);}
);
Попробуйте сами »

Поддержка браузерами

В ECMAScript 2015, также известном как ES6, появился JavaScript объект Promise.

В следующей таблице определяется первая версия браузера с полной поддержкой объектов Promise:

Chrome 33 Edge 12 Firefox 29 Safari 7.1 Opera 20
Feb, 2014 Jul, 2015 Apr, 2014 Sep, 2014 Mar, 2014