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

جلسه‌ی 17: خروجی و نصب Take It Home

اپت را از استودیو بیرون می‌بری: یک فایل HTML که روی هر گوشی باز می‌شود، با اسم و آیکون خودش روی صفحه‌ی اصلی. یاد می‌گیری با try و catch جلوی خراب شدن اپ را بگیری.

در این جلسه یاد می‌گیری

درس

تا حالا اپ‌هایت فقط در استودیو زندگی می‌کردند. در صفحه‌ی پروژه، در بخش «۳. اجرا»، دکمه‌ی «خروجی بگیر (فایل HTML)» را بزن. یک فایل .html دانلود می‌شود که همه‌چیز داخلش است: کد تو و کمک‌کار salam. این فایل بدون اینترنت و بدون استودیو، در هر مرورگری کار می‌کند.

فایل را با کمک یک بزرگ‌تر به گوشی بفرست (با کابل یا برای خودت در یک پیام‌رسان) و با مرورگر گوشی بازش کن. در فایل خروجی، salam.save داده‌ها را در حافظه‌ی همان مرورگر نگه می‌دارد. پس اپ در همان گوشی و همان مرورگر یادش می‌ماند، نه در گوشی دیگر.

حالا آن را مثل یک اپ واقعی روی صفحه‌ی گوشی بگذار: در منوی مرورگر (سه نقطه‌ی بالا، یا دکمه‌ی اشتراک در آیفون) گزینه‌ی «افزودن به صفحه‌ی اصلی» (Add to Home Screen) را بزن. یک آیکون روی صفحه می‌آید که با یک ضربه اپت را باز می‌کند. اگر مرورگرت این گزینه را برای فایل نداشت، صفحه را نشانک (bookmark) کن.

زیر آیکون چه نوشته می‌شود؟ اسمی که در <title> است! استودیو موقع خروجی از اسم پروژه یک عنوان و یک آیکون در فایل می‌گذارد، ولی خودت هم می‌توانی آن‌ها را بنویسی. <meta name="theme-color"> رنگ نوار بالای مرورگر گوشی را هم‌رنگ اپت می‌کند. عنوان کوتاه بگذار تا زیر آیکون جا شود.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#0288d1">
<title>Water</title>
<style>
header { background-color: #0288d1; color: white; padding: 12px; }
</style>
</head>
<body>
<header><h1>Water</h1></header>
</body>
</html>

روی گوشی هر کسی هر چیزی تایپ می‌کند! بعضی کارها وقتی ورودی بد است خطا می‌دهند و بقیه‌ی کد دیگر اجرا نمی‌شود. مثلاً JSON.parse متن JSON را به آرایه برمی‌گرداند، ولی با متن خراب خطا می‌دهد. try یعنی «امتحان کن» و catch یعنی «اگر خطا شد، این کار را بکن». دکمه را با متن درست و خراب امتحان کن.

<textarea id="data">["milk", "bread"]</textarea>
<button onclick="read()">Read</button>
<p id="msg"></p>

<script>
function read() {
  try {
    let list = JSON.parse(document.getElementById("data").value);
    document.getElementById("msg").textContent = "OK: " + list.length + " items";
  } catch (error) {
    document.getElementById("msg").textContent = "This is not valid data.";
  }
}
</script>

خودت هم می‌توانی خطا بسازی! throw new Error("...") یعنی «همین‌جا بایست، این مشکل است». catch آن را می‌گیرد و error.message همان جمله است. این‌طوری هر مشکل یک پیام مهربان خودش را دارد.

<input id="goal" inputmode="numeric" placeholder="8">
<button onclick="setGoal()">Set goal</button>
<p id="msg"></p>

<script>
function readGoal(text) {
  let n = Number(text);
  if (text.trim() === "" || isNaN(n)) {
    throw new Error("Please type a number.");
  }
  return n;
}

function setGoal() {
  try {
    let goal = readGoal(document.getElementById("goal").value);
    document.getElementById("msg").textContent = "Goal: " + goal + " glasses";
  } catch (error) {
    document.getElementById("msg").textContent = error.message;
  }
}
</script>

داده‌ای که ذخیره کرده‌ای هم ممکن است عجیب باشد، مثلاً از نسخه‌ی قدیمی اپ. قبل از استفاده بررسی کن: Array.isArray(words) می‌گوید واقعاً یک آرایه است یا نه. اگر نبود، از یک آرایه‌ی خالی شروع کن تا اپ نشکند: if (!Array.isArray(words)) { words = []; }.

همین در پایتون: آنجا try: و except ValueError: می‌نویسی، مثلاً try: n = int(text) و except ValueError: print("Please type a number."). throw جاوااسکریپت همان raise پایتون است.

مثال‌های این جلسه

چالش‌ها

  1. The App's Name (آسان)
  2. The App's Colour (آسان)
  3. Try to Read (آسان)
  4. Throw a Kind Message (متوسط)
  5. Make a Backup (متوسط)
  6. Restore a Backup (متوسط)
  7. Portable Water Counter (سخت)
  8. Import Words Safely (سخت)

بیشتر بخوان

← جلسه‌ی 16: پروژه: آزمون‌ساز جلسه‌ی 18: اپ من ۱ →