لاراول ۱۳.۳۵: تست fakeها با آرایه به جای callback
خلاصهٔ کاملتر
تو لاراول، برای اینکه تو تست چک کنی کدوم job تو صف رفته یا کدوم event و notification فرستاده شده، از _fake_ها استفاده میکنی (یعنی نسخههای ساختگی Queue و Event و بقیه که به جای اجرای واقعی، فقط ثبت میکنن چی صدا زده شده). تا قبل از نسخه 13.35، اگه میخواستی پراپرتیهای اون job رو هم چک کنی، باید یه callback مینوشتی که هر پراپرتی رو جدا مقایسه کنه. به گفته Laravel News، از 13.35 به بعد میشه همین کارو با یه آرایه انجام داد.
مثلاً برای job ای به اسم ProcessPodcast حالا اینجوری مینویسی:
Queue::assertPushed(ProcessPodcast::class, [
'podcast' => $podcast,
'user' => $user,
'status' => 'pending',
]);همین الگو برای Event::assertDispatched، Bus::assertDispatched و Notification::assertSentTo هم کار میکنه. نسخههای منفی و متفاوت مثل assertNotPushed()، assertPushedOn()، assertNotDispatched() و assertNotSentTo() هم آرایه قبول میکنن. فقط باید اسم کلاس رو آرگومان اول بدی؛ اون حالتی از assertPushed() که فقط یه closure تایپدار میگیره، آرایه قبول نمیکنه.
نحوه مقایسه مهمه: همه کلیدهای آرایه باید match بشن و هر مقدار با === (مقایسه سختگیرانه) چک میشه. یه استثنا داره: اگه هر دو طرف مدل Eloquent باشن، با $model->is() مقایسه میشن که کلید اصلی، جدول و connection رو چک میکنه. نتیجهش اینه که دو تا شیء Carbon برای یه لحظه یکسان، باز هم دو شیء جدان، پس 'scheduled_at' => now() شکست میخوره. برای تاریخ، value object یا collection هنوز باید callback بنویسی.
چند تا محدودیت دیگه هم هست. آرایه فقط پراپرتیهای سطح اول رو چک میکنه و dot notation برای مقدارهای تودرتو نداره. چون fake از بیرون شیء پراپرتی رو میخونه، پراپرتیها باید public باشن؛ اگه دیتا تو پراپرتی protected یا پشت getter باشه، باز callback لازمه. constructor property promotion با public مشکلی نداره. یه نکته خوب هم اینه که اگه اسم یه پراپرتی رو اشتباه تایپ کنی، به جای خطا، تست fail میشه و سریع متوجه میشی.
نکات کلیدی:
- قابلیت از لاراول 13.35 اومده و Jack Bayliss تو PR شماره 61770 اضافهش کرده.
- برای fakeهای Queue، Bus، Event و Notification کار میکنه.
- مقایسه با === انجام میشه، به جز مدلهای Eloquent که با is() چک میشن.
- برای Carbon، value object و collection هنوز callback لازمه.
- فقط پراپرتیهای public و سطح اول پشتیبانی میشن، بدون dot notation.




