بتل کد Battle Codeدارد باز می‌شود…

ردپای خطا

وقتی خطا رخ می‌دهد، کامپیوتر ردپایش را هم چاپ می‌کند: از کجا آمد و کجا زمین خورد. با این کلمه‌ها می‌توانی آن چند خط ترسناک را مثل یک نقشه بخوانی.

شکل سوم فعل: raised، caught، handled

برای گفتن «کاری روی چیزی انجام شد» شکل سوم فعل می‌آید: The error was raised (خطا ایجاد شد)، was caught (گرفته شد)، was handled (رسیدگی شد). بیشتر فعل‌ها فقط ed می‌گیرند، ولی بعضی بی‌قاعده‌اند: catch می‌شود caught، نه catched. با un- هم برعکس می‌شوند: uncaught، ‏unhandled.

هشت کلمه‌ی این درس

traceback (تْرِیس‌بَک): ردپای خطا در پایتون

trace یعنی رد چیزی را گرفتن و back یعنی به عقب. traceback گزارشی است که پایتون موقع خطا چاپ می‌کند و رد خطا را به عقب می‌گیرد: برنامه از کدام خط شروع کرد، کدام تابع را صدا زد و آخر سر در کدام خط زمین خورد. آن را از پایین بخوان: خط آخر می‌گوید چه خطایی بود و خط‌های بالاتر می‌گویند کجا.

Please paste the full traceback so we can see the problem.

لطفاً کل ردپای خطا را این‌جا بگذار تا مشکل را ببینیم.

stack trace (اِستَک تْرِیس): فهرست تابع‌هایی که تا لحظه‌ی خطا صدا زده شده‌اند

stack یعنی پشته: چیزهایی که روی هم چیده شده‌اند، مثل بشقاب‌ها. وقتی تابعی تابع دیگر را صدا می‌زند، کامپیوتر آن‌ها را روی هم می‌چیند. stack trace عکسی از همین پشته در لحظه‌ی خطاست: فهرست تابع‌ها با اسم فایل و شماره‌ی خط. این اسم را در جاوااسکریپت و جاوا می‌گویند؛ پایتون به همین چیز traceback می‌گوید.

The stack trace shows that the error started in app.js.

ردپای پشته نشان می‌دهد که خطا از app.js شروع شده است.

most recent call last (موست ریسِنت کال لَست): تازه‌ترین فراخوانی در آخر آمده است

این جمله‌ی اول هر traceback پایتون است و راهنمای خواندن آن. recent یعنی تازه، most recent یعنی تازه‌ترین، call یعنی صدا زدن تابع و last یعنی آخر. روی هم: «تازه‌ترین فراخوانی آخر از همه آمده». یعنی فهرست به ترتیب زمان است و جایی که خطا واقعاً رخ داده، پایینِ پایین است.

A Python traceback starts with the words "most recent call last".

ردپای خطا در پایتون با جمله‌ی «تازه‌ترین فراخوانی در آخر» شروع می‌شود.

raised (رِیزد): ایجاد شد؛ (خطا) بلند شد

raise یعنی بلند کردن، مثل بلند کردن دست در کلاس. در پایتون وقتی کد به مشکلی می‌رسد، یک خطا «بلند می‌کند» تا بقیه‌ی برنامه خبردار شوند، و دستورش هم همین کلمه است: raise. raised شکل گذشته‌ی آن است و در مستندات زیاد می‌بینی: Raised when…، یعنی «این خطا وقتی ایجاد می‌شود که…».

A KeyError is raised when the key is not in the dictionary.

وقتی کلید در دیکشنری نباشد، یک KeyError ایجاد می‌شود.

caught (کات): گرفته شد (خطا)

catch یعنی گرفتن، مثل گرفتن توپ در هوا، و caught شکل گذشته‌ی بی‌قاعده‌ی آن است. اگر خطا را توپی بدانی که پرتاب شده، کدی که با try و catch (در پایتون: try و except) نوشته‌ای آن توپ را می‌گیرد. خطای گرفته‌شده برنامه را متوقف نمی‌کند: تو تصمیم می‌گیری بعدش چه شود.

The error was caught, so the program did not stop.

خطا گرفته شد و برای همین برنامه متوقف نشد.

handled (هَندِلد): رسیدگی شد؛ برایش فکری شده است

handle هم یعنی دستگیره و هم یعنی «از پس چیزی برآمدن». to handle an error یعنی برای خطا برنامه داشته باشی: آن را بگیری و کار درستی بکنی، مثلاً پیام مناسبی به کاربر نشان بدهی. handled یعنی «رسیدگی شد». برعکسش را بیشتر می‌بینی: unhandled، یعنی خطایی که هیچ‌کس فکری برایش نکرده بود.

This error is handled in the main function, not here.

به این خطا در تابع اصلی رسیدگی می‌شود، نه این‌جا.

uncaught (آن‌کات): گرفته‌نشده (خطا)

un- + caught یعنی «گرفته‌نشده». این کلمه را اول بیشتر خطاهای کنسول مرورگر می‌بینی: Uncaught TypeError، ‏Uncaught ReferenceError. معنی‌اش این است که خطایی پرتاب شد و هیچ try و catch‌ای آن را نگرفت، پس اجرای آن تکه از کد همان‌جا قطع شد. خودِ اشتباه را کلمه‌های بعد از Uncaught می‌گویند.

An uncaught error stopped the script on line 20.

یک خطای گرفته‌نشده اسکریپت را در خط ۲۰ متوقف کرد.

fatal (فِیتال): مرگ‌بار؛ خطایی که کار را کاملاً متوقف می‌کند

fatal در انگلیسی یعنی کشنده، مثل a fatal accident. در کامپیوتر fatal error خطایی است که برنامه بعد از آن نمی‌تواند ادامه بدهد و همان‌جا تمام می‌شود. با یک warning می‌شود ادامه داد، با fatal نه. گیت پیام‌های خطای جدی‌اش را با همین کلمه شروع می‌کند.

A fatal error occurred and the program had to close.

یک خطای مرگ‌بار رخ داد و برنامه مجبور شد بسته شود.

یک traceback را چطور بخوانیم

Traceback (most recent call last):
File "quiz.py", line 9, in <module>
show_score(player)
File "quiz.py", line 4, in show_score
print(player["score"])
KeyError: 'score'

How to read this traceback: start from the bottom. The last line is the error that was raised. The lines above it show the path to the error. Nobody caught this exception, so the program stopped. In JavaScript the same report is called a stack trace, and the error is marked as Uncaught. If the exception is handled with try and except, the program continues.

Traceback (most recent call last):
File "quiz.py", line 9, in <module>
show_score(player)
File "quiz.py", line 4, in show_score
print(player["score"])
KeyError: 'score'

این ردپا را چطور بخوانیم: از پایین شروع کن. خط آخر همان خطایی است که ایجاد شده. خط‌های بالای آن مسیر رسیدن به خطا را نشان می‌دهند. هیچ‌کس این استثنا را نگرفت و برای همین برنامه متوقف شد. در جاوااسکریپت به همین گزارش stack trace می‌گویند و خطا با کلمه‌ی Uncaught مشخص می‌شود. اگر با try و except به استثنا رسیدگی شود، برنامه ادامه پیدا می‌کند.