Project 3 Instruction HookAndAPI

Hook and API Call

Update 1/4/2025

3.1 React Hook with useState and useEffect

React Hook หรือ React Functional Component เป็นอีกหนึ่งวิธีการเขียน React นอกจาก Class Component คือการมองมันเป็นฟังก์ชัน และมี Return ออกมาเป็น HTML หรือ JSX Component

1. ลองศึกษาการทำ React Hook ในด้านการใช้ useStage กับ useEffect โดยสามารถหาแหล่งเรียนรู้ได้ทั่วไป
2. ในโปรเจกต์ที่ทำอยู่ลองสร้างเป็นฟอร์มเล็กๆ ที่มีการเปลี่ยนค่าสเตจ ลองสร้างฟอร์มสำหรับการเก็บ searchTerm หรือ ข้อความเอาไว้ Search อะไรบางอย่าง โดยอาจจะเป็นการใช้ html form หรือ เอามาจาก component library ก็ได้

import React, {useState} from "react";
import { Card, CardContent, TextField } from "@mui/material";

function App() {
  const [searchTerm, setSearchTerm] = useState("");
  return (
    <div>
      <Card>
        <CardContent>
          <div>Search Box</div>
          <TextField
            placeholder='Input Some Search Word'
            onChange={(e) => setSearchTerm(e.target.value)}
          />
          <div>
            You Search <span className='text-blue-500'>{searchTerm}</span>
          </div>
        </CardContent>
      </Card>
    </div>
  );
}
}

ตัวอย่าง

3. ลองทดลองการใช้งาน useEffect เช่นการสั่งให้ทุกครั้งที่ตัวเลขเปลี่ยน มีการ Alert ขึ้นมาที่หน้าจอ โดยที่ไม่เขียนไว้ตอนที่ Set Data แต่ใช้หลักของ useEffect ตรวจจับเวลาตัวเลขเกิดการเปลี่ยนแปลง

import React, { useState, useEffect } from "react";

useEffect(() => {
  alert(`You Search ${searchTerm}`);

  return () => {};
}, [searchTerm]);

ตัวอย่าง

4. เอาการ Alert ออกเพื่อเตรียมทำส่วนต่อไป

Information

• Introducing to Hook Official Doc
• React Hooks คืออะไร มาลองหัดใช้กันดีกว่า / Devahoy
• useState และ useEffect ใน React / NeeMeOn Medium

3.2 Call APIs

React เป็น JavaScript ในแบบ Client-Side Rendering ปกติตัวของ React ดีไซด์มาเพื่อเขียนเป็น User Interface หรือ Frontend อย่างเดียว แต่อย่างไรก็ดี ก็มีการพัฒนาเป็น Framework สำหรับทำให้ React เป็น Full Stack ได้ เช่น Next.js หรืออื่น ๆ แต่ในส่วนนี้ เราจะทำ Application ที่จะให้ React เป็นแค่ Frontnend เพื่อ Performance ที่ดีกว่า แล้วเราให้มันคุยกับ Backend โดยใช้ API

โดยปกติ React หรือ JavaScript บน node.js จะสามารถเรียก API ได้โดยใช้คำสั่ง fetch โดยไม่ต้องลง library ใดๆ เพิ่ม แต่ว่าด้วยความที่ fetch เป็นเหมือนตัว based แบบพื้นฐานการ config หลายอย่างเพิ่มเติมแบบไม่ง่ายเท่าไหร่ จึงมี library ที่ทำเป็น out-of-box มาให้ที่นิยมใช้คือ axios

5. ลองตรวจเช็คความเข้าใจว่ารู้จักการใช้ npm หรือ node package manager ซึ่งเป็น Package Manager หลักๆ ของ Node.js แล้วยัง ลองลง package ที่ชื่อ axios ซึ่งเป็น HTTP Client สำหรับการยิง Request ต่างๆ (ลงด้วย npm install axios --save)

6. ลองใช้ axios ในการเรียก API จาก Public API อย่าง RestCountries แล้วเก็บมาไว้ใน State โดยการเรียกต้องเรียกผ่าน useEffect เพื่อไม่ให้มันทำหลายครั้ง โดยใน axios ถ้าลองเปรียบเทียบจากใน doc Response ที่ได้จาก api จะอยู่ใน field ของ data ดังนั้นเมื่อเราได้ response ออกมา เราจะต้้องมา .data อีกครั้ง

ในตัวอย่างจะลองยิงไปที่ api people ใน RestCountries API

const [asiaCountries, setAsiaCountries] = useState([]);

