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

فرستادن و نشان دادن

برنامه‌ها مدام با بیرون حرف می‌زنند: داده می‌فرستند، می‌گیرند و نتیجه را روی صفحه می‌آورند. این فعل‌ها می‌گویند داده به کدام طرف می‌رود و چه بر سرش می‌آید.

جفت‌های متضاد

خیلی از اسم‌ها جفت دارند و خواننده انتظار دارد هر دو را ببیند: send و receive، show و hide، open و close، start و stop. جفت‌ها را قاطی نکن: اگر تابعی showMenu() است، آن یکی hideMenu() باشد، نه closeMenu() یا removeMenu(). جفتِ درست باعث می‌شود اسم تابع دوم را بدون گشتن حدس بزنی.

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

send (سِند): فرستادن

send یعنی «فرستادن». تابعی که با send شروع می‌شود چیزی را از برنامه‌ی تو بیرون می‌فرستد: به سرور، به یک کاربر دیگر، به ایمیل کسی. sendMessage() پیام می‌فرستد و send_email() ایمیل. خواننده می‌داند که این تابع با بیرون از برنامه سر و کار دارد و ممکن است طول بکشد یا شکست بخورد.

The form sends your data to the server.

فرم داده‌های تو را به سرور می‌فرستد.

receive (ریسیو): دریافت کردن

receive یعنی «دریافت کردن» و جفت send است: یکی می‌فرستد و دیگری می‌گیرد. در اسم‌ها جایی می‌آید که چیزی از بیرون به برنامه‌ی تو می‌رسد: onMessageReceived وقتی اجرا می‌شود که پیامی رسیده باشد. فرقش با get این است که در get تو می‌روی سراغ داده، ولی در receive داده خودش می‌آید.

The server received the request but sent no response.

سرور درخواست را دریافت کرد ولی جوابی نفرستاد.

fetch (فِچ): رفتن و آوردن (داده از جای دور)

fetch یعنی «بروی و چیزی را بیاوری»، مثل سگی که توپ را می‌دود و می‌آورد. در کد، fetch یعنی داده را از جایی دور مثل سرور یا اینترنت بیاوری. پس فرقش با get این است که fetchUser() به خواننده می‌گوید «این کار راه دور است و طول می‌کشد»، ولی getUser() می‌تواند فقط خواندن از حافظه باشد.

The page fetches the latest scores every ten seconds.

صفحه هر ده ثانیه تازه‌ترین امتیازها را می‌آورد.

handle (هَندِل): رسیدگی کردن، از پسِ چیزی برآمدن

handle به‌عنوان اسم یعنی «دسته» یا «دستگیره» و از hand (دست) می‌آید. فعلش یعنی «چیزی را به دست گرفتن و رسیدگی کردن». تابعی که با handle شروع می‌شود می‌گوید «وقتی این اتفاق افتاد، من جوابش را می‌دهم»: handleClick() برای کلیک و handleError() برای خطا. به چنین تابعی handler می‌گویند.

This function handles the click on the save button.

این تابع به کلیک روی دکمه‌ی ذخیره رسیدگی می‌کند.

render (رِندِر): از داده، تصویر یا صفحه ساختن

render یعنی داده یا دستور را به چیزی تبدیل کنی که چشم می‌بیند. مرورگر کد HTML را render می‌کند تا صفحه دیده شود؛ موتور بازی صحنه‌ی سه‌بعدی را render می‌کند تا تصویر ساخته شود. تابعی مثل renderList() از روی داده‌ها تکه‌ای از صفحه را می‌سازد. فرقش با show این است که render می‌سازد، ولی show چیزِ ساخته‌شده را آشکار می‌کند.

The browser renders the HTML and shows the page.

مرورگر HTML را رندر می‌کند و صفحه را نشان می‌دهد.

show (شو): نشان دادن

show یعنی «نشان دادن». تابعی که با show شروع می‌شود چیزی را که پنهان بود جلوی چشم کاربر می‌آورد: showMenu() منو را باز می‌کند و showError() پیام خطا را می‌آورد. جفتش hide است. اسمی مثل show_hints هم می‌تواند یک متغیر true و false باشد: «راهنماها را نشان بده؟».

Click the eye icon to show your password.

برای دیدن رمز عبورت روی نشان چشم کلیک کن.

hide (هاید): پنهان کردن

hide یعنی «پنهان کردن»؛ قایم‌باشک در انگلیسی hide and seek است. تابعی که با hide شروع می‌شود چیزی را از جلوی چشم برمی‌دارد ولی نابودش نمی‌کند: hideMenu() منو را می‌بندد و بعداً می‌شود دوباره نشانش داد. این فرق مهم hide با remove است.

You can hide this panel by pressing the Escape key.

با زدن کلید Escape می‌توانی این پنل را پنهان کنی.

display (دیسپلِی): نمایش دادن؛ نمایشگر

display یعنی «به نمایش گذاشتن» و به‌عنوان اسم یعنی «نمایشگر». معنی‌اش به show نزدیک است ولی رسمی‌تر است و بیشتر در مستندات و پیام‌ها می‌آید. displayResult() نتیجه را روی صفحه می‌آورد و displayName اسمی است که به بقیه نشان داده می‌شود، نه نام کاربری واقعی.

The page displays an error message if the login fails.

اگر ورود ناموفق باشد، صفحه یک پیام خطا نمایش می‌دهد.

توضیح یک commit

Fix the chat page

The chat page did not show new messages. The client could send a message, but when it received an answer, nothing was displayed.

Changes:
- fetch the last 20 messages when the page opens
- handle the "message" event and render the new message at the bottom
- show a small error box if the server does not answer
- hide the error box after five seconds

درست کردن صفحه‌ی چت

صفحه‌ی چت پیام‌های تازه را نشان نمی‌داد. کلاینت می‌توانست پیام بفرستد، ولی وقتی جوابی دریافت می‌کرد، چیزی نمایش داده نمی‌شد.

تغییرها:
- هنگام باز شدن صفحه، ۲۰ پیام آخر را بیاور
- به رویداد "message" رسیدگی کن و پیام تازه را پایین صفحه رندر کن
- اگر سرور جواب نداد، یک کادر کوچک خطا نشان بده
- بعد از پنج ثانیه کادر خطا را پنهان کن