باگ Promise که Bun و Safari رو برای همیشه منتظر میذاشت
خلاصهٔ کاملتر
نویسنده با یه برنامهٔ کوتاه شروع میکنه که تا جولای توی Bun و Safari هیچوقت تموم نمیشد. اینجا constructor یه promise با یه شیء عوض شده که getter مربوط به Symbol.species توش خطا پرتاب میکنه:
const p = Promise.resolve(1);
p.constructor = {
get [Symbol.species]() {
throw new Error("boom");
},
};
console.log("before");
await p;
console.log("done");طبق spec جاوااسکریپت، چون getter خطا میده، await p هم باید خطا بده و برنامه crash کنه. Node.js همین کارو میکنه، ولی Safari 26 و Bun 1.3.14 کلمهٔ before رو چاپ میکنن، خطا رو گزارش میدن و بعد گیر میکنن. دلیلش اینه که هر دو از موتور JavaScriptCore استفاده میکنن و توش promise هیچوقت settle نمیشد. این باگ WebKit شمارهٔ 318399 بود و نویسنده توی PR شمارهٔ 68749 رفعش کرده، با فقط 16 خط اضافه.
برای فهمیدن مشکل، نویسنده یه پیادهسازی ساده به اسم MediocrePromise نشون میده که فقط سه حالت pending، resolved و rejected داره. به گفتهٔ نویسنده این مدل ذهنی رایجه ولی غلطه. reject(reason) سادهست و فقط promise رو با اون دلیل rejected میکنه. اما resolve(value) اول چک میکنه value متد .then() داره یا نه.
اگه نداشته باشه، promise با همون مقدار fulfilled میشه. اگه داشته باشه، value یه thenable حساب میشه، یعنی هر چیزی که متد .then() داره، و هر promise هم یه thenable هست. در این حالت promise بیرونی هنوز settle نشده و resolve و reject خودش رو به value.then() میده تا اون بعداً نتیجه رو مشخص کنه. spec به این کار میگه assimilation، ولی نویسنده اسم سادهتر «flattening» رو پیشنهاد میده، چون دو لایه promise یکی میشن.
نکتهٔ مهم اینجاست که خوندن value.then خودش ممکنه یه getter رو اجرا کنه و اون getter خطا بده، دقیقاً مثل برنامهٔ اول. پس سه حالت ممکنه پیش بیاد و موتور باید حالت خطا رو هم مدیریت کنه و promise رو reject کنه. نویسنده میگه این عدم تقارن بین resolve و reject به این خاطره که شکست یه عملیات pending نیست: دلیل خطا همون لحظه دستته، ولی مقدار موفق ممکنه بعداً برسه، مثل response.json().
یه اشتباه دیگهٔ MediocrePromise اینه که «resolved» اصلاً یه state واقعی نیست. وقتی resolve صدا زده میشه، promise به یه نتیجه قفل میشه ولی میتونه هنوز pending بمونه تا thenable داخلی تموم بشه.
نکات کلیدی:
- Safari 26 و Bun 1.3.14 روی این برنامه گیر میکردن ولی Node.js طبق spec خطا میداد
- مشکل توی JavaScriptCore بود و با باگ WebKit 318399 ثبت شد
- رفع باگ توی PR شمارهٔ 68749 فقط 16 خط کد اضافه کرد
- thenable یعنی هر مقداری که متد .then() داره و همهجا مثل promise رفتار میکنه
- resolve با خوندن .then ممکنه یه getter پرخطا رو اجرا کنه، ولی reject همیشه مستقیم settle میکنه
- «resolved» یه state واقعی نیست و promise قفلشده میتونه هنوز pending باشه




