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

بررسی و تبدیل

داده‌ای که از کاربر یا اینترنت می‌رسد خام است: باید بررسی شود، خوانده شود و به شکل درست دربیاید. این فعل‌ها اسم همین قدم‌ها هستند.

از فعل به اسم با -ion

خیلی از این فعل‌ها با پسوند -ion (یا -ation) اسم می‌شوند: validate می‌شود validation، verify می‌شود verification، calculate می‌شود calculation، generate می‌شود generation و convert می‌شود conversion. فعل را در اسم تابع می‌بینی (validateForm) و اسم را در پیام‌ها و مستندات: Validation failed یعنی «اعتبارسنجی ناموفق بود».

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

check (چِک): بررسی کردن، نگاه کردن که درست است یا نه

check یعنی «یک نگاه انداختن تا مطمئن شوی»، مثل وقتی قبل از بیرون رفتن جیبت را برای کلید می‌گردی. تابعی که با check شروع می‌شود چیزی را بررسی می‌کند و نتیجه را می‌گوید: checkAnswer() می‌گوید جواب درست بود یا نه. check کلی‌ترین فعل بررسی است؛ validate و verify دقیق‌ترند.

Please check your internet connection and try again.

لطفاً اتصال اینترنتت را بررسی کن و دوباره امتحان کن.

validate (وَلیدِیت): بررسی این‌که داده طبق قانون است

validate از valid می‌آید که یعنی «معتبر». validate کردن یعنی بررسی کنی که یک داده شکل و قانون درست را دارد: ایمیل علامت @ دارد؟ سن عددی بین ۱ و ۱۲۰ است؟ رمز دست‌کم هشت حرف دارد؟ تابعی مثل validateEmail() معمولاً روی چیزی کار می‌کند که کاربر در یک فرم نوشته است.

Always validate user input before saving it.

همیشه ورودی کاربر را پیش از ذخیره کردن اعتبارسنجی کن.

verify (وِریفای): مطمئن شدن که چیزی راست است

verify یعنی «ثابت کردن که چیزی راست و واقعی است». فرقش با validate این است: validate به شکل نگاه می‌کند و verify به واقعیت. ایمیلی که @ دارد valid است، ولی وقتی روی لینک داخل ایمیل کلیک کردی و معلوم شد واقعاً مالِ توست، verified می‌شود. verifyPassword() و verify_code() از همین جنس‌اند.

We sent you a code to verify your email address.

برای تأیید نشانی ایمیلت یک کد برایت فرستادیم.

parse (پارس): متن را خواندن و به داده تبدیل کردن

parse در اصل یک کلمه‌ی دستور زبان است: یعنی جمله را به فعل و فاعل و بقیه‌ی تکه‌هایش جدا کنی تا معنی‌اش را بفهمی. در کد، parse یعنی یک متن خام را بخوانی و از آن داده‌ی قابل استفاده بسازی: از متن "42" عدد 42، از یک متن JSON یک شیء. اگر متن شکل درستی نداشته باشد، خطای parse می‌گیری.

The app failed to parse the server response.

برنامه نتوانست جواب سرور را تجزیه کند.

format (فورمَت): شکل و قالب دادن

format یعنی «قالب» و به‌عنوان فعل یعنی «در قالب ریختن». تابعی مثل formatDate() خودِ داده را عوض نمی‌کند، فقط ظاهرش را برای نشان دادن مرتب می‌کند: عدد 1500000 می‌شود 1,500,000 و یک تاریخ می‌شود 2026/11/13. مرتب کردن ظاهر کد را هم format کردن می‌گویند.

This function formats the price with two decimal places.

این تابع قیمت را با دو رقم اعشار قالب‌بندی می‌کند.

convert (کانوِرت): تبدیل کردن از یک نوع به نوع دیگر

convert یعنی «چیزی را به چیز دیگری بدل کردن»: دلار به تومان، کیلومتر به مایل. در کد، convert نوع یا واحد داده را عوض می‌کند: رشته به عدد، سانتی‌گراد به فارنهایت، PNG به JPG. این‌جور تابع‌ها را خیلی وقت‌ها با to هم اسم می‌گذارند: toString()، to_celsius().

You need to convert the string to a number first.

اول باید رشته را به عدد تبدیل کنی.

calculate (کَلکیولِیت): حساب کردن

calculate یعنی «حساب کردن»؛ ماشین‌حساب هم calculator است. تابعی که با calculate شروع می‌شود چند عدد می‌گیرد، رویشان حساب می‌کند و جواب را برمی‌گرداند: calculateTotal()، calculate_average(). خواننده می‌فهمد که این‌جا جواب آماده نیست و باید به دست بیاید.

The app calculates the total price of your order.

برنامه قیمت کل سفارشت را حساب می‌کند.

generate (جِنِرِیت): تولید کردن، خودکار ساختن

generate یعنی «تولید کردن»؛ ژنراتور برق هم generator است. در کد، generate یعنی برنامه خودش چیزی را از روی یک قاعده بسازد: یک رمز تصادفی، یک شناسه، یک گزارش، یک تصویر. فرقش با create این است که در generate ماشین محتوا را درمی‌آورد، نه این‌که تو تکه‌تکه به آن بدهی.

Click here to generate a strong random password.

برای ساختن یک رمز عبور تصادفی و قوی این‌جا کلیک کن.

ثبت‌نام چطور کار می‌کند

How sign-up works

1. The app checks that all fields are filled in.
2. It validates the email: the text must look like a real email address.
3. It parses the birth date and converts it to a date object.
4. It calculates the age of the user from the birth date.
5. It generates a six-digit code and sends it to the email address.
6. The user types the code. The app verifies it. Now we know the email really belongs to this user.

ثبت‌نام چطور کار می‌کند

۱. برنامه بررسی می‌کند که همه‌ی فیلدها پر شده باشند.
۲. ایمیل را اعتبارسنجی می‌کند: متن باید شبیه یک نشانی ایمیل واقعی باشد.
۳. تاریخ تولد را تجزیه می‌کند و آن را به یک شیء تاریخ تبدیل می‌کند.
۴. سن کاربر را از روی تاریخ تولد حساب می‌کند.
۵. یک کد شش‌رقمی تولید می‌کند و آن را به نشانی ایمیل می‌فرستد.
۶. کاربر کد را می‌نویسد. برنامه آن را تأیید می‌کند. حالا می‌دانیم ایمیل واقعاً مالِ همین کاربر است.