Belajar ElysiaJS - Request, Response & Type Inference

#Pendahuluan

Setelah di episode 4 kita menguasai routing — dynamic parameters, query strings, dan route grouping — pada episode ini kita akan memahami bagaimana cara membaca data dari request dan menghasilkan response. ElysiaJS menyediakan object context yang powerful untuk mengakses semua data request secara type-safe.

#Memahami Object Context (ctx)

Setiap route handler menerima object context yang berisi semua data dari request. Semua property di context otomatis terekspos berdasarkan schema yang didefinisikan:

import { Elysia, t } from 'elysia'
 
const app = new Elysia()
  .post('/user/:id', ({ params, query, body, headers, cookie, set }) => {
    // params: path parameters
    // query: query string
    // body: request body
    // headers: request headers
    // cookie: cookie handler
    // set: response configuration
    return { userId: params.id, name: body.name }
  }, {
    params: t.Object({ id: t.String() }),
    query: t.Object({ format: t.Optional(t.String()) }),
    body: t.Object({
      name: t.String(),
      email: t.String({ format: 'email' }),
    }),
  })
  .listen(3000)

#Membaca Headers

Headers diakses melalui object headers — semua header otomatis terekspos sebagai string atau array:

.get('/protected', ({ headers }) => {
  const token = headers.authorization?.split(' ')[1]
  return { token }
})

#Membaca dan Menulis Cookie

Cookie diakses melalui object cookie — kalian bisa membaca, menulis, dan menghapus cookie:

.get('/login', ({ cookie }) => {
  cookie.session.set('abc123', {
    httpOnly: true,
    secure: true,
  })
  return { message: 'Logged in' }
})

#Response Type Options

ElysiaJS mendukung berbagai cara mengembalikan response:

#String → text/plain

.get('/', () => 'Hello Elysia!')
// Content-Type: text/plain

#Object → application/json

.get('/user', () => ({
  name: 'John',
  email: 'john@example.com',
}))
// Content-Type: application/json

#Response Class

Untuk kontrol penuh, gunakan Response bawaan:

.get('/data', () => {
  return Response.json(
    { users: [] },
    { status: 200, headers: { 'X-Custom': 'value' } }
  )
})

#Status Code dan Headers

Gunakan object set untuk mengatur status code dan response headers secara dinamis:

.post('/user', ({ body, set }) => {
  set.status = 201
  set.headers['X-Request-Id'] = crypto.randomUUID()
  return { id: 1, name: body.name }
}, {
  body: t.Object({
    name: t.String(),
    email: t.String(),
  })
})

Atau gunakan new Response untuk kasus yang lebih kompleks:

.get('/user/:id', ({ params, set }) => {
  set.status = 404
  return { error: 'User not found' }
})

#Penutup

Pada episode 5 ini, kalian telah memahami object context secara mendalam — cara membaca data request dan menghasilkan berbagai jenis response.

Inti yang harus dibawa pulang:

• Context object ctx berisi params, query, body, headers, cookie, dan set.
• Tiga jenis response utama: string (text/plain), object (JSON), dan Response class.
• set.status dan set.headers untuk mengatur status code dan headers secara dinamis.
• Cookie bisa dibaca dan ditulis melalui object cookie di context.
• Type inference otomatis dari schema ke handler — tidak perlu deklarasi tipe manual.

Di episode 6 selanjutnya kita akan memahami schema validation dengan TypeBox — bagaimana mendefinisikan validasi yang kuat, nested objects, optional fields, dan custom error handling. Sampai jumpa di episode 6!