useEffect(() => {
  axios
    .get("https://restcountries.com/v3.1/region/asia")
    .then((res) => {
      setAsiaCountries(res.data);
      console.log("Country ", res.data);
    })
    .catch((error) => {
      console.error("Error", error?.message);
    });

  return () => {};
}, []);

การดำเนินการกับข้อมูลที่มีการดึงมาจาก I/O เช่นพวก API นี้มีหลายวิธี วิธีที่เราใช้ข้างบนเป็นวิธีแบบ Promise คือ เราจะมองว่าเราจะได้ Object ทีั่ไม่สมบูรณ์มามี Type เป็น Promise คือสัญญาว่าจะมี แต่ยังไม่มี เมื่อข้อมูลมาครบ มันจะเรียกไปที่ then(()=>{}) ถ้า error จะไปที่ .catch(error=>{}) และท้ายที่สุดจะไปที่ .finally(()=>{}) ซึ่งเราอาจจะละไว้ก็ได้

7. เพื่อความปลอดภัย กรณีที่ข้อมูลมันไม่ได้มาตามเงื่อนไขนี้ มันอาจจะ Error ได้ เช่น ถ้ามันไม่มี res.data การเอามา .result ต่อ มันจะทำให้เกิด .result of undefine ซึ่งจะทำให้ Error เราจะทำ Optional Chaining หรือใส่ ? ไว้ หลังแต่ละตัวแปรก่อนการจุด เพื่อบอกมันว่า ถ้ามันมีค่ามันถึงจะหาต่อ ถ้าไม่มีก็ไม่ต้องทำการ dot ต่อแล้ว res.data จะเปลี่ยนเป็น res?.data

8. ลองทำ Error Handling ในการเรียก Asynchronous Function แบบ try catch กับ async await ซึ่งถ้าถูกต้องมันจะให้ผลออกมาเหมือนกัน

useEffect(() => {
  const getData = async () => {
    try {
      const response = await axios.get(
        "https://restcountries.com/v3.1/region/asia"
      );
      setData(res?.data);
    } catch (err) {
      console.error(err.message);
    }
  };
}, []);

10. ลองทำการ Map ข้อมูลที่อยู้ใน State ออกมาแสดงใน UI ให้กับผู้ใช้ โดยใช้ .map ซึ่งเป็นหนึ่งในฟังก์ชันพื้นฐานของ JavaScript

<div className="mx-4">
  {asiaCountries?.map((eachContry, index) => (
    <Card key={index} className="my-2">
      <CardContent>
        <div className="flex">
          <div className="w-1/3">
            <img src={eachCountry?.flags?.png}>
          </div>
          <div className="w-2/3">
            <li>Name: {eachContry?.name?.common}</li>
            <li>Official Name: {eachContry?.name?.oifficial}</li>
            <li>Code: {eachContry?.cca2}</li>
          </div>
        </div>
      </CardContent>
    </Card>
  ))}
</div>

ตัวอย่าง

11. ลองหา Library ต่างๆ ที่ช่วยให้การทำงานสะดวกขึ้น เช่น lodash หรืออื่นๆ ตามความต้องการใน npm

ตัวอย่างการใช้ lodash ในการ map

import _ from 'lodash';

function App(){
...
return (<div>
...
 {_.map(starWarPeople, (eachPeople, index) => (
       <Card key={index} className='my-2'>
         <CardContent>
        <div className="flex">
          <div className="w-1/3">
            <img src={eachCountry?.flags?.png}>
          </div>
          <div className="w-2/3">
            <li>Name: {eachContry?.name?.common}</li>
            <li>Official Name: {eachContry?.name?.oifficial}</li>
            <li>Code: {eachContry?.cca2}</li>
          </div>
        </div>
      </CardContent>
       </Card>
          ))}
</div>)
}

12. ลอง แยกโค้ดสำหรับการ GET API ออกมาเป็นฟังก์ชัน และนอกจากให้มัน Run ตอนโหลดหน้านี้แล้ว ให้มีการ Search ได้ โดย Starwar API มีการอนุญาติให้ Search อยู่แล้ว เช่น https://restcountries.com/v3.1/region/ใส่ชื่อทวีปภาษาอังกฤษ ลองสร้างปุ่มสำหรับ Search และลองประยุกตใช้การ Search กับ TextBox ที่เราตั้งไว้ และปึ่ม Search ให้ทุกๆ ครั้งที่เรากดปุ่ม Search ระบบจะเอาข้อมูลจากใน Search Term ไปเป็น Query สำหรับการ Call API ด้วย

Information

• Axios
• Node Package Manager / NPM
• RestCountries