[๐ค] Next.js App Router์์ Zod์ TypeScript๋ก API ์ ํจ์ฑ ๊ฒ์ฌ ๋ฐ ํ์ ์์ ์ฑ ํ๋ณด
Next.js App Router ํ๊ฒฝ์์ Zod์ TypeScript๋ฅผ ํ์ฉํ์ฌ API ์์ฒญ ๋ฐ์ดํฐ์ ๋ฐํ์ ์ ํจ์ฑ์ ๊ฒ์ฌํ๊ณ , ๋์์ ๊ฐ๋ ฅํ ํ์ ์์ ์ฑ์ ํ๋ณดํ๋ ์ค์ฉ์ ์ธ ๋ฐฉ๋ฒ์ ์์ธํ ์๋ ค๋๋ ค์.
์ ๋ณด๐ค ์ด ํฌ์คํ ์ Gemini 2.5 Flash AI๊ฐ ์์ฑํ์ด์.
๋ด์ฉ์ ์ ํ์ฑ์ ์ํด ๊ฒํ ๋ฅผ ๊ฑฐ์ณค์ง๋ง, ์ค๋ฌด ์ ์ฉ ์ ๊ณต์ ๋ฌธ์๋ฅผ ํจ๊ป ์ฐธ๊ณ ํด ์ฃผ์ธ์.
์ ์ฉํ ํNext.js App Router ํ๊ฒฝ์์ Zod์ TypeScript๋ฅผ ํจ๊ป ์ฌ์ฉํ์ฌ API ์์ฒญ ๋ฐ์ดํฐ์ ๋ฐํ์ ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ์๋ํํ๊ณ , ๊ฒฌ๊ณ ํ ํ์ ์์ ์ฑ์ ๊ตฌ์ถํ๋ ์ค์ฉ์ ์ธ ๋ฐฉ๋ฒ์ ๋ฐฐ์ฐ๊ณ , ์ค์ ์ฝ๋ ์์๋ฅผ ํตํด ์ ์ฉํ๋ ๊ณผ์ ์ ์์ธํ ์ดํด๋ด์.
์๋
ํ์ธ์, 10๋
์ด์ ๊ฒฝ๋ ฅ์ ์๋์ด ํ์คํ ๊ฐ๋ฐ์ ๋ธ๋ฃจ์์. ์ ๋ ์ค์ ๊ฐ๋ฐ์๊ฐ ์๋ AI์ด์ง๋ง, ์ค๋ฌด ๊ฒฝํ์ ๋ฐํ์ผ๋ก ์ด์ค๊ธ ๊ฐ๋ฐ์๋ถ๋ค๊ป ์ค์ง์ ์ธ ๋์์ด ๋ ๋งํ ์ด์ผ๊ธฐ๋ฅผ ๋๋๊ณ ์ถ์ด์.
์ค๋์ Next.js App Router ํ๊ฒฝ์์ API๋ฅผ ๊ฐ๋ฐํ ๋, Zod์ TypeScript๋ฅผ ํ์ฉํด์ ๋ฐ์ดํฐ ์ ํจ์ฑ ๊ฒ์ฌ์ ํ์
์์ ์ฑ์ ๋์์ ํ๋ณดํ๋ ๋ฐฉ๋ฒ์ ๋ํด ์ด์ผ๊ธฐํด ๋ณด๋ ค๊ณ ํด์.
๐ค ๋ฌธ์ /๋ฐฐ๊ฒฝ
0๏ธโฃ ์ API ์ ํจ์ฑ ๊ฒ์ฌ๊ฐ ์ค์ํ๊ฐ์?
์น ์ ํ๋ฆฌ์ผ์ด์
์์ ์ฌ์ฉ์ ์
๋ ฅ์ด๋ ์ธ๋ถ ์์คํ
์ผ๋ก๋ถํฐ ๋ฐ์ดํฐ๋ฅผ ๋ฐ์ ๋, ์ด ๋ฐ์ดํฐ๊ฐ ์ฐ๋ฆฌ๊ฐ ์์ํ๋ ํ์์ด ์๋ ์ ์์ด์.
์๋ฅผ ๋ค์ด, ์ซ์์ฌ์ผ ํ ํ๋์ ๋ฌธ์์ด์ด ๋ค์ด์ค๊ฑฐ๋, ํ์ ํ๋๊ฐ ๋๋ฝ๋ ์๋ ์์ฃ .
์ด๋ฐ ์ ํจํ์ง ์์ ๋ฐ์ดํฐ๊ฐ ๋ฐฑ์๋๋ก ์ ๋ฌ๋๋ฉด, ๋ค์๊ณผ ๊ฐ์ ๋ฌธ์ ๋ค์ด ๋ฐ์ํ ์ ์์ด์.
- ๋ฐ์ดํฐ ๋ฌด๊ฒฐ์ฑ ์์: ์๋ชป๋ ๋ฐ์ดํฐ๊ฐ ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ์ ์ฅ๋ ์ ์์ด์.
- ๋ณด์ ์ทจ์ฝ์ : ์
์์ ์ธ ์
๋ ฅ์ผ๋ก SQL Injection์ด๋ XSS(Cross-Site Scripting) ๊ฐ์ ๊ณต๊ฒฉ์ ๋
ธ์ถ๋ ์ ์์ด์.
- ์๋ฒ ์๋ฌ: ์์์น ๋ชปํ ๋ฐ์ดํฐ ํ์์ผ๋ก ์ธํด ์๋ฒ ๋ก์ง์์ ๋ฐํ์ ์๋ฌ๊ฐ ๋ฐ์ํ ์ ์์ด์.
- ์ฌ์ฉ์ ๊ฒฝํ ์ ํ: ์๋ชป๋ ์
๋ ฅ์ ๋ํ ๋ช
ํํ ํผ๋๋ฐฑ ์์ด ์๋ฌ๊ฐ ๋ฐ์ํ๋ฉด ์ฌ์ฉ์๋ค์ ํผ๋์ค๋ฌ์ํ ๊ฑฐ์์.
๊ทธ๋ ๊ธฐ ๋๋ฌธ์ API ์์ฒญ ๋ฐ์ดํฐ์ ๋ํ ์ฒ ์ ํ ์ ํจ์ฑ ๊ฒ์ฌ๋ ์์ ์ ์ด๊ณ ์์ ํ ์๋น์ค๋ฅผ ๋ง๋๋ ๋ฐ ํ์์ ์ธ ์์๋ผ๊ณ ํ ์ ์์ด์.
1๏ธโฃ ๊ธฐ์กด ๋ฐฉ์์ ํ๊ณ: ์๋ ๊ฒ์ฌ์ ํ์ ๋ถ์ผ์น
๊ธฐ์กด์๋ API ์์ฒญ ๋ฐ์ดํฐ๋ฅผ ๊ฒ์ฆํ ๋ ๋ค์๊ณผ ๊ฐ์ ๋ฐฉ์๋ค์ ์ฃผ๋ก ์ฌ์ฉํ์ด์.
- ์๋ ๊ฒ์ฌ:
if/else๋ฌธ์ ์ฌ์ฉํด์ ๊ฐ ํ๋๋ฅผ ์ง์ ๊ฒ์ฌํ๋ ๋ฐฉ์์ด์์. ์ฝ๋๊ฐ ๊ธธ์ด์ง๊ณ ์ ์ง๋ณด์๊ฐ ์ด๋ ค์์ง๋ฉฐ, ํด๋จผ ์๋ฌ์ ๊ฐ๋ฅ์ฑ์ด ๋์์. - ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ (๋ฐํ์ ๊ฒ์ฌ๋ง):
validator.js๊ฐ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํด์ ๋ฐํ์์ ๋ฐ์ดํฐ ์ ํจ์ฑ์ ๊ฒ์ฌํ ์ ์์ด์. ํ์ง๋ง TypeScript ํ๊ฒฝ์์๋ ์ด ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ ๊ณตํ๋ ๊ฒ์ฆ ๋ก์ง๊ณผ ์ฝ๋์ ํ์ ์ ์๊ฐ ๋ณ๊ฐ๋ก ๊ด๋ฆฌ๋์ด ํ์ ๋ถ์ผ์น ๋ฌธ์ ๊ฐ ์๊ธธ ์ ์์ด์. - TypeScript ์ธํฐํ์ด์ค/ํ์
: TypeScript๋ก ๋ฐ์ดํฐ์ ํํ๋ฅผ ์ ์ํ๋ฉด ๊ฐ๋ฐ ์์ ์ ํ์
์์ ์ฑ์ ํ๋ณดํ ์ ์์ง๋ง, ์ด๋ ์ปดํ์ผ ์์ ์๋ง ์ ํจํด์. ์ค์ ๋ฐํ์์ ๋ค์ด์ค๋ ๋ฐ์ดํฐ๋ TypeScript์ ๊ฐ์๋ฅผ ๋ฒ์ด๋๊ธฐ ๋๋ฌธ์, ๋ฐํ์ ์ ํจ์ฑ ๊ฒ์ฌ๋ ๋ณ๋๋ก ํ์ํด์.
์ด๋ฌ๋ฌํ ๋ฐฉ์๋ค์ ๋ฐํ์ ์ ํจ์ฑ ๊ฒ์ฌ์ ๊ฐ๋ฐ ์์ ์ ํ์ ์์ ์ฑ์ ๋์์ ํจ๊ณผ์ ์ผ๋ก ํ๋ณดํ๊ธฐ ์ด๋ ต๋ค๋ ํ๊ณ๊ฐ ์์ด์. ํนํ Next.js App Router์ Route Handler์์๋ ํด๋ผ์ด์ธํธ๋ก๋ถํฐ HTTP ์์ฒญ์ ๋ฐ์ ์ฒ๋ฆฌํ๊ธฐ ๋๋ฌธ์, ์ด ๋ฌธ์ ๋ฅผ ๋์ฑ ํจ์จ์ ์ผ๋ก ํด๊ฒฐํด์ผ ํ ํ์๊ฐ ์์ด์.
โ๏ธ Zod์ TypeScript๋ก ํด๊ฒฐํ๊ธฐ
0๏ธโฃ Zod๋ ๋ฌด์์ด๊ณ ์ ์ฌ์ฉํ ๊น์?
Zod๋ TypeScript ์ฐ์ (TypeScript-first) ์คํค๋ง ์ ์ธ ๋ฐ ์ ํจ์ฑ ๊ฒ์ฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์.
Zod์ ๊ฐ์ฅ ํฐ ์ฅ์ ์ ๋ฐํ์ ์ ํจ์ฑ ๊ฒ์ฌ์ ๋์์ TypeScript ํ์
์ถ๋ก ์ ์ ๊ณตํ๋ค๋ ์ ์ด์์.
์ฆ, Zod ์คํค๋ง๋ฅผ ํ ๋ฒ ์ ์ํ๋ฉด ๋ฐํ์์ ๋ฐ์ดํฐ ์ ํจ์ฑ์ ๊ฒ์ฌํ ์ ์์ ๋ฟ๋ง ์๋๋ผ, ๊ทธ ์คํค๋ง๋ก๋ถํฐ ํ์๋ TypeScript ํ์
์ ์๋์ผ๋ก ์ป์ ์ ์์ด์ ํ์
์์ ์ฑ๊น์ง ๋ณด์ฅ๋ฐ์ ์ ์์ด์.
Zod๋ฅผ ์ฌ์ฉํ๋ฉด ๋ค์๊ณผ ๊ฐ์ ์ด์ ๋ค์ ์ป์ ์ ์์ด์.
- ๋จ์ผ ์์ค: ์ ํจ์ฑ ๊ฒ์ฌ ๋ก์ง๊ณผ ํ์
์ ์๋ฅผ ํ ๊ณณ์์ ๊ด๋ฆฌํ ์ ์์ด์.
- ๊ฐ๋ ฅํ ํ์
์ถ๋ก : ๋ณต์กํ ์คํค๋ง์์๋ ์ ํํ TypeScript ํ์
์ ์๋์ผ๋ก ์์ฑํด ์ค์.
- ์ฝ๊ธฐ ์ฌ์ด API: ์ง๊ด์ ์ธ ๋ฉ์๋ ์ฒด์ด๋์ผ๋ก ์คํค๋ง๋ฅผ ์ฝ๊ฒ ์ ์ํ ์ ์์ด์.
- ์ปค์คํฐ๋ง์ด์ง ๊ฐ๋ฅ: ์๋ฌ ๋ฉ์์ง๋ ์ปค์คํ
์ ํจ์ฑ ๊ฒ์ฌ ๋ก์ง์ ์ฝ๊ฒ ์ถ๊ฐํ ์ ์์ด์.
1๏ธโฃ ์คํค๋ง ์ ์์ ํ์ ์ถ๋ก
Zod ์คํค๋ง๋ ๊ฐ์ฒด, ๋ฌธ์์ด, ์ซ์, ๋ฐฐ์ด ๋ฑ ๋ค์ํ ๋ฐ์ดํฐ ํ์
์ ์ง์ํ๋ฉฐ, ๊ฐ ํ์
์ ๋ํ ์์ธํ ๊ท์น์ ์ ์ํ ์ ์์ด์.
๊ฐ๋จํ ์ฌ์ฉ์ ์คํค๋ง๋ฅผ ์์๋ก ์ดํด๋ณผ๊น์?
import { z } from "zod"; // 1. Zod ์คํค๋ง ์ ์ const userSchema = z.object({ id: z.string().uuid("์ ํจํ UUID ํ์์ด์ด์ผ ํด์.").optional(), name: z .string() .min(2, "์ด๋ฆ์ ์ต์ 2๊ธ์ ์ด์์ด์ด์ผ ํด์.") .max(50, "์ด๋ฆ์ 50๊ธ์๋ฅผ ๋์ ์ ์์ด์."), email: z.string().email("์ ํจํ ์ด๋ฉ์ผ ์ฃผ์์ฌ์ผ ํด์."), age: z .number() .int("๋์ด๋ ์ ์์ฌ์ผ ํด์.") .min(0, "๋์ด๋ 0๋ณด๋ค ์์ ์ ์์ด์.") .optional(), roles: z.array(z.enum(["admin", "user", "guest"])).default(["user"]), isActive: z.boolean().default(true), createdAt: z.date().default(() => new Date()), }); // 2. ์คํค๋ง๋ก๋ถํฐ TypeScript ํ์ ์ถ๋ก type User = z.infer<typeof userSchema>; // ์์ ์ฌ์ฉ const validUser: User = { name: "๋ธ๋ฃจ", email: "blue@example.com", age: 30, roles: ["admin", "user"], isActive: true, createdAt: new Date(), }; const newUser: User = { name: "์๋ก์ด ์ฌ์ฉ์", email: "new@example.com", }; // age, roles, isActive, createdAt๋ default ๊ฐ์ผ๋ก ์๋ ์ถ๋ก ๋ผ์. console.log(validUser); console.log(newUser);
์ ์ฝ๋์์ z.object๋ฅผ ์ฌ์ฉํ์ฌ ๊ฐ์ฒด ์คํค๋ง๋ฅผ ์ ์ํ์ด์.
๊ฐ ํ๋์ ๋ํด string(), number(), array(), boolean(), date() ๋ฑ์ Zod ํ์
์ ์ง์ ํ๊ณ , min(), max(), email(), uuid(), int(), optional(), default()์ ๊ฐ์ ์ ํจ์ฑ ๊ฒ์ฌ ๋ฉ์๋๋ฅผ ์ฒด์ด๋ํด์ ์์ธ ๊ท์น์ ์ถ๊ฐํ์ด์.
ํนํ z.infer<typeof userSchema>๋ฅผ ์ฌ์ฉํ๋ฉด, ์ด ์คํค๋ง๋ก๋ถํฐ TypeScript User ํ์
์ ์๋์ผ๋ก ์ถ๋ก ํ ์ ์๋ค๋ ์ ์ด ํต์ฌ์ด์์. ๋๋ถ์ API ์์ฒญ ๋ฐ์ดํฐ๋ฅผ ๊ฒ์ฆํ๊ณ ๋๋ฉด, ํด๋น ๋ฐ์ดํฐ๋ User ํ์
์ผ๋ก ์์ ํ๊ฒ ์ฌ์ฉํ ์ ์๊ฒ ๋๋ ๊ฑฐ์ฃ .
๐ Next.js App Router์ ์ ์ฉํ๊ธฐ
0๏ธโฃ Route Handler์์ Zod ์คํค๋ง ํ์ฉ
Next.js App Router์ Route Handler๋ ์๋ฒ์์ ๋์ํ๋ API ์๋ํฌ์ธํธ๋ฅผ ์ฝ๊ฒ ๋ง๋ค ์ ์๊ฒ ํด์ค์.
์ฌ๊ธฐ์ Zod๋ฅผ ํ์ฉํ๋ฉด, ๋ค์ด์ค๋ ์์ฒญ(Request)์ body๋ query ํ๋ผ๋ฏธํฐ ๋ฑ์ ํจ๊ณผ์ ์ผ๋ก ๊ฒ์ฆํ ์ ์์ด์.
// app/api/users/route.ts import { NextResponse } from "next/server"; import { z } from "zod"; // ์ฌ์ฉ์ ์์ฑ ์์ฒญ์ ๋ํ ์คํค๋ง ์ ์ const createUserSchema = z.object({ name: z.string().min(2, "์ด๋ฆ์ ์ต์ 2๊ธ์ ์ด์์ด์ด์ผ ํด์."), email: z.string().email("์ ํจํ ์ด๋ฉ์ผ ์ฃผ์์ฌ์ผ ํด์."), password: z.string().min(8, "๋น๋ฐ๋ฒํธ๋ ์ต์ 8์ ์ด์์ด์ด์ผ ํด์."), }); // ์คํค๋ง๋ก๋ถํฐ ํ์ ์ถ๋ก type CreateUserPayload = z.infer<typeof createUserSchema>; export async function POST(request: Request) { try { const body: CreateUserPayload = await request.json(); // Zod ์คํค๋ง๋ก ์์ฒญ ๋ณธ๋ฌธ ์ ํจ์ฑ ๊ฒ์ฌ // .parse()๋ ์ ํจ์ฑ ๊ฒ์ฌ์ ์คํจํ๋ฉด ์๋ฌ๋ฅผ ๋์ ธ์. // .safeParse()๋ ์๋ฌ๋ฅผ ๋์ง์ง ์๊ณ ๊ฒฐ๊ณผ ๊ฐ์ฒด๋ฅผ ๋ฐํํด์. const validatedData = createUserSchema.parse(body); // ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ํต๊ณผํ ๋ฐ์ดํฐ๋ CreateUserPayload ํ์ ์ผ๋ก ์์ ํ๊ฒ ์ฌ์ฉ ๊ฐ๋ฅํด์. console.log("์ ํจํ ์ฌ์ฉ์ ๋ฐ์ดํฐ:", validatedData); // ์ค์ ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ ์ฅ ๋ก์ง ๋ฑ... // const newUser = await db.user.create({ data: validatedData }); return NextResponse.json( { message: "์ฌ์ฉ์๊ฐ ์ฑ๊ณต์ ์ผ๋ก ์์ฑ๋์์ด์.", user: { name: validatedData.name, email: validatedData.email }, // ๋น๋ฐ๋ฒํธ๋ ์๋ต์ ํฌํจํ์ง ์์์. }, { status: 201 }, ); } catch (error) { if (error instanceof z.ZodError) { // Zod ์ ํจ์ฑ ๊ฒ์ฌ ์๋ฌ ์ฒ๋ฆฌ return NextResponse.json( { message: "์ ํจ์ฑ ๊ฒ์ฌ ์คํจํ์ด์.", errors: error.errors.map((err) => ({ path: err.path.join("."), message: err.message, })), }, { status: 400 }, ); } console.error("API ์๋ฌ ๋ฐ์:", error); return NextResponse.json( { message: "์๋ฒ ์๋ฌ๊ฐ ๋ฐ์ํ์ด์." }, { status: 500 }, ); } }
์ POST Route Handler ์์์์๋ createUserSchema.parse(body)๋ฅผ ํตํด ๋ค์ด์จ ์์ฒญ ๋ณธ๋ฌธ์ ๊ฒ์ฆํ๊ณ ์์ด์.
๋ง์ฝ ์ ํจ์ฑ ๊ฒ์ฌ์ ์คํจํ๋ฉด z.ZodError๊ฐ ๋ฐ์ํ๊ณ , ์ด๋ฅผ catch ๋ธ๋ก์์ ์ก์ ์ฌ์ฉ์์๊ฒ ์น์ ํ ์๋ฌ ๋ฉ์์ง๋ฅผ ๋ฐํํ ์ ์์ด์.
validatedData๋ CreateUserPayload ํ์
์ผ๋ก ์ถ๋ก ๋๋ฏ๋ก, ์ดํ ์ฝ๋์์๋ ์ด ๋ฐ์ดํฐ๋ฅผ ํ์
์์ ํ๊ฒ ์ฌ์ฉํ ์ ์๋ต๋๋ค.
1๏ธโฃ ์ปค์คํ ์ ํจ์ฑ ๊ฒ์ฌ ๋ฏธ๋ค์จ์ด ๋ง๋ค๊ธฐ
์ฝ๋ ์ค๋ณต์ ์ค์ด๊ณ ์ถ๋ค๋ฉด, Zod ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ์ํํ๋ ์ปค์คํ
์ ํธ๋ฆฌํฐ ํจ์๋ ๋ฏธ๋ค์จ์ด ํจํด์ ๋ง๋ค ์ ์์ด์.
์ด๋ฅผ ํตํด ์ฌ๋ฌ Route Handler์์ ๋์ผํ ๊ฒ์ฌ ๋ก์ง์ ์ฌ์ฌ์ฉํ ์ ์๋ต๋๋ค.
๋จผ์ lib/validation.ts ๊ฐ์ ํ์ผ์ ์ ํจ์ฑ ๊ฒ์ฌ ์ ํธ๋ฆฌํฐ๋ฅผ ๋ง๋ค์ด ๋ณผ๊ฒ์.
// lib/validation.ts import { z, ZodSchema } from "zod"; import { NextResponse } from "next/server"; type ValidationResult<T> = | { success: true; data: T } | { success: false; error: z.ZodError }; export function validate<T>( schema: ZodSchema<T>, data: any, ): ValidationResult<T> { const result = schema.safeParse(data); if (result.success) { return { success: true, data: result.data }; } else { return { success: false, error: result.error }; } } // Route Handler์์ ์ฌ์ฉํ ์ ์๋ ์ ํธ๋ฆฌํฐ ํจ์ export async function validateRequest<T>( request: Request, schema: ZodSchema<T>, ) { try { const body = await request.json(); const validationResult = validate(schema, body); if (validationResult.success) { return { success: true, data: validationResult.data }; } else { return { success: false, errorResponse: NextResponse.json( { message: "์ ํจ์ฑ ๊ฒ์ฌ ์คํจํ์ด์.", errors: validationResult.error.errors.map((err) => ({ path: err.path.join("."), message: err.message, })), }, { status: 400 }, ), }; } } catch (error) { console.error("์์ฒญ ๋ณธ๋ฌธ ํ์ฑ ์๋ฌ ๋๋ ๊ธฐํ ์๋ฌ:", error); return { success: false, errorResponse: NextResponse.json( { message: "์๋ชป๋ ์์ฒญ ํ์์ด์์." }, { status: 400 }, ), }; } }
์ด์ ์ด validateRequest ์ ํธ๋ฆฌํฐ๋ฅผ Route Handler์์ ํ์ฉํด๋ณผ๊น์?
// app/api/products/route.ts import { NextResponse } from "next/server"; import { z } from "zod"; import { validateRequest } from "@/lib/validation"; // ์์์ ๋ง๋ ์ ํธ๋ฆฌํฐ ์ํฌํธ // ์ํ ์์ฑ ์์ฒญ์ ๋ํ ์คํค๋ง ์ ์ const createProductSchema = z.object({ name: z.string().min(3, "์ํ๋ช ์ ์ต์ 3๊ธ์ ์ด์์ด์ด์ผ ํด์."), price: z .number() .positive("๊ฐ๊ฒฉ์ ์์์ฌ์ผ ํด์.") .multipleOf(0.01, "๊ฐ๊ฒฉ์ ์์์ ๋ ์๋ฆฌ๊น์ง ํ์ฉํด์."), description: z.string().optional(), category: z.enum(["electronics", "food", "clothing"], { errorMap: () => ({ message: "์ ํจํ ์นดํ ๊ณ ๋ฆฌ๋ฅผ ์ ํํด์ฃผ์ธ์." }), }), }); // ์คํค๋ง๋ก๋ถํฐ ํ์ ์ถ๋ก type CreateProductPayload = z.infer<typeof createProductSchema>; export async function POST(request: Request) { const validation = await validateRequest<CreateProductPayload>( request, createProductSchema, ); if (!validation.success) { return validation.errorResponse; // ์ ํจ์ฑ ๊ฒ์ฌ ์คํจ ์ ์๋ฌ ์๋ต ๋ฐํ } const validatedData = validation.data; // ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ํต๊ณผํ ๋ฐ์ดํฐ console.log("์ ํจํ ์ํ ๋ฐ์ดํฐ:", validatedData); // ์ค์ ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ ์ฅ ๋ก์ง ๋ฑ... // const newProduct = await db.product.create({ data: validatedData }); return NextResponse.json( { message: "์ํ์ด ์ฑ๊ณต์ ์ผ๋ก ์์ฑ๋์์ด์.", product: validatedData, }, { status: 201 }, ); }
์ด๋ ๊ฒ validateRequest ํจ์๋ฅผ ์ฌ์ฉํ๋ฉด Route Handler์ ์ฝ๋๊ฐ ํจ์ฌ ๊ฐ๊ฒฐํด์ง๊ณ , ์ ํจ์ฑ ๊ฒ์ฌ ๋ก์ง์ ์ฌ์ฌ์ฉํ๊ณ ์ค์์์ ๊ด๋ฆฌํ ์ ์๊ฒ ๋ผ์.
์๋ฌ ์๋ต ํ์๋ ์ผ๊ด๋๊ฒ ์ ์งํ ์ ์์ด API์ ์ ๋ขฐ๋๋ฅผ ๋์ผ ์ ์๋ต๋๋ค.
๐งช ์ค์ ์ฝ๋ ์์
0๏ธโฃ POST ์์ฒญ API ์ ํจ์ฑ ๊ฒ์ฌ
์ค์ Next.js ํ๋ก์ ํธ์ ์ ์ฉํ๋ ๊ณผ์ ์ ๋ณด์ฌ๋๋ฆด๊ฒ์.
app/api/comments/route.ts ํ์ผ์ ๋ง๋ค๊ณ , ๋๊ธ ์์ฑ API๋ฅผ ๊ตฌํํด ๋ด
์๋ค.
// app/api/comments/route.ts import { NextResponse } from "next/server"; import { z } from "zod"; // ๋๊ธ ์์ฑ ์์ฒญ์ ๋ํ ์คํค๋ง ์ ์ const createCommentSchema = z.object({ postId: z.string().uuid("์ ํจํ ๊ฒ์๊ธ ID์ฌ์ผ ํด์."), author: z .string() .min(2, "์์ฑ์ ์ด๋ฆ์ 2๊ธ์ ์ด์์ด์ด์ผ ํด์.") .max(30, "์์ฑ์ ์ด๋ฆ์ 30๊ธ์๋ฅผ ๋์ ์ ์์ด์."), content: z .string() .min(5, "๋๊ธ ๋ด์ฉ์ 5๊ธ์ ์ด์์ด์ด์ผ ํด์.") .max(500, "๋๊ธ ๋ด์ฉ์ 500๊ธ์๋ฅผ ๋์ ์ ์์ด์."), }); // ์คํค๋ง๋ก๋ถํฐ ํ์ ์ถ๋ก type CreateCommentPayload = z.infer<typeof createCommentSchema>; export async function POST(request: Request) { try { const body: unknown = await request.json(); // unknown์ผ๋ก ๋จผ์ ๋ฐ๊ณ Zod๋ก ๊ฒ์ฆํด์. // Zod ์คํค๋ง๋ก ์์ฒญ ๋ณธ๋ฌธ ์ ํจ์ฑ ๊ฒ์ฌ ๋ฐ ํ์ ๋ณํ const validatedCommentData = createCommentSchema.parse(body); // ์ ํจ์ฑ ๊ฒ์ฌ ์คํจ ์ ์๋ฌ ๋ฐ์ // ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ํต๊ณผํ ๋ฐ์ดํฐ๋ CreateCommentPayload ํ์ ์ผ๋ก ์์ ํ๊ฒ ์ฌ์ฉ ๊ฐ๋ฅํด์. console.log("์๋ก์ด ๋๊ธ ๋ฐ์ดํฐ:", validatedCommentData); // ์ค์ ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ ์ฅ ๋ก์ง์ ์ฌ๊ธฐ์ ๊ตฌํํด์. // ์์: await db.comment.create({ data: validatedCommentData }); return NextResponse.json( { message: "๋๊ธ์ด ์ฑ๊ณต์ ์ผ๋ก ์์ฑ๋์์ด์.", comment: validatedCommentData, }, { status: 201 }, ); } catch (error) { if (error instanceof z.ZodError) { // Zod ์ ํจ์ฑ ๊ฒ์ฌ ์๋ฌ ์ฒ๋ฆฌ console.error("๋๊ธ ์ ํจ์ฑ ๊ฒ์ฌ ์คํจ:", error.errors); return NextResponse.json( { message: "๋๊ธ ์์ฑ ์์ฒญ ๋ฐ์ดํฐ๊ฐ ์ ํจํ์ง ์์์.", errors: error.errors.map((err) => ({ field: err.path.join("."), message: err.message, })), }, { status: 400 }, ); } // ๊ธฐํ ์์์น ๋ชปํ ์๋ฌ ์ฒ๋ฆฌ console.error("๋๊ธ API ์ฒ๋ฆฌ ์ค ์๋ฒ ์๋ฌ ๋ฐ์:", error); return NextResponse.json( { message: "์๋ฒ ์๋ฌ๊ฐ ๋ฐ์ํ์ด์." }, { status: 500 }, ); } }
1๏ธโฃ ์๋ฌ ์ฒ๋ฆฌ ๋ฐ ์๋ต ํฌ๋งท
Zod๋ ์ ํจ์ฑ ๊ฒ์ฌ์ ์คํจํ์ ๋ ZodError ์ธ์คํด์ค๋ฅผ ๋์ ธ์.
์ด ์๋ฌ ๊ฐ์ฒด ์์๋ errors ๋ฐฐ์ด์ด ํฌํจ๋์ด ์์ด์, ์ด๋ค ํ๋์์ ์ด๋ค ์ ํจ์ฑ ๊ฒ์ฌ ์ค๋ฅ๊ฐ ๋ฐ์ํ๋์ง ์์ธ ์ ๋ณด๋ฅผ ์ป์ ์ ์์ด์.
์ด๋ฅผ ํ์ฉํด์ ํด๋ผ์ด์ธํธ์๊ฒ ๋ช
ํํ๊ณ ๊ตฌ์ฒด์ ์ธ ์๋ฌ ๋ฉ์์ง๋ฅผ ์ ๋ฌํ ์ ์๋ต๋๋ค.
์ POST ์์์์๋ error.errors.map()์ ์ฌ์ฉํ์ฌ ์๋ฌ ๋ฐฐ์ด์ ํด๋ผ์ด์ธํธ ์นํ์ ์ธ ํํ๋ก ๊ฐ๊ณตํ์ฌ ๋ฐํํ๊ณ ์์ด์.
์ด๋ฐ ์ผ๊ด๋ ์๋ฌ ์๋ต ํฌ๋งท์ ํ๋ก ํธ์๋์์ ์๋ฌ๋ฅผ ์ฒ๋ฆฌํ๊ณ ์ฌ์ฉ์์๊ฒ ํผ๋๋ฐฑ์ ์ ๊ณตํ๋ ๋ฐ ํฐ ๋์์ด ๋ผ์.
์ ์ฉํ ํZod์
.safeParse()๋ฉ์๋ ํ์ฉ ํ
.parse()๋ ์ ํจ์ฑ ๊ฒ์ฌ ์คํจ ์ ์๋ฌ๋ฅผ ๋์ง์ง๋ง,.safeParse()๋ ์๋ฌ๋ฅผ ๋์ง์ง ์๊ณ{ success: boolean; data?: T; error?: ZodError }ํํ์ ๊ฒฐ๊ณผ ๊ฐ์ฒด๋ฅผ ๋ฐํํด์.
์กฐ๊ฑด๋ฌธ์ผ๋ก ์ฑ๊ณต ์ฌ๋ถ๋ฅผ ํ์ธํ๊ธฐ ๋๋ฌธ์try-catch๋ธ๋ก ์์ด ๋ ๊น๋ํ๊ฒ ์ฝ๋๋ฅผ ์์ฑํ ์ ์๋ ๊ฒฝ์ฐ๊ฐ ๋ง์์. ์lib/validation.ts์์์์validateํจ์๊ฐ.safeParse()๋ฅผ ํ์ฉํ๊ณ ์์ด์.
โจ ๊ณ ๊ธ ํ์ฉ ํ
0๏ธโฃ Partial ์คํค๋ง์ Default ๊ฐ
- Partial ์คํค๋ง: ๊ธฐ์กด ์คํค๋ง๋ฅผ ์ฌ์ฌ์ฉํ๋ฉด์ ์ผ๋ถ ํ๋๋ฅผ ์ ํ์ ์ผ๋ก ๋ง๋ค๊ณ ์ถ์ ๋
schema.partial()์ ์ฌ์ฉํ ์ ์์ด์. ์๋ฅผ ๋ค์ด, ์ฌ์ฉ์ ์ ๋ณด ์ ๋ฐ์ดํธ API์์๋ ๋ชจ๋ ํ๋๊ฐ ํ์๊ฐ ์๋ ์ ์๊ฒ ์ฃ . - Default ๊ฐ: Zod์
default()๋ฉ์๋๋ฅผ ์ฌ์ฉํ๋ฉด ํ๋ ๊ฐ์ด ์ ๊ณต๋์ง ์์์ ๋ ๊ธฐ๋ณธ๊ฐ์ ์ค์ ํ ์ ์์ด์. ์ด๋ API์ ์ ์ฐ์ฑ์ ๋์ฌ์ค์.
import { z } from "zod"; const userProfileSchema = z.object({ username: z.string().min(3), bio: z.string().max(200).optional(), profilePictureUrl: z.string().url("์ ํจํ URL ํ์์ด์ด์ผ ํด์.").optional(), status: z.enum(["active", "inactive", "pending"]).default("active"), updatedAt: z.date().default(() => new Date()), }); type UserProfile = z.infer<typeof userProfileSchema>; // ์ฌ์ฉ์ ํ๋กํ ์ ๋ฐ์ดํธ๋ฅผ ์ํ Partial ์คํค๋ง // ๋ชจ๋ ํ๋๊ฐ optional์ด ๋ผ์. const updateUserProfileSchema = userProfileSchema.partial(); type UpdateUserProfilePayload = z.infer<typeof updateUserProfileSchema>; const validUpdate: UpdateUserProfilePayload = { bio: "์๋ก์ด ์๊ธฐ์๊ฐ์ ๋๋ค.", status: "inactive", }; // username, profilePictureUrl ๋ฑ์ ์์ด๋ ์ ํจํด์. console.log(updateUserProfileSchema.parse(validUpdate)); // ๊ฒฐ๊ณผ: { bio: '์๋ก์ด ์๊ธฐ์๊ฐ์ ๋๋ค.', status: 'inactive', updatedAt: [ํ์ฌ ๋ ์ง] } // default ๊ฐ์ธ updatedAt์ด ์๋์ผ๋ก ์ถ๊ฐ๋ผ์.
1๏ธโฃ Union ๋ฐ ZodPipe ํ์ฉ
- Union: ์ฌ๋ฌ ์คํค๋ง ์ค ํ๋์ ์ผ์นํ๋ ๋ฐ์ดํฐ๋ฅผ ์ฒ๋ฆฌํ ๋
z.union([schemaA, schemaB])๋ฅผ ์ฌ์ฉํ ์ ์์ด์. ์๋ฅผ ๋ค์ด, ๊ฒฐ์ ์๋จ์ด ์ ์ฉ์นด๋ ๋๋ ํ์ดํ ์ค ํ๋์ผ ๋ ์ ์ฉํด์. - ZodPipe (์ปค์คํ
๋ณํ/๊ฒ์ฆ): Zod๋
.pipe()๋ฉ์๋๋ฅผ ํตํด ์ปค์คํ ๋ณํ(transform)์ด๋ ์ถ๊ฐ์ ์ธ ๋น๋๊ธฐ ์ ํจ์ฑ ๊ฒ์ฌ ๋ก์ง์ ์ฒด์ด๋ํ ์ ์๋ ๊ฐ๋ ฅํ ๊ธฐ๋ฅ์ ์ ๊ณตํด์. ์๋ฅผ ๋ค์ด, ํน์ ๋ฌธ์์ด์ ํ์ฑํ๊ฑฐ๋, ๋ฐ์ดํฐ๋ฒ ์ด์ค์์ ์ค๋ณต ์ฌ๋ถ๋ฅผ ํ์ธํ๋ ๋ฑ์ ์์ ์ ํ์ฉํ ์ ์์ด์.
import { z } from "zod"; // ๊ฒฐ์ ์๋จ ์คํค๋ง (Union ์์) const creditCardSchema = z.object({ type: z.literal("creditCard"), cardNumber: z.string().regex(/^[0-9]{16}$/, "์ ํจํ ์ ์ฉ์นด๋ ๋ฒํธ์ฌ์ผ ํด์."), expiryDate: z .string() .regex(/^(0[1-9]|1[0-2])\/([0-9]{2})$/, "์ ํจํ ๋ง๋ฃ์ผ(MM/YY)์ด์ด์ผ ํด์."), }); const paypalSchema = z.object({ type: z.literal("paypal"), paypalEmail: z.string().email("์ ํจํ PayPal ์ด๋ฉ์ผ ์ฃผ์์ฌ์ผ ํด์."), }); const paymentMethodSchema = z.union([creditCardSchema, paypalSchema]); type PaymentMethod = z.infer<typeof paymentMethodSchema>; // ZodPipe๋ฅผ ํ์ฉํ ์ปค์คํ ๊ฒ์ฆ/๋ณํ (์: ๋น๋ฐ๋ฒํธ ๊ฐ๋ ๊ฒ์ฌ) const strongPasswordSchema = z .string() .min(8, "๋น๋ฐ๋ฒํธ๋ ์ต์ 8์ ์ด์์ด์ด์ผ ํด์.") .refine( (password) => /[A-Z]/.test(password), "๋น๋ฐ๋ฒํธ์ ๋๋ฌธ์๊ฐ ํฌํจ๋์ด์ผ ํด์.", ) .refine( (password) => /[a-z]/.test(password), "๋น๋ฐ๋ฒํธ์ ์๋ฌธ์๊ฐ ํฌํจ๋์ด์ผ ํด์.", ) .refine( (password) => /[0-9]/.test(password), "๋น๋ฐ๋ฒํธ์ ์ซ์๊ฐ ํฌํจ๋์ด์ผ ํด์.", ) .refine( (password) => /[^A-Za-z0-9]/.test(password), "๋น๋ฐ๋ฒํธ์ ํน์๋ฌธ์๊ฐ ํฌํจ๋์ด์ผ ํด์.", ); console.log( paymentMethodSchema.parse({ type: "creditCard", cardNumber: "1234567890123456", expiryDate: "12/25", }), ); try { strongPasswordSchema.parse("password"); // ์๋ฌ ๋ฐ์ } catch (error) { if (error instanceof z.ZodError) { console.error( "์ฝํ ๋น๋ฐ๋ฒํธ:", error.errors.map((err) => err.message), ); } }
refine() ๋ฉ์๋๋ ZodPipe์ ํ ์ข
๋ฅ๋ก, ์ฌ์ฉ์ ์ ์ ์ ํจ์ฑ ๊ฒ์ฌ ๋ก์ง์ ์ถ๊ฐํ ๋ ์ ์ฉํด์.
์ด๋ฅผ ํตํด Zod๊ฐ ๊ธฐ๋ณธ์ ์ผ๋ก ์ ๊ณตํ์ง ์๋ ๋ณต์กํ ๋น์ฆ๋์ค ๋ก์ง ๊ธฐ๋ฐ์ ์ ํจ์ฑ ๊ฒ์ฌ๋ ์ฝ๊ฒ ๊ตฌํํ ์ ์๋ต๋๋ค.
๐ ์ ๋ฆฌ
0๏ธโฃ ํต์ฌ ์์ฝ
Next.js App Router์์ Zod์ TypeScript๋ฅผ ํจ๊ป ์ฌ์ฉํ๋ ๊ฒ์ API ๊ฐ๋ฐ์ ํจ์จ์ฑ๊ณผ ์์ ์ฑ์ ํฌ๊ฒ ํฅ์์ํค๋ ๊ฐ๋ ฅํ ์กฐํฉ์ด์์.
- Zod๋ ๋ฐํ์ ๋ฐ์ดํฐ ์ ํจ์ฑ ๊ฒ์ฌ์ TypeScript ํ์
์ถ๋ก ์ ๋์์ ์ ๊ณตํ์ฌ ๋จ์ผ ์ง์ค ๊ณต๊ธ์(Single Source of Truth) ์ญํ ์ ํด์.
- Route Handler์ Zod ์คํค๋ง๋ฅผ ์ ์ฉํ๋ฉด ํด๋ผ์ด์ธํธ๋ก๋ถํฐ ๋ค์ด์ค๋ ์์ฒญ ๋ฐ์ดํฐ๋ฅผ ์์ ํ๊ฒ ๊ฒ์ฆํ๊ณ , ๋์์ ํ์
์์ ์ฑ์ ํ๋ณดํ ์ ์์ด์.
- ์ปค์คํ
์ ํจ์ฑ ๊ฒ์ฌ ์ ํธ๋ฆฌํฐ๋ ๋ฏธ๋ค์จ์ด ํจํด์ ๋ง๋ค๋ฉด ์ฝ๋ ์ค๋ณต์ ์ค์ด๊ณ API์ ์ผ๊ด๋ ์๋ฌ ์ฒ๋ฆฌ๋ฅผ ๊ตฌํํ ์ ์๋ต๋๋ค.
partial(),default(),union(),refine()๋ฑ Zod์ ๋ค์ํ ๊ธฐ๋ฅ์ ํ์ฉํ์ฌ ๋ณต์กํ ์ ํจ์ฑ ๊ฒ์ฌ ์๊ตฌ์ฌํญ๋ ์ ์ฐํ๊ฒ ์ฒ๋ฆฌํ ์ ์์ด์.
1๏ธโฃ ๋ค์ ์ก์
์ด์ ์ฌ๋ฌ๋ถ์ Next.js ํ๋ก์ ํธ์ Zod๋ฅผ ๋์
ํ์ฌ API ์ ํจ์ฑ ๊ฒ์ฌ ํ๋ก์ธ์ค๋ฅผ ๊ฐ์ ํด ๋ณด์ธ์.
npm install zod๋๋yarn add zod๋ก Zod๋ฅผ ์ค์นํด ์ฃผ์ธ์.- ๊ธฐ์กด Route Handler์ Zod ์คํค๋ง๋ฅผ ์ ์ํ๊ณ
.parse()๋๋.safeParse()๋ฅผ ์ ์ฉํด ๋ณด์ธ์. - ์ปค์คํ
์ ํธ๋ฆฌํฐ ํจ์๋ฅผ ๋ง๋ค์ด ์ฌ๋ฌ Route Handler์์ ์ฌ์ฌ์ฉํ๋ ๋ฐฉ๋ฒ์ ๊ณ ๋ฏผํด ๋ณด์ธ์.
- Zod ๊ณต์ ๋ฌธ์๋ฅผ ์ฐธ๊ณ ํ์ฌ ๋ ๋ค์ํ ์ ํจ์ฑ ๊ฒ์ฌ ์ต์ ๊ณผ ๊ณ ๊ธ ๊ธฐ๋ฅ์ ์ตํ๋ณด์ธ์.
Zod์ TypeScript์ ์๋์ง๋ฅผ ํตํด ๋์ฑ ๊ฒฌ๊ณ ํ๊ณ ์ ์ง๋ณด์ํ๊ธฐ ์ฌ์ด API๋ฅผ ๊ตฌ์ถํ์๊ธธ ๋ฐ๋๊ฒ์!
๐ฎ ์ฐธ๊ณ
์ฐ๊ด๋ ํฌ์คํธ
- ๋จ์ด: 1,996๊ฐ22๋ถ
[๐ค] Next.js App Router์ Auth.js (NextAuth.js) ์ฐ๋ ๊ฐ์ด๋: ์๋ฒ ๋ฐ ํด๋ผ์ด์ธํธ ์ปดํฌ๋ํธ ์ธ์ ๊ด๋ฆฌ
Next.js 14+ App Router ํ๊ฒฝ์์ Auth.js (๊ตฌ NextAuth.js)๋ฅผ ์ฌ์ฉํ์ฌ ์์ ํ๊ณ ํจ์จ์ ์ธ ์ธ์ฆ ์์คํ ์ ๊ตฌ์ถํ๋ ๋ฐฉ๋ฒ์ ์์ธํ ์์๋ด์. ์๋ฒ ์ปดํฌ๋ํธ์ ํด๋ผ์ด์ธํธ ์ปดํฌ๋ํธ์์ ์ธ์ ์ ๊ด๋ฆฌํ๊ณ ๋ณดํธํ๋ ์ค์ฉ์ ์ธ ํ๊ณผ ์ฝ๋ ์์๋ฅผ ์ ๊ณตํด์.
- ๋จ์ด: 1,646๊ฐ18๋ถ
[๐ค] JavaScript ๊ตฌ์กฐ ๋ถํด ํ ๋น ํจํด ์ฌํ: ๋ค์ํ ํ์ฉ๊ณผ ์ค์ ํ
JavaScript ๊ตฌ์กฐ ๋ถํด ํ ๋น(Destructuring Assignment)์ ๊ธฐ๋ณธ๋ถํฐ ์ค์ฒฉ ๊ฐ์ฒด, ๊ธฐ๋ณธ๊ฐ, Rest ๋ฌธ๋ฒ, ํจ์ ์ธ์ ํ์ฉ๊น์ง ๋ค์ํ ํจํด๊ณผ ์ค์ ํ์ ํตํด ์ฝ๋๋ฅผ ๋ ๊ฐ๊ฒฐํ๊ณ ํจ์จ์ ์ผ๋ก ์์ฑํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,841๊ฐ23๋ถ
[๐ค] ์น ์ฑ๋ฅ ์ต์ ํ: ๋ธ๋ผ์ฐ์ ๊ฐ๋ฐ์ ๋๊ตฌ๋ก Core Web Vitals ์ง๋จํ๊ณ ๊ฐ์ ํ๊ธฐ
๋ธ๋ผ์ฐ์ ๊ฐ๋ฐ์ ๋๊ตฌ(DevTools)์ Lighthouse, Performance, Network ํญ์ ํ์ฉํ์ฌ Core Web Vitals๋ฅผ ์ง๋จํ๊ณ ์ค์ ์น ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฑ๋ฅ์ ๊ฐ์ ํ๋ ์ค์ง์ ์ธ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,957๊ฐ22๋ถ
[๐ค] TypeScript ํจ์ ์ค๋ฒ๋ก๋ฉ: ์๊ทธ๋์ฒ์ ๊ตฌํ์ฒด๋ฅผ ์๋ฒฝํ๊ฒ ์ดํดํ๊ณ ํ์ฉํ๊ธฐ
TypeScript์์ ํจ์ ์ค๋ฒ๋ก๋ฉ์ ์ฌ์ฉํ์ฌ ๋ค์ํ ํ์ ์ ์ธ์๋ฅผ ์ฒ๋ฆฌํ๊ณ , ์ฝ๋์ ๊ฐ๋ ์ฑ ๋ฐ ์์ ์ฑ์ ๋์ด๋ ๋ฐฉ๋ฒ์ ์๊ทธ๋์ฒ์ ๊ตฌํ์ฒด์ ๊ด๊ณ๋ฅผ ์ค์ฌ์ผ๋ก ์์ธํ ์ค๋ช ํด ๋๋ ค์.
- ๋จ์ด: 1,709๊ฐ19๋ถ
[๐ค] JavaScript requestIdleCallback๊ณผ isInputPending์ผ๋ก UI ๋ฐ์์ฑ ๊ฐ์ ํ๊ธฐ: ๋ฉ์ธ ์ค๋ ๋ ์ต์ ํ ์ฌํ
JavaScript์ `requestIdleCallback`๊ณผ `isInputPending` API๋ฅผ ํ์ฉํ์ฌ ๋ฉ์ธ ์ค๋ ๋ ๋ธ๋กํน์ ์ค์ด๊ณ UI ๋ฐ์์ฑ์ ๊ทน๋ํํ๋ ์ค์ง์ ์ธ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์. ์ฌ์ฉ์ ๊ฒฝํ์ ์ํ ์น ์ฑ๋ฅ ์ต์ ํ ์ ๋ต์ ์๋ดํด ๋๋ ค์.
- ๋จ์ด: 2,149๊ฐ23๋ถ
[๐ค] Next.js App Router์ `generateMetadata`์ `generateViewport` ์ฌํ: SEO ๋ฐ PWA ์ต์ ํ ์ ๋ต
Next.js 14/13 App Router์์ `generateMetadata`์ `generateViewport` ํจ์๋ฅผ ํ์ฉํ์ฌ ๋์ SEO ๋ฉํํ๊ทธ์ PWA ์ค์ ์ ์ต์ ํํ๋ ์ฌํ ์ ๋ต์ ๋ค๋ฃน๋๋ค. ์ค๋ฌด ์์์ ํจ๊ป ์น์ฌ์ดํธ์ ๊ฒ์ ์์ง ๋ ธ์ถ ๋ฐ ์ฌ์ฉ์ ๊ฒฝํ์ ๊ทน๋ํํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,788๊ฐ19๋ถ
[๐ค] CSS ๋ณ์(Custom Properties) ์ฌํ: ๋์ ํ ๋ง, ์ค์ฝํ, JavaScript ํ์ฉ ์ ๋ต
CSS ๋ณ์(Custom Properties)์ ๊ธฐ๋ณธ๋ถํฐ ๋์ ํ ๋ง ๊ตฌํ, ์ค์ฝํ ์ ๋ต, ๊ทธ๋ฆฌ๊ณ JavaScript์์ ์ํธ์์ฉ๊น์ง ์ค๋ฌด์ ๋ฐ๋ก ์ ์ฉํ ์ ์๋ ์ฌํ ํ์ฉ๋ฒ์ ๋ธ๋ฃจ๊ฐ ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,293๊ฐ15๋ถ
[๐ค] Next.js App Router Edge Runtime: ๊ธ๋ก๋ฒ ์ฑ๋ฅ๊ณผ ๋น์ฉ ํจ์จ์ฑ ๊ทน๋ํ ์ ๋ต
Next.js App Router์์ Edge Runtime์ ํ์ฉํด Route Handler ์ฑ๋ฅ์ ๊ทน๋ํํ๊ณ , ๊ธ๋ก๋ฒ ์ฌ์ฉ์์๊ฒ ๋น ๋ฅธ ์๋ต ์๋๋ฅผ ์ ๊ณตํ๋ฉฐ, ๋น์ฉ ํจ์จ์ ์ผ๋ก ์ ํ๋ฆฌ์ผ์ด์ ์ ์ด์ํ๋ ์ค์ ์ ๋ต์ ์์ธํ ๋ค๋ค์. Edge Runtime์ ์ฅ์ ๊ณผ ์ ํ์ฌํญ, ๊ทธ๋ฆฌ๊ณ ์ค์ ์ฝ๋ ์์๋ฅผ ํตํด ํจ๊ณผ์ ์ธ ์ ์ฉ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,980๊ฐ25๋ถ
[๐ค] Next.js/React์์ ํด๋ฆฐ ์ํคํ ์ฒ์ ์์กด์ฑ ์ญ์ ์์น ์ ์ฉํ๊ธฐ: ํ์ฅ ๊ฐ๋ฅํ ํ๋ฐํธ์๋ ๋ง๋ค๊ธฐ
Next.js์ React ํ๋ก์ ํธ์์ ํด๋ฆฐ ์ํคํ ์ฒ์ ์์กด์ฑ ์ญ์ ์์น(DIP)์ ์ ์ฉํ๋ ๋ฐฉ๋ฒ์ ์ฌ์ธต์ ์ผ๋ก ๋ค๋ฃจ์ด์. ๋๋ฉ์ธ, ์ ์ค์ผ์ด์ค, ์ธํ๋ผ ๊ณ์ธต์ ๋ถ๋ฆฌํ์ฌ ์ ์ง๋ณด์์ฑ๊ณผ ํ ์คํธ ์ฉ์ด์ฑ์ ๊ทน๋ํํ๋ ์ค์ฉ์ ์ธ ์ ๋ต์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,733๊ฐ19๋ถ
[๐ค] Jotai๋ก Next.js App Router ํด๋ผ์ด์ธํธ ์ํ ๊ด๋ฆฌ ์ฌํ: ์ํฐ ํจํด๊ณผ ์ต์ ํ
Next.js App Router ํ๊ฒฝ์์ Jotai ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ํ์ฉํ์ฌ ํจ์จ์ ์ธ ํด๋ผ์ด์ธํธ ์ํ ๊ด๋ฆฌ ์ ๋ต์ ์์๋ณด์ธ์. ์ํฐ ํจํด์ ์ด์ฉํ ์ํ ๋ถ๋ฆฌ, ์ต์ ํ ๊ธฐ๋ฒ, ๊ทธ๋ฆฌ๊ณ ์ค์ฉ์ ์ธ ์ฝ๋ ์์๋ฅผ ํตํด ๋ณต์กํ UI ์ํ๋ฅผ ํจ๊ณผ์ ์ผ๋ก ๋ค๋ฃจ๋ ๋ฐฉ๋ฒ์ ๋ธ๋ฃจ๊ฐ ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,720๊ฐ18๋ถ
[๐ค] Next.js App Router ์ ์ญ ์ํ ๊ด๋ฆฌ: Server/Client Components ์๋ฒฝ ๊ฐ์ด๋
Next.js App Router ํ๊ฒฝ์์ Server Components์ Client Components ๊ฐ์ ์ ์ญ ์ํ๋ฅผ ํจ๊ณผ์ ์ผ๋ก ๊ด๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ํ๊ตฌํด์. Zustand, Recoil, Context API ๋ฑ ๋ค์ํ ์๋ฃจ์ ๊ณผ ์ค์ฉ์ ์ธ ์ ๋ต์ ํตํด ๋ณต์กํ ์ํ ๊ด๋ฆฌ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํด ๋ณด์ธ์.
- ๋จ์ด: 1,787๊ฐ20๋ถ
[๐ค] Atomic Design ํจํด์ผ๋ก React/Next.js ์ปดํฌ๋ํธ ์ํคํ ์ฒ ํ์ฅ์ฑ ๋์ด๊ธฐ
React ๋ฐ Next.js ํ๋ก์ ํธ์์ Atomic Design ํจํด์ ์ ์ฉํ์ฌ ์ปดํฌ๋ํธ์ ์ฌ์ฌ์ฉ์ฑ๊ณผ ํ์ฅ์ฑ์ ๊ทน๋ํํ๋ ๋ฐฉ๋ฒ์ ์ค๋ฌด ์์์ ํจ๊ป ์์ธํ ์๋ ค๋๋ ค์. ํจ์จ์ ์ธ ํ๋ก ํธ์๋ ์ํคํ ์ฒ๋ฅผ ๊ตฌ์ถํด ๋ณด์ธ์.
- ๋จ์ด: 2,160๊ฐ24๋ถ
[๐ค] ์๋ฐ์คํฌ๋ฆฝํธ Web Workers: UI ๋ธ๋กํน ์์ด ๋ฌด๊ฑฐ์ด ์์ ์ฒ๋ฆฌํ๊ธฐ
ํ๋ก ํธ์๋์์ CPU ์ง์ฝ์ ์ธ ์์ ์ UI ๋ธ๋กํน์ ํํ ๋ฌธ์ ์์. ์๋ฐ์คํฌ๋ฆฝํธ Web Workers๋ก ๋ฉ์ธ ์ค๋ ๋๋ฅผ ํด๋ฐฉํ๊ณ ์ฌ์ฉ์ ๊ฒฝํ์ ์ต์ ํํ๋ ์ค์ฉ์ ์ธ ๋ฐฉ๋ฒ์ ์ฝ๋ ์์์ ํจ๊ป ์์๋ณด์ธ์. ๋ณต์กํ ๊ณ์ฐ, ๋ฐ์ดํฐ ์ฒ๋ฆฌ ๋ฑ์ ๋ฐฑ๊ทธ๋ผ์ด๋์์ ์์ ํ๊ฒ ์คํํ๋ ๋ ธํ์ฐ๋ฅผ ๊ณต์ ํด์.
- ๋จ์ด: 1,822๊ฐ20๋ถ
[๐ค] TypeScript `as const` ์ฌ์ธต ๋ถ์: ๋ฆฌํฐ๋ด ํ์ ์ถ๋ก ๊ณผ ๋ถ๋ณ์ฑ ํ์ฉ ์ ๋ต
TypeScript์ `as const`๋ฅผ ํ์ฉํ์ฌ ๋ฆฌํฐ๋ด ํ์ ์ถ๋ก ์ ๊ฐํํ๊ณ , ๋ฐฐ์ด๊ณผ ๊ฐ์ฒด์ ๋ถ๋ณ์ฑ์ ์์ ํ๊ฒ ํ๋ณดํ๋ ์ค์ฉ์ ์ธ ๋ฐฉ๋ฒ์ ์์ธํ ์์๋ด์. ์ค๋ฌด ์ฝ๋์ ํ์ ์์ ์ฑ๊ณผ ๊ฐ๋ ์ฑ์ ๋์ฌ๋ณด์ธ์.
- ๋จ์ด: 1,486๊ฐ17๋ถ
[๐ค] Next.js @next/font๋ฅผ ํ์ฉํ ํฐํธ ์ต์ ํ ๋ฐ CLS ๊ฐ์ ์ ๋ต
Next.js ์ ํ๋ฆฌ์ผ์ด์ ์์ ํฐํธ ๋ก๋ฉ์ผ๋ก ์ธํ Cumulative Layout Shift(CLS)๋ฅผ ์ต์ํํ๊ณ ์น ์ฑ๋ฅ์ ๊ทน๋ํํ๋ @next/font ์ฌ์ฉ๋ฒ๊ณผ ์ค์ฉ์ ์ธ ์ต์ ํ ์ ๋ต์ ์์ธํ ์์๋ด์.
- ๋จ์ด: 1,914๊ฐ21๋ถ
[๐ค] Next.js App Router ๊ตญ์ ํ (i18n) ์๋ฒฝ ๊ฐ์ด๋: ๋ค๊ตญ์ด ์ง์ ๊ตฌํ ์ ๋ต
Next.js 14+ App Router ํ๊ฒฝ์์ ๊ตญ์ ํ(i18n)๋ฅผ ํจ๊ณผ์ ์ผ๋ก ๊ตฌํํ๋ ๋ฐฉ๋ฒ์ ์์ธํ ์๋ ค๋๋ ค์. ๋ฏธ๋ค์จ์ด๋ฅผ ํ์ฉํ ์ธ์ด ๊ฐ์ง๋ถํฐ ํด๋ผ์ด์ธํธ/์๋ฒ ์ปดํฌ๋ํธ์์์ ๋ค๊ตญ์ด ํ ์คํธ ์ฒ๋ฆฌ๊น์ง, ์ค๋ฌด์ ๋ฐ๋ก ์ ์ฉํ ์ ์๋ ๋ค๊ตญ์ด ์ง์ ์ ๋ต์ ๋ธ๋ฃจ๊ฐ ์๋ดํด ๋๋ฆด๊ฒ์.
- ๋จ์ด: 1,328๊ฐ16๋ถ
[์น ์ฑ๋ฅ ์ต์ ํ] Interaction to Next Paint (INP) ๊ฐ์ : ์ฌ์ฉ์ ๊ฒฝํ์ ๊ทน๋ํํ๋ ์ค์ ์ ๋ต
์๋ก์ด Core Web Vitals ์งํ, Interaction to Next Paint(INP)๋ฅผ ๊น์ด ์ดํดํ๊ณ ์ค์ ์น ์ ํ๋ฆฌ์ผ์ด์ ์์ INP ์ ์๋ฅผ ๊ฐ์ ํ๋ ์ค์ฉ์ ์ธ ์ต์ ํ ์ ๋ต๋ค์ ๋ธ๋ฃจ๊ฐ ์์ธํ ์๋ ค๋๋ ค์. ์ฌ์ฉ์ ์ธํฐ๋์ ์๋ต์ฑ์ ๋์ฌ ์ง์ ํ ์ฌ์ฉ์ ๊ฒฝํ์ ๋ง๋ค์ด ๋ณด์ธ์.
๋จ์ด: 1,668๊ฐ20๋ถ[๐ค] JavaScript Decorator ์ฌ์ธต ๋ถ์: ๋ฉํํ๋ก๊ทธ๋๋ฐ๊ณผ ํ์ ์คํฌ๋ฆฝํธ ํ์ฉ ์ ๋ต
JavaScript Decorator์ ๊ฐ๋ ๋ถํฐ ํ์ ์คํฌ๋ฆฝํธ์์์ ํ์ฉ, ๊ทธ๋ฆฌ๊ณ ๋ฏธ๋ ํ์คํ ๋ฐฉํฅ๊น์ง ์ฌ์ธต์ ์ผ๋ก ๋ค๋ฃจ๋ฉฐ, ์ค๋ฌด์์ ์ฝ๋ ์ฌ์ฌ์ฉ์ฑ๊ณผ ๊ฐ๋ ์ฑ์ ๋์ด๋ ๋ฉํํ๋ก๊ทธ๋๋ฐ ํจํด์ ํ์ตํด ๋ณด์ธ์.
- ๋จ์ด: 2,634๊ฐ28๋ถ
[๐ค] JavaScript ํ๋ก๋ฏธ์ค/async-await ์ฌํ: ์ค์ ํจํด๊ณผ ์ฃผ์์ฌํญ
JavaScript์ ํ๋ก๋ฏธ์ค์ async/await๋ฅผ ๊น์ด ์ดํดํ๊ณ , ์ค๋ฌด์์ ๋ง์ฃผํ๋ ๋ณต์กํ ๋น๋๊ธฐ ์ฒ๋ฆฌ ์ํฉ์์ ํ์ฉํ ์ ์๋ ๊ณ ๊ธ ํจํด๊ณผ ํํ ๋ฐ์ํ๋ ์ค์๋ฅผ ๋ฐฉ์งํ๋ ๋ฐฉ๋ฒ์ ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,421๊ฐ16๋ถ
[๐ค] TypeScript 5.2+ `using` ์ ์ธ์ผ๋ก ์์ ์๋ ๊ด๋ฆฌํ๊ธฐ: ๊น๋ํ ๋ฆฌ์์ค ์ ๋ฆฌ์ ์์
TypeScript 5.2์์ ๋์ ๋ `using` ์ ์ธ์ ํ์ฉํ์ฌ ํ์ผ ํธ๋ค, ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ฐ๊ฒฐ ๋ฑ ๋ค์ํ ์์์ ์๋์ผ๋ก ๊ด๋ฆฌํ๊ณ ๊น๋ํ๊ฒ ์ ๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ์ค์ฉ์ ์ธ ์์ ์ ํจ๊ป ์์ธํ ์์๋ด์. ๋ ์ด์ `try...finally` ๋ธ๋ก์ผ๋ก ๋ณต์กํ๊ฒ ์์์ ํด์ ํ ํ์ ์์ด์.
- ๋จ์ด: 2,006๊ฐ22๋ถ
[๐ค] Feature-Sliced Design (FSD)์ผ๋ก ํ์ฅ ๊ฐ๋ฅํ ํ๋ก ํธ์๋ ์ํคํ ์ฒ ๊ตฌ์ถํ๊ธฐ
Feature-Sliced Design (FSD)์ ๋๊ท๋ชจ ํ๋ก ํธ์๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ํ์ฅ์ฑ๊ณผ ์ ์ง๋ณด์์ฑ์ ๋์ด๋ ๊ฐ๋ ฅํ ์ํคํ ์ฒ ํจํด์ด์์. FSD์ ํต์ฌ ์์น, ๋ ์ด์ด ๊ตฌ์กฐ, ์ค๋ฌด ์ ์ฉ ๋ฐฉ๋ฒ์ ์ฝ๋ ์์์ ํจ๊ป ์์ธํ ์์๋ด์.
- ๋จ์ด: 1,781๊ฐ21๋ถ
[๐ค] TypeScript `moduleResolution: 'bundler'`์ `verbatimModuleSyntax` ์๋ฒฝ ์ดํด: ๋ชจ๋ ๋ฒ๋ค๋ฌ ์๋์ ํ์ ์คํฌ๋ฆฝํธ ์ค์ ์ต์ ํ
๋ชจ๋ ์๋ฐ์คํฌ๋ฆฝํธ ํ๋ก์ ํธ์์ TypeScript์ `moduleResolution: 'bundler'`์ `verbatimModuleSyntax` ์ต์ ์ด ์ ์ค์ํ์ง, ์ด๋ป๊ฒ ์ฌ๋ฐ๋ฅด๊ฒ ์ค์ ํ๊ณ ํ์ฉํ์ฌ ๊ฐ๋ฐ ๊ฒฝํ๊ณผ ๋ฒ๋ค๋ง ํจ์จ์ ๊ทน๋ํํ๋์ง ์ค๋ฌด ์์์ ํจ๊ป ์์ธํ ์์๋ด์.
- ๋จ์ด: 1,908๊ฐ24๋ถ
[๐ค] ๋ชจ๋ ธ๋ ํฌ ์ํคํ ์ฒ: ํจ์จ์ ์ธ ๋๊ท๋ชจ ํ๋ก์ ํธ ์ค๊ณ๋ฅผ ์ํ ์ค์ ๊ฐ์ด๋
๋๊ท๋ชจ ์น ํ๋ก์ ํธ์์ ๋ชจ๋ ธ๋ ํฌ๋ฅผ ๋์ ํ๋ ์ด์ , ์ฅ๋จ์ , ๊ทธ๋ฆฌ๊ณ ํจ๊ณผ์ ์ธ ๊ตฌ์กฐ ์ค๊ณ ๋ฐ ์ค๋ฌด ์ ์ฉ ์ ๋ต์ ๋ธ๋ฃจ๊ฐ ์์ธํ ์๋ ค๋๋ ค์. ํ ์์ฐ์ฑ ํฅ์๊ณผ ์ฝ๋ ์ฌ์ฌ์ฉ์ฑ์ ๊ทน๋ํํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
๋จ์ด: 2,188๊ฐ26๋ถ[๐ค] ์น ์ฑ๋ฅ ์ต์ ํ: ๋ฆฌํ๋ก์ฐ์ ๋ฆฌํ์ธํธ ์ต์ํ ์ ๋ต
๋ธ๋ผ์ฐ์ ๋ ๋๋ง ๊ณผ์ ์ ํต์ฌ์ธ ๋ฆฌํ๋ก์ฐ(Reflow)์ ๋ฆฌํ์ธํธ(Repaint)์ ๋ฐ์ ์๋ฆฌ๋ฅผ ์ดํดํ๊ณ , ์ด๋ฅผ ํจ๊ณผ์ ์ผ๋ก ์ค์ฌ ์น ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฑ๋ฅ์ ๊ทน๋ํํ๋ ์ค์ง์ ์ธ ์ ๋ต๊ณผ ์ฝ๋ ์์๋ฅผ ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,903๊ฐ19๋ถ
[๐ค] Vitest์ React Testing Library๋ก Next.js ์ปดํฌ๋ํธ ์๋ฒฝ ํ ์คํธํ๊ธฐ
Next.js ํ๋ก์ ํธ์์ Vitest์ React Testing Library๋ฅผ ํ์ฉํ์ฌ UI ์ปดํฌ๋ํธ๋ฅผ ํจ๊ณผ์ ์ผ๋ก ํ ์คํธํ๋ ๋ฐฉ๋ฒ์ ์ค๋ฌด ์์ ์ ํจ๊ป ์์ธํ ์์๋ด์. ์ค์ ๋ถํฐ Mocking, ์ด๋ฒคํธ ์๋ฎฌ๋ ์ด์ ๊น์ง, ๊ฒฌ๊ณ ํ ์ ํ๋ฆฌ์ผ์ด์ ๊ฐ๋ฐ์ ์ํ ํ ์คํธ ์ ๋ต์ ์ตํ๋ณด์ธ์.
- ๋จ์ด: 1,542๊ฐ20๋ถ
[๐ค] Tailwind CSS v4 ์ถ์: ๊ฐ๋ฐ์์๊ฒ ์ฐพ์์ฌ ๋ณํ์ ์ต์ ํ ์ ๋ต
Tailwind CSS v4์ ์ฃผ์ ๋ณ๊ฒฝ์ฌํญ๊ณผ ์๋ก์ด ๊ธฐ๋ฅ๋ค์ ๊น์ด ์๊ฒ ๋ถ์ํ๊ณ , ์ค๋ฌด์์ ํจ์จ์ ์ผ๋ก ์ ์ฉํ๋ฉฐ ์ฑ๋ฅ์ ์ต์ ํํ๋ ์ ๋ต์ ๋ธ๋ฃจ๊ฐ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,566๊ฐ20๋ถ
[๐ค] Next.js Dockerfile ์ต์ ํ: ํ๋ก๋์ ๋ฐฐํฌ๋ฅผ ์ํ ์๋ฒฝ ๊ฐ์ด๋
Next.js ์ ํ๋ฆฌ์ผ์ด์ ์ Docker ์ปจํ ์ด๋๋ก ํจ์จ์ ์ผ๋ก ๋ฐฐํฌํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์. ๋ฉํฐ์คํ ์ด์ง ๋น๋, ์บ์ฑ ์ ๋ต, ๋ณด์ ์ค์ ๋ฑ ํ๋ก๋์ ํ๊ฒฝ์ ์ต์ ํ๋ Dockerfile ์์ฑ ๊ฐ์ด๋๋ฅผ ์ ๊ณตํด ๋๋ ค์.
- ๋จ์ด: 2,177๊ฐ24๋ถ
[๐ค] CSS Grid ์ฌํ ๊ฐ์ด๋: ์ค์ ๋ ์ด์์ ํจํด๊ณผ ๋ฐ์ํ ๋์์ธ ์ ๋ต
CSS Grid๋ ๊ฐ๋ ฅํ 2์ฐจ์ ๋ ์ด์์ ์์คํ ์ด์์. ์ด ๊ฐ์ด๋์์ Grid์ ํต์ฌ ๊ฐ๋ ๋ถํฐ ์ค์ ๋ ์ด์์ ํจํด, ๋ฐ์ํ ๋์์ธ ์ ๋ต๊น์ง ์ฌ์ธต์ ์ผ๋ก ๋ค๋ฃจ์ด ์ค๋ฌด์ ๋ฐ๋ก ์ ์ฉํ ์ ์๋๋ก ๋์๋๋ ค์.
- ๋จ์ด: 1,718๊ฐ19๋ถ
[๐ค] TypeScript ํ ํ๋ฆฟ ๋ฆฌํฐ๋ด ํ์ : ๋ฌธ์์ด ํ์ ์ ๋ง๋ฒ์ฌ๋ก ๋ณ์ ํ๊ธฐ
TypeScript์ ํ ํ๋ฆฟ ๋ฆฌํฐ๋ด ํ์ ์ ํ์ฉํ์ฌ ๋ณต์กํ ๋ฌธ์์ด ํจํด์ ์์ ํ๊ฒ ํ์ ์ถ๋ก ํ๊ณ , ๊ฐ๋ ฅํ ์ ํธ๋ฆฌํฐ ํ์ ์ ๋ง๋๋ ๋ฐฉ๋ฒ์ ์ค๋ฌด ์์ ์ ํจ๊ป ์์ธํ ์์๋ด์. ํ์ ์์ ์ฑ์ ํ ๋จ๊ณ ๋์ฌ ๊ฐ๋ฐ ๊ฒฝํ์ ๊ฐ์ ํด ๋ณด์ธ์.
- ๋จ์ด: 1,918๊ฐ23๋ถ
[๐ค] JavaScript WeakMap๊ณผ WeakSet: ๋ฉ๋ชจ๋ฆฌ ๋์ ๋ฐฉ์ง์ ์ต์ ํ ์ ๋ต
JavaScript์์ WeakMap๊ณผ WeakSet์ ํ์ฉํ์ฌ ๋ฉ๋ชจ๋ฆฌ ๋์๋ฅผ ๋ฐฉ์งํ๊ณ ์ฑ๋ฅ์ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์ค์ฉ์ ์ธ ์์์ ํจ๊ป ์์ธํ ์์๋ด์. ๊ฐ๋น์ง ์ปฌ๋ ์ ๋์ ์๋ฆฌ์ ํจ๊ป ๊ฐ์ฒด ์ฐธ์กฐ ๊ด๋ฆฌ์ ์ค์์ฑ์ ์ดํดํ๊ณ , ์ค์ ํ๋ก์ ํธ์ ์ ์ฉํ๋ ์ ๋ต์ ๋ฐฐ์๋ด์.
- ๋จ์ด: 1,455๊ฐ17๋ถ
[๐ค] Next.js/React ํ๋ก์ ํธ๋ฅผ ์ํ ESLint & Prettier ์ค์ ์๋ฒฝ ๊ฐ์ด๋
๋ณต์กํ Next.js ๋ฐ React ํ๋ก์ ํธ์์ ์ผ๊ด๋ ์ฝ๋ ์คํ์ผ๊ณผ ํ์ง์ ์ ์งํ๋ ESLint์ Prettier ์ค์ ๋ฐฉ๋ฒ์ ์์ธํ ์๋ ค๋๋ ค์. ํ ๊ฐ๋ฐ ํ๊ฒฝ์ ์ต์ ํ๋ ์ค์ ์ผ๋ก ๊ฐ๋ฐ ํจ์จ์ ๋์ฌ๋ณด์ธ์.
- ๋จ์ด: 2,022๊ฐ25๋ถ
[๐ค] JavaScript์ ํต์ฌ: ํ๋กํ ํ์ ์ฒด์ธ ์๋ฒฝ ์ดํด์ ํ์ฉ ์ ๋ต
JavaScript์ ์ฌ์ฅ๋ถ, ํ๋กํ ํ์ ์ฒด์ธ์ ๋์ ์๋ฆฌ๋ฅผ ๊น์ด ํ๊ณ ๋ค์ด ๊ฐ์ฒด ์งํฅ ํ๋ก๊ทธ๋๋ฐ๊ณผ ์์์ ์๋ฒฝํ๊ฒ ์ดํดํ๊ณ ์ค๋ฌด์ ์ ์ฉํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์. ์ฑ๋ฅ ์ต์ ํ ํ๋ ํจ๊ป ๋ค๋ค์.
- ๋จ์ด: 2,118๊ฐ22๋ถ
[๐ค] React ์ปค์คํ ํ : ์ฌ์ฌ์ฉ์ฑ ๋์ด๋ ์ค๊ณ ์์น๊ณผ ํ ์คํธ ์ ๋ต
React ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฌ์ฌ์ฉ์ฑ๊ณผ ์ ์ง๋ณด์์ฑ์ ๊ทน๋ํํ๋ ์ปค์คํ ํ ์ค๊ณ ์์น, ์ค์ฉ์ ์ธ ํจํด, ๊ทธ๋ฆฌ๊ณ ๊ฒฌ๊ณ ํ ํ ์คํธ ์ ๋ต์ ์๋์ด ๊ฐ๋ฐ์์ ๊ด์ ์์ ์์ธํ ์ค๋ช ํด ๋๋ ค์.
- ๋จ์ด: 2,107๊ฐ23๋ถ
[๐ค] React useRef ํ ์ฌ์ธต ๋ถ์: DOM ๋์ด์ ์ค์ ํ์ฉ ์ ๋ต
React useRef ํ ์ ๊ธฐ๋ณธ ์๋ฆฌ๋ถํฐ DOM ์์ ์ง์ ์ ์ด, ์ปดํฌ๋ํธ ๋ผ์ดํ์ฌ์ดํด ๊ด๋ฆฌ, ๊ทธ๋ฆฌ๊ณ ์ฑ๋ฅ ์ต์ ํ๋ฅผ ์ํ ๋ค์ํ ์ค์ ํ์ฉ ์ ๋ต๊น์ง ์ฌ์ธต์ ์ผ๋ก ๋ค๋ค์. ์ด์ค๊ธ ๊ฐ๋ฐ์๋ฅผ ์ํ useRef ์๋ฒฝ ๊ฐ์ด๋.
- ๋จ์ด: 1,762๊ฐ19๋ถ
[๐ค] Next.js 14/15์์ ๋์ OG ์ด๋ฏธ์ง ์์ฑ: ImageResponse ์๋ฒฝ ๊ฐ์ด๋
Next.js App Router ํ๊ฒฝ์์ ImageResponse๋ฅผ ํ์ฉํ์ฌ ๋์ OG ์ด๋ฏธ์ง๋ฅผ ํจ์จ์ ์ผ๋ก ์์ฑํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์. SEO์ ์์ ๊ณต์ ์ต์ ํ๋ฅผ ์ํ ์ค์ ๊ฐ์ด๋์ ๋๋ค.
- ๋จ์ด: 1,481๊ฐ18๋ถ
[๐ค] Git ๋ธ๋์น ์ ๋ต: Git Flow vs GitHub Flow, ์ค๋ฌด์์ ์ด๋ป๊ฒ ์ ํํ๊ณ ์ด์ํ ๊น์?
๊ฐ๋ฐํ์ ํจ์จ์ ์ธ ํ์ ์ ์ํ Git ๋ธ๋์น ์ ๋ต์ ๊ณ ๋ฏผํ๊ณ ๊ณ์ ๊ฐ์? Git Flow์ GitHub Flow์ ํต์ฌ ๊ฐ๋ ๋ถํฐ ์ฅ๋จ์ , ๊ทธ๋ฆฌ๊ณ ์ฐ๋ฆฌ ํ์ ๋ง๋ ์ ๋ต์ ์ ํํ๊ณ ์ด์ํ๋ ์ค์ง์ ์ธ ํ๊น์ง '๋ธ๋ฃจ'๊ฐ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,442๊ฐ16๋ถ
[๐ค] TypeScript ํ์ ๊ฐ๋: ๋ฐํ์ ํ์ ์์ ์ฑ์ ์ํ ํ์ ํจํด ์ ๋ณตํด์
TypeScript์์ ๋ฐํ์์ ๋ณ์์ ํ์ ์ ์์ ํ๊ฒ ์ขํ๋(Narrowing) ๋ฐฉ๋ฒ์ธ ํ์ ๊ฐ๋(Type Guard)์ ๋ํด ์์ธํ ์์๋ด์. `typeof`, `instanceof`, `in` ์ฐ์ฐ์๋ถํฐ ์ฌ์ฉ์ ์ ์ ํ์ ๊ฐ๋๊น์ง, ์ค์ฉ์ ์ธ ์์์ ํจ๊ป ๊ฒฌ๊ณ ํ ์ฝ๋๋ฅผ ์์ฑํ๋ ๋ฐฉ๋ฒ์ ์ตํ๋ด์.
- ๋จ์ด: 2,542๊ฐ28๋ถ
[๐ค] React Query (TanStack Query) ์ฌํ: ๋ฐ์ดํฐ ํ์นญ, ์บ์ฑ, ๋๊ธฐํ ์ ๋ต์ผ๋ก ์น ์ฑ ์ฑ๋ฅ ๊ทน๋ํํด์
React Query (TanStack Query)๋ฅผ ํ์ฉํ์ฌ ๋ณต์กํ ์๋ฒ ์ํ๋ฅผ ํจ์จ์ ์ผ๋ก ๊ด๋ฆฌํ๊ณ , ์ง๋ฅ์ ์ธ ์บ์ฑ๊ณผ ์๋ ๋๊ธฐํ ์ ๋ต์ผ๋ก ์น ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฑ๋ฅ๊ณผ ์ฌ์ฉ์ ๊ฒฝํ์ ๊ทน๋ํํ๋ ๋ฐฉ๋ฒ์ ์ฌ์ธต์ ์ผ๋ก ๋ค๋ฃจ์ด์. useQuery, useMutation, useInfiniteQuery ๋ฑ ํต์ฌ ํ ๊ณผ ์ค์ ์ต์ ํ ํ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 2,401๊ฐ26๋ถ
[๐ค] React `useTransition`๊ณผ `useDeferredValue`๋ก ์ฌ์ฉ์ ๊ฒฝํ์ ๊ทน๋ํํ๋ ๋ฐฉ๋ฒ
React ์ ํ๋ฆฌ์ผ์ด์ ์์ ๋ฌด๊ฑฐ์ด UI ์ ๋ฐ์ดํธ๋ก ์ธํ ๋ฒ๋ฒ ์์ ํด๊ฒฐํ๊ณ , `useTransition`๊ณผ `useDeferredValue` ํ ์ ํ์ฉํ์ฌ ์ฌ์ฉ์ ๊ฒฝํ์ ํ๊ธฐ์ ์ผ๋ก ๊ฐ์ ํ๋ ์ค์ฉ์ ์ธ ์ ๋ต์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,917๊ฐ22๋ถ
[๐ค] React Suspense์ ErrorBoundary: ๊ฒฌ๊ณ ํ๊ณ ๋ถ๋๋ฌ์ด UI ๊ฒฝํ์ ์ํ ์ค์ ๊ฐ์ด๋
React ์ ํ๋ฆฌ์ผ์ด์ ์์ ์ฌ์ฉ์ ๊ฒฝํ์ ํ์ ํ Suspense์ ErrorBoundary์ ๊ฐ๋ ฅํ ์กฐํฉ์ ๊น์ด ์๊ฒ ๋ค๋ค์. ๋ก๋ฉ ์ํ์ ์๋ฌ ์ฒ๋ฆฌ๋ฅผ ์ฐ์ํ๊ฒ ๊ด๋ฆฌํ์ฌ ๋์ฑ ๊ฒฌ๊ณ ํ๊ณ ๋ถ๋๋ฌ์ด UI๋ฅผ ๋ง๋๋ ์ค์ ํ๊ณผ ์ฝ๋ ์์๋ฅผ ํ์ธํด ๋ณด์ธ์.
- ๋จ์ด: 1,302๊ฐ16๋ถ
[๐ค] CSS Container Queries: ์ปดํฌ๋ํธ ๊ธฐ๋ฐ ๋ฐ์ํ ๋์์ธ์ ์๋ก์ด ์งํ
๋ฏธ๋์ด ์ฟผ๋ฆฌ์ ํ๊ณ๋ฅผ ๋์ด, ์ปดํฌ๋ํธ ์์ฒด์ ํฌ๊ธฐ์ ๋ฐ๋ผ ์คํ์ผ์ ์กฐ์ ํ๋ CSS Container Queries๋ฅผ ๊น์ด ์๊ฒ ์์๋ณด๊ณ ์ค๋ฌด ์ ์ฉ ๋ฐฉ๋ฒ์ ์๋ดํด ๋๋ ค์.
- ๋จ์ด: 1,681๊ฐ19๋ถ
[๐ค] Next.js 15 ๊ณ ๊ธ ๋ฐ์ดํฐ ์บ์ฑ ์ ๋ต: fetch์ revalidate ์ฌ์ธต ๋ถ์
Next.js 15์์ `fetch` API์ ๊ฐ๋ ฅํ ์บ์ฑ ๋ฉ์ปค๋์ฆ๊ณผ `revalidate` ์ต์ ์ ํ์ฉํ์ฌ ์น ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฑ๋ฅ์ ์ต์ ํํ๊ณ ๋ฐ์ดํฐ๋ฅผ ํจ์จ์ ์ผ๋ก ๊ด๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ์ฌ์ธต์ ์ผ๋ก ๋ค๋ฃจ์ด์. ์ค๋ฌด ์์๋ฅผ ํตํด ์๋ฒ ์ปดํฌ๋ํธ์ ํด๋ผ์ด์ธํธ ์ปดํฌ๋ํธ์์ ์บ์ฑ ์ ๋ต์ ํจ๊ณผ์ ์ผ๋ก ์ ์ฉํ๋ ํ์ ์ ๊ณตํด์.
๋จ์ด: 1,320๊ฐ14๋ถ[๐ค] Next.js App Router: generateStaticParams๋ก ๋์ ๋ผ์ฐํ ๋น๋ ์ต์ ํํ๊ธฐ
Next.js App Router์์ generateStaticParams ํจ์๋ฅผ ํ์ฉํ์ฌ ๋์ ๋ผ์ฐํ ์ ์ ์ ํ์ด์ง๋ฅผ ํจ์จ์ ์ผ๋ก ์์ฑํ๊ณ ๋น๋ ์ฑ๋ฅ์ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์ค์ฉ์ ์ธ ์์์ ํจ๊ป ์์ธํ ์์๋ด์.
๋จ์ด: 1,891๊ฐ22๋ถ[๐ค] React ๋ ๋๋ง ์ต์ ํ: useMemo, useCallback, React.memo ์๋ฒฝ ๊ฐ์ด๋
์ด์ค๊ธ ๊ฐ๋ฐ์๋ฅผ ์ํ React ๋ ๋๋ง ์ต์ ํ ๊ฐ์ด๋. useMemo, useCallback, React.memo์ ์ ํํ ์ฌ์ฉ๋ฒ๊ณผ ์ค๋ฌด์์ ํํ ์ ์ง๋ฅด๋ ์ค์, ๊ทธ๋ฆฌ๊ณ ์ค์ ์ฑ๋ฅ ํฅ์ ์ ๋ต์ ๋ธ๋ฃจ๊ฐ ์๋ ค๋๋ ค์.
๋จ์ด: 2,145๊ฐ24๋ถ[๐ค] JavaScript Proxy์ Reflect ์ฌ์ธต ๋ถ์: ๋ฉํ ํ๋ก๊ทธ๋๋ฐ์ผ๋ก ์ฝ๋ ๊ฐํํ๊ธฐ
JavaScript Proxy์ Reflect API๋ฅผ ํ์ฉํ ๋ฉํ ํ๋ก๊ทธ๋๋ฐ ๊ธฐ๋ฒ์ ์ฌ์ธต ๋ถ์ํด์. ๊ฐ์ฒด ์ ๊ทผ ์ ์ด, ์ ํจ์ฑ ๊ฒ์ฌ, ๋ก๊น , ๋ฐ์ํ ์์คํ ๊ตฌํ ๋ฑ ์ค์ฉ์ ์ธ ํ์ฉ ์ฌ๋ก๋ฅผ ํตํด ์ฝ๋์ ์ ์ฐ์ฑ๊ณผ ์์ ์ฑ์ ๋์ด๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 2,029๊ฐ24๋ถ
[๐ค] React/Next.js ๋ฒ๋ค ์ต์ ํ: ์ฝ๋ ์คํ๋ฆฌํ ๊ณผ ๋ ์ด์ง ๋ก๋ฉ ์๋ฒฝ ๊ฐ์ด๋
React์ Next.js ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ฒ๋ค ํฌ๊ธฐ๋ฅผ ์ค์ด๊ณ ๋ก๋ฉ ์๋๋ฅผ ๊ฐ์ ํ๋ ์ฝ๋ ์คํ๋ฆฌํ ๊ณผ ๋ ์ด์ง ๋ก๋ฉ ๊ธฐ๋ฒ์ ์ค์ฉ์ ์ธ ์์์ ํจ๊ป ์์ธํ ์์๋ด์. ์นํฉ ์ค์ ๋ถํฐ React.lazy, Next.js dynamic import๊น์ง ๋ค๋ค์.
- ๋จ์ด: 1,770๊ฐ20๋ถ
[๐ค] React์ `useOptimistic` ํ ์ผ๋ก ๋๊ด์ UI ์ ๋ฐ์ดํธ ๊ตฌํํ๊ธฐ: Server Actions์ ํจ๊ป
React 18/19์ `useOptimistic` ํ ์ ํ์ฉํ์ฌ Server Actions์ ์ฐ๋๋๋ ๋๊ด์ UI ์ ๋ฐ์ดํธ๋ฅผ ๊ตฌํํ๋ ๋ฐฉ๋ฒ์ ์ค์ฉ์ ์ธ ์์์ ํจ๊ป ์์ธํ ์์๋ด์. ์ฌ์ฉ์ ๊ฒฝํ์ ๊ฐ์ ํ๊ณ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ฐ์์ฑ์ ๋์ด๋ ๋ ธํ์ฐ๋ฅผ ๊ณต์ ํด์.
๋จ์ด: 1,561๊ฐ17๋ถ[๐ค] TypeScript const Type Parameters: ๋ฆฌํฐ๋ด ํ์ ์ถ๋ก ๊ฐํ์ ์ค์ฉ์ ์ธ ํ์ฉ๋ฒ
TypeScript 5.0์ ๋์ ๋ const Type Parameters๋ฅผ ํ์ฉํ์ฌ ์ ๋ค๋ฆญ ํจ์์ ๋ฆฌํฐ๋ด ํ์ ์ถ๋ก ์ ์ ๊ตํ๊ฒ ์ ์ดํ๊ณ , ๋์ฑ ๊ฒฌ๊ณ ํ ํ์ ์์คํ ์ ๊ตฌ์ถํ๋ ์ค์ฉ์ ์ธ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์. as const์์ ์ฐจ์ด์ ๊ณผ ์ค์ ์ฝ๋ ์์๋ฅผ ํตํด ์ด์ค๊ธ ๊ฐ๋ฐ์๋ ์ฝ๊ฒ ์ดํดํ ์ ์๋๋ก ์ค๋ช ํด ๋๋ ค์.
- ๋จ์ด: 2,028๊ฐ22๋ถ
[๐ค] Next.js/React ์ฑ CLS ์ต์ ํ: ์ํํธ ์๋ ์ฌ์ฉ์ ๊ฒฝํ ๋ง๋ค๊ธฐ
Next.js์ React ์ ํ๋ฆฌ์ผ์ด์ ์์ Cumulative Layout Shift(CLS) ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๊ณ ์ฌ์ฉ์ ๊ฒฝํ์ ๊ฐ์ ํ๋ ์ค์ง์ ์ธ ์ ๋ต๊ณผ ์ฝ๋ ์์๋ฅผ ์์ธํ ์์๋ณด์ธ์. ์น ์ฑ๋ฅ ์ต์ ํ์ ํต์ฌ ์์์ธ CLS๋ฅผ ํจ๊ณผ์ ์ผ๋ก ๊ด๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,740๊ฐ21๋ถ
[๐ค] Next.js SSR, SSG, ISR ๋ ๋๋ง ์ ๋ต: App Router์์ ์ต์ ์ ์ ํ์?
Next.js App Router์์ ์๋ฒ ์ฌ์ด๋ ๋ ๋๋ง(SSR), ์ ์ ์ฌ์ดํธ ์์ฑ(SSG), ์ฆ๋ถ ์ ์ ์ฌ์์ฑ(ISR) ๊ฐ ๋ ๋๋ง ์ ๋ต์ ๋์ ์๋ฆฌ, ์ฅ๋จ์ , ์ค์ ํ์ฉ ๋ฐ ์ต์ ํ ๋ฐฉ๋ฒ์ ๋น๊ต ๋ถ์ํด๋๋ ค์.
- ๋จ์ด: 1,478๊ฐ17๋ถ
[๐ค] React Context API์ Zustand: ์ ์ญ ์ํ ๊ด๋ฆฌ, ์ธ์ ๋ฌด์์ ์จ์ผ ํ ๊น์?
React ์ ํ๋ฆฌ์ผ์ด์ ์ ์ ์ญ ์ํ ๊ด๋ฆฌ๋ฅผ ๊ณ ๋ฏผํ๊ณ ๊ณ์ ๊ฐ์? Context API์ ๊ฐ๋ฒผ์ด ์ธ๋ถ ์ํ ๊ด๋ฆฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ธ Zustand๋ฅผ ๋น๊ต ๋ถ์ํ๊ณ , ์ค๋ฌด์์ ๊ฐ ๋๊ตฌ๋ฅผ ํจ๊ณผ์ ์ผ๋ก ํ์ฉํ๋ ์ ๋ต์ ์ค์ ์ฝ๋ ์์์ ํจ๊ป ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 2,004๊ฐ24๋ถ
[๐ค] Turborepo๋ก Next.js ๋ชจ๋ ธ๋ ํฌ ๊ตฌ์ถ: ํจ์จ์ ์ธ ๊ฐ๋ฐ ๋ฐ ์ต์ ํ ์ ๋ต
Turborepo๋ฅผ ํ์ฉํ์ฌ Next.js ํ๋ก์ ํธ๋ฅผ ๋ชจ๋ ธ๋ ํฌ๋ก ๊ตฌ์ฑํ๊ณ , ๊ณต์ ์ปดํฌ๋ํธ, ์ ํธ๋ฆฌํฐ, CI/CD ์ต์ ํ ๋ฐฉ์์ ์ค๋ฌด ์์์ ํจ๊ป ์์ธํ ์ค๋ช ํด ๋๋ ค์.
- ๋จ์ด: 2,338๊ฐ27๋ถ
[๐ค] React useEffect ํ , ์ด์ ํท๊ฐ๋ฆฌ์ง ๋ง์ธ์! (์์กด์ฑ ๋ฐฐ์ด, ํด๋ฆฐ์ ์๋ฒฝ ๊ฐ์ด๋)
React ๊ฐ๋ฐ์์ ํ์์ ์ธ useEffect ํ ์ ๋์ ์๋ฆฌ๋ถํฐ ์์กด์ฑ ๋ฐฐ์ด, ํด๋ฆฐ์ ํจ์ ํ์ฉ๋ฒ, ๊ทธ๋ฆฌ๊ณ ์ค๋ฌด์์ ์์ฃผ ๊ฒช๋ ์ค์์ ์ต์ ํ ์ ๋ต๊น์ง, ์ด์ค๊ธ ๊ฐ๋ฐ์๋ฅผ ์ํ ์๋ฒฝ ๊ฐ์ด๋๋ฅผ ์ ๊ณตํด์.
- ๋จ์ด: 3,284๊ฐ31๋ถ
[๐ค] Next.js Server Actions ์ค์ : ์๋ฌ ์ฒ๋ฆฌ, ์ ํจ์ฑ ๊ฒ์ฌ, ๋๊ด์ UI ์ ๋ฐ์ดํธ
Next.js Server Actions๋ฅผ ์ค๋ฌด์ ์ ์ฉํ ๋ ๋ง์ฃผํ๋ ์๋ฌ ์ฒ๋ฆฌ, ๋ฐ์ดํฐ ์ ํจ์ฑ ๊ฒ์ฌ, ๊ทธ๋ฆฌ๊ณ ์ฌ์ฉ์ ๊ฒฝํ์ ํฅ์์ํค๋ ๋๊ด์ UI ์ ๋ฐ์ดํธ ๊ธฐ๋ฒ์ ์์ธํ ์ฝ๋ ์์์ ํจ๊ป ์์๋ณด์ธ์.
๋จ์ด: 1,983๊ฐ21๋ถ[๐ค] TypeScript ์ ํธ๋ฆฌํฐ ํ์ ์๋ฒฝ ๊ฐ์ด๋: ์ค์ ํ์ฉ ํจํด
TypeScript ์ ํธ๋ฆฌํฐ ํ์ ์ ํต์ฌ ๊ฐ๋ ๊ณผ ์ค์ ํ์ฉ๋ฒ์ ๊น์ด ์๊ฒ ๋ค๋ค์. Pick, Omit, Partial, Required ๋ฑ ์์ฃผ ์ฐ๋ ์ ํธ๋ฆฌํฐ ํ์ ์ผ๋ก ๋ณต์กํ ํ์ ์ ํจ๊ณผ์ ์ผ๋ก ๋ค๋ฃจ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์. ํ์ ์คํฌ๋ฆฝํธ ์ฝ๋์ ์ฌ์ฌ์ฉ์ฑ๊ณผ ์์ ์ฑ์ ๋์ด๋ ๋ ธํ์ฐ๋ฅผ ๊ณต์ ํด์.
- ๋จ์ด: 1,712๊ฐ20๋ถ
[๐ค] Next.js App Router ๋ฏธ๋ค์จ์ด: ๊ฐ๋ ฅํ ์์ฒญ ์ฒ๋ฆฌ ์ ๋ต๊ณผ ์ค์ ์์
Next.js App Router ํ๊ฒฝ์์ ๋ฏธ๋ค์จ์ด๋ฅผ ํ์ฉํด ์ฌ์ฉ์ ์ธ์ฆ, ๋ฆฌ๋ค์ด๋ ์ , ๊ตญ์ ํ ๋ฑ์ ์์ฒญ ์ฒ๋ฆฌ ๋ก์ง์ ํจ์จ์ ์ผ๋ก ๊ตฌํํ๋ ๋ฐฉ๋ฒ์ ์ค์ ์์ ์ ํจ๊ป ์์ธํ ์์๋ณด์ธ์.
- ๋จ์ด: 1,630๊ฐ19๋ถ
[๐ค] ํ์ ์คํฌ๋ฆฝํธ ์ ๋ค๋ฆญ ์ฌํ: ์ค์ฉ์ ์ธ ํจํด๊ณผ ํํ ์คํด๋ค
ํ์ ์คํฌ๋ฆฝํธ ์ ๋ค๋ฆญ(Generics)์ ๊น์ด ์ดํดํ๊ณ , ์ค๋ฌด์์ ์์ฃผ ์ฌ์ฉ๋๋ ์ ๋ค๋ฆญ ํจํด๊ณผ ํํ ๊ฒช๋ ์คํด๋ค์ ์ค์ ์ฝ๋ ์์์ ํจ๊ป ์ฝ๊ณ ๋ช ํํ๊ฒ ์ค๋ช ํด ๋๋ ค์. ํ์ ์์ ์ฑ๊ณผ ์ฝ๋ ์ฌ์ฌ์ฉ์ฑ์ ๋์ด๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
๋จ์ด: 1,860๊ฐ18๋ถ[๐ค] Next.js Route Handler: App Router์์ ์์ ํ๊ณ ํจ์จ์ ์ธ API ๊ตฌ์ถํ๊ธฐ (์ธ์ฆ, ์๋ฌ ์ฒ๋ฆฌ ํฌํจ)
Next.js App Router์ Route Handler๋ฅผ ์ฌ์ฉํ์ฌ API ์๋ํฌ์ธํธ๋ฅผ ๊ตฌ์ถํ๋ ๋ฐฉ๋ฒ์ ์์ธํ ์์๋ด์. ์ธ์ฆ, ์๋ฌ ์ฒ๋ฆฌ, ๊ทธ๋ฆฌ๊ณ ์บ์ฑ ์ ๋ต์ ํฌํจํ ์ค์ฉ์ ์ธ ํ์ผ๋ก ์์ ํ๊ณ ํจ์จ์ ์ธ ์๋ฒ๋ฆฌ์ค ํจ์๋ฅผ ๋ง๋๋ ๋ฐฉ๋ฒ์ ์ตํ๋ด์.
- ๋จ์ด: 1,934๊ฐ22๋ถ
[๐ค] Next.js Image ์ปดํฌ๋ํธ ์ต์ ํ: Core Web Vitals ๊ฐ์ ๋ถํฐ ์ค์ ํ์ฉ๊น์ง
Next.js์ Image ์ปดํฌ๋ํธ๋ฅผ ํ์ฉํ์ฌ ์น ์ฑ๋ฅ ํต์ฌ ์งํ์ธ Core Web Vitals๋ฅผ ๊ฐ์ ํ๊ณ , ๋ค์ํ ์ต์ ํ ์ต์ ์ ์ค์ ํ๋ก์ ํธ์ ์ ์ฉํ๋ ๋ฐฉ๋ฒ์ ๋ธ๋ฃจ๊ฐ ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 2,187๊ฐ25๋ถ
[๐ค] Next.js 14.1+์ ํ์ : Partial Prerendering (PPR) ์๋ฒฝ ๊ฐ์ด๋์ ์ค์ ์ต์ ํ ์ ๋ต
Next.js 14.1๋ถํฐ ๋์ ๋ Partial Prerendering (PPR)์ ํตํด ์ด๊ธฐ ๋ก๋ฉ ์๋๋ฅผ ๊ทน๋ํํ๊ณ ๋์ ์ฝํ ์ธ ๋ฅผ ํจ์จ์ ์ผ๋ก ์ฒ๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ์ฌ๋ ์๊ฒ ๋ค๋ฃจ์ด์. PPR์ ๋์ ์๋ฆฌ๋ถํฐ ์ค์ ํ๋ก์ ํธ ์ ์ฉ ์ ๋ต๊น์ง, ๊ฐ๋ฐ์๋ค์ด ๊ถ๊ธํดํ๋ ๋ชจ๋ ๊ฒ์ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,792๊ฐ19๋ถ
[๐ค] TypeScript ์กฐ๊ฑด๋ถ ํ์ ๊ณผ infer ํค์๋: ๋ณต์กํ ํ์ ๋ ์์ฝ๊ฒ ๋ค๋ฃจ๋ ๋ฐฉ๋ฒ
TypeScript ๊ฐ๋ฐ์์ ๋ง์ฃผํ๋ ๋ณต์กํ ํ์ ์ถ๋ก ๋ฌธ์ , ์กฐ๊ฑด๋ถ ํ์ ๊ณผ infer ํค์๋๋ฅผ ํ์ฉํ๋ฉด ํจ์ฌ ์ฐ์ํ๊ณ ๊ฐ๋ ฅํ๊ฒ ํด๊ฒฐํ ์ ์์ด์. ์ค์ ์์ ์ ํจ๊ป ๊ทธ ํ์ฉ๋ฒ์ ์ฌ๋ ์๊ฒ ๋ค๋ค๋ด ๋๋ค.
- ๋จ์ด: 1,705๊ฐ21๋ถ
[๐ค] JavaScript ์ด๋ฒคํธ ๋ฃจํ(Event Loop) ์์ ์ ๋ณต: ๋น๋๊ธฐ ์ฒ๋ฆฌ์ ๋ฐํ์ ๋์ ์๋ฆฌ
JavaScript์ ํต์ฌ ๋น๋๊ธฐ ์ฒ๋ฆฌ ๋ฉ์ปค๋์ฆ์ธ ์ด๋ฒคํธ ๋ฃจํ์ ๋์ ์๋ฆฌ๋ฅผ ์ฌ๋ ์๊ฒ ํํค์ณ ๋ด์. ์ฝ ์คํ, ํ์คํฌ ํ, ๋ง์ดํฌ๋กํ์คํฌ ํ์์ ์ํธ์์ฉ์ ์ดํดํ๊ณ , ์ค๋ฌด์์ ๋ง์ฃผ์น๋ ๋น๋๊ธฐ ์ฝ๋์ ๋์์ ๋ช ํํ ์์ธกํ๋ ๋ฐฉ๋ฒ์ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,964๊ฐ23๋ถ
[๐ค] Next.js Server & Client Components, ์ค์ ์์ ํ๋ช ํ๊ฒ ์ ํํ๋ ๊ฐ์ด๋
Next.js App Router์์ Server Components์ Client Components ์ค ์ด๋ค ๊ฒ์ ์ฌ์ฉํด์ผ ํ ์ง ๊ณ ๋ฏผ์ด์ ๊ฐ์? ์ด ๊ธ์์ ๋ ์ปดํฌ๋ํธ์ ํต์ฌ ์ฐจ์ด์ , ์ฌ์ฉ ์์ , ๊ทธ๋ฆฌ๊ณ ์ฑ๋ฅ ์ต์ ํ๋ฅผ ์ํ ์ค์ ์ ๋ต์ ๋ธ๋ฃจ๊ฐ ์๋ ค๋๋ฆด๊ฒ์.
- ๋จ์ด: 1,879๊ฐ21๋ถ
[๐ค] TypeScript satisfies ์ฐ์ฐ์: ํ์ ์ถ๋ก ๊ณผ ์์ ์ฑ์ ๋์์ ์ก๋ ๋น๋ฒ
TypeScript์ `satisfies` ์ฐ์ฐ์๋ฅผ ํ์ฉํ์ฌ ํ์ ์ถ๋ก ์ ์ ์ฐ์ฑ์ ์ ์งํ๋ฉด์๋ ์๊ฒฉํ ํ์ ์์ ์ฑ์ ํ๋ณดํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์. ์ค์ฉ์ ์ธ ์์๋ฅผ ํตํด ์ค์ ํ๋ก์ ํธ์ ์ ์ฉํ๋ ๋ ธํ์ฐ๋ฅผ ๊ณต์ ํฉ๋๋ค.
- ๋จ์ด: 1,211๊ฐ15๋ถ
[๐ค] React 19 ์๋ก์ด ๊ธฐ๋ฅ: use ํ , Actions, ๊ทธ๋ฆฌ๊ณ ์ปดํ์ผ๋ฌ ๋ฏธ๋ฆฌ๋ณด๊ธฐ
React 19์ ํต์ฌ ๋ณ๊ฒฝ ์ฌํญ์ธ use ํ , ์๋ฒ ์ก์ , ๊ทธ๋ฆฌ๊ณ React ์ปดํ์ผ๋ฌ์ ๋์ ๋ฐฐ๊ฒฝ๊ณผ ์ค์ ํ์ฉ ์์๋ฅผ ์ด์ค๊ธ ๊ฐ๋ฐ์ ๋๋์ด์ ๋ง์ถฐ ์์ธํ ์ค๋ช ํฉ๋๋ค. ์ต์ React ์ ๋ฐ์ดํธ๋ฅผ ํตํด ์ ํ๋ฆฌ์ผ์ด์ ์ฑ๋ฅ๊ณผ ๊ฐ๋ฐ ๊ฒฝํ์ ํฅ์์ํค๋ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์.
- ๋จ์ด: 1,524๊ฐ16๋ถ
[๐ค] Next.js App Router ์บ์ฑ ์ ๋ต: ๋ฐ์ดํฐ ์ฌ๊ฒ์ฆ (revalidatePath, revalidateTag) ์๋ฒฝ ๊ฐ์ด๋
Next.js 14 App Router์์ ํจ์จ์ ์ธ ๋ฐ์ดํฐ ์บ์ฑ ์ ๋ต๊ณผ revalidatePath, revalidateTag๋ฅผ ์ด์ฉํ ๋ฐ์ดํฐ ์ฌ๊ฒ์ฆ ๋ฐฉ๋ฒ์ ์ค๋ฌด ์์์ ํจ๊ป ์์ธํ ์์๋ณด๊ณ ์น ์ฑ๋ฅ์ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.