CKTIS / JavaScript
Promise.resolve — нормализиране на стойност до promise
Promise.resolve(value) позволява обикновена стойност, promise или thenable да се третира като promise. Може да върне съществуваща promise без промяна; resolved не означава, че резултатът вече е наличен или че операцията ще успее.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Promise.resolve(value)Promise.resolve(value) е статичен метод за нормализиране на стойност до promise. Ако аргументът бъде пропуснат, се използва undefined. Когато методът създаде нова promise, тя се изпълнява със стойността на аргумента, ако той е примитивна стойност или обект, чието свойство then се прочита без изключение и дава стойност, която не може да бъде извикана. Ако прочитането на then хвърли изключение, новата promise се отхвърля с това изключение като причина.
Ако p е истинска promise, Promise.resolve(p) прочита свойството ѝ constructor. Ако прочитането върне Promise, методът връща точно p. Ако гетърът на constructor хвърли изключение, методът го разпространява синхронно, преди да създаде нова promise, дори ако изчисляването на самия аргумент p е преминало без грешка. Методът създава нова promise, ако аргументът не е истинска promise или ако прочитането на свойството ѝ constructor върне стойност, различна от Promise. Обект thenable, тоест обект с извикваемо свойство then, се асимилира и резултатът следва крайния му изход, включително през други обекти thenable. Отхвърлянето си остава отхвърляне; resolved не означава fulfilled.
Функциите за обратно извикване, подадени на .then(), се изпълняват асинхронно, дори когато promise вече е изпълнена. Методът не прихваща грешки при изчисляването на аргумента: ако fn() хвърли изключение в Promise.resolve(fn()), извикването го хвърля синхронно. За да отложите извикването и да превърнете такова изключение в отхвърляне, използвайте Promise.resolve().then(() => fn()).
Примери
const p = Promise.resolve(7);
console.log(Promise.resolve(p) === p);
const thenable = { then(resolve) { resolve(42); } };
Promise.resolve(thenable).then(value => console.log(value));
console.log("sync");Резултат
true sync 42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.