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

اسم چیزها

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

فعل + اسم = اسم تابع

حالا می‌توانی دو نیمه را کنار هم بگذاری: اول فعل، بعد چیزی که کار روی آن انجام می‌شود. sendMessage()، update_score()، hideButton()، validate_password(). این همان ترتیب جمله‌ی امری انگلیسی است: Send the message! فقط the حذف می‌شود. در فارسی فعل آخر می‌آید («پیام را بفرست»)، پس حواست باشد برعکس ننویسی: messageSend غلط است.

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

user (یوزِر): کاربر

user از use (استفاده کردن) و er ساخته شده: «کسی که استفاده می‌کند». هر کس با برنامه‌ی تو کار می‌کند یک user است. شاید پرکاربردترین اسم در همه‌ی کدهای دنیا باشد: user، users، user_id، currentUser، createUser(). user یک نفر است و users فهرستی از آدم‌ها.

Each user has a unique ID and an email address.

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

username (یوزِرنِیم): نام کاربری

username اسمی است که با آن وارد یک سایت می‌شوی، مثل sara_2012. با نام واقعی فرق دارد: باید یکتا باشد، معمولاً فاصله ندارد و فقط حرف، عدد و چند علامت در آن مجاز است. در کد آن را سر هم می‌نویسند: username، نه user_name. ولی اسمی مثل userName هم برای «نامِ کاربر» زیاد دیده می‌شود.

That username is already taken. Please choose another one.

آن نام کاربری قبلاً گرفته شده است. لطفاً یکی دیگر انتخاب کن.

password (پَسوِرد): رمز عبور

password از pass (رد شدن) و word (کلمه) ساخته شده: «کلمه‌ای که با گفتنش اجازه‌ی رد شدن می‌گیری»، مثل اسم شب نگهبان‌ها. در کد، هر متغیری که این اسم را دارد حساس است: هیچ‌وقت نباید چاپ شود، در لاگ بیاید یا همان‌طور ساده ذخیره شود. برنامه‌های درست فقط hash آن را نگه می‌دارند.

Never share your password with anyone, not even the admin.

رمز عبورت را هرگز به کسی نگو، حتی به مدیر.

message (مِسِج): پیام

message یعنی «پیام». در کد دو جور پیام داریم: پیامی که آدم‌ها برای هم می‌فرستند (chat message) و پیامی که برنامه به کاربر یا برنامه‌نویس می‌دهد (error message، commit message). متغیری به اسم message یا msg تقریباً همیشه یک رشته‌ی متن است که قرار است کسی آن را بخواند.

Read the error message carefully before you search for it.

پیام خطا را پیش از جست‌وجو کردنش با دقت بخوان.

score (اِسکور): امتیاز

score یعنی «امتیاز»: عددی که می‌گوید چقدر خوب بازی کرده‌ای یا در آزمون چند گرفته‌ای. در بازی‌ها همیشه هست: score، high_score، maxScore. فعل هم هست و یعنی «امتیاز گرفتن». خواننده از اسم score انتظار یک عدد دارد که با هر کار خوب بالا می‌رود.

Your score goes up by ten for every correct answer.

با هر جواب درست، امتیازت ده تا بالا می‌رود.

level (لِوِل): مرحله، سطح

level یعنی «سطح» یا «تراز»، مثل طبقه‌های یک ساختمان. در بازی یعنی مرحله: level 1، level 2. در جاهای دیگر یعنی درجه‌ی چیزی: log level می‌گوید چه پیام‌هایی ثبت شوند، access level می‌گوید کاربر تا کجا اجازه دارد و top-level یعنی بالاترین لایه‌ی کد، بیرون از همه‌ی تابع‌ها.

You need 100 points to reach the next level.

برای رسیدن به مرحله‌ی بعد ۱۰۰ امتیاز لازم داری.

button (باتِن): دکمه

button یعنی «دکمه»، هم دکمه‌ی پیراهن و هم دکمه‌ای که فشارش می‌دهی. در برنامه، button چیزی است که کاربر رویش کلیک می‌کند تا کاری انجام شود. در اسم‌ها معمولاً آخر می‌آید و قبلش می‌گویی دکمه‌ی چه کاری است: saveButton، login_button. کوتاه‌شده‌ی معروفش btn است.

Nothing happens when I click the save button.

وقتی روی دکمه‌ی ذخیره کلیک می‌کنم هیچ اتفاقی نمی‌افتد.

image (ایمِج): تصویر، عکس

image یعنی «تصویر»: هر عکس، نقاشی یا شکلی که روی صفحه دیده می‌شود. از photo کلی‌تر است، چون photo فقط عکسی است که با دوربین گرفته شده. کوتاه‌شده‌اش img است که اسم تگ عکس در HTML هم هست. اسم‌هایی مثل imageUrl، image_width و profile_image را زیاد می‌بینی.

The image is too large. Please upload a smaller one.

تصویر خیلی بزرگ است. لطفاً یک تصویر کوچک‌تر آپلود کن.

یک گزارش باگ

Bug: profile image is not saved

Steps:
1. Log in with a username and password.
2. Open the profile page and click the "Change image" button.
3. Choose a new image and click Save.

Expected: the new image is shown and the message "Profile updated" appears.
Actual: the button does nothing and there is no error message. The old image stays.

This happens for every user, at any level. My score and my level are saved without problems.

باگ: تصویر پروفایل ذخیره نمی‌شود

قدم‌ها:
۱. با یک نام کاربری و رمز عبور وارد شو.
۲. صفحه‌ی پروفایل را باز کن و روی دکمه‌ی «Change image» کلیک کن.
۳. یک تصویر تازه انتخاب کن و روی Save کلیک کن.

انتظار: تصویر تازه نشان داده شود و پیام «Profile updated» بیاید.
واقعیت: دکمه هیچ کاری نمی‌کند و هیچ پیام خطایی هم نیست. تصویر قدیمی می‌ماند.

این برای هر کاربری و در هر مرحله‌ای پیش می‌آید. امتیاز و مرحله‌ی من بدون مشکل ذخیره می‌شوند.