Middleware Body Limit

Referensi: RFC 7230 HTTP/1.1 Message Syntax and Routing

Middleware Body Limit menegakkan ukuran body request maksimum dengan memeriksa header Content-Length. Mencegah payload besar yang dapat membebani server Anda.

Penggunaan Dasar

Terapkan middleware body limit menggunakan middleware built-in Deserve:

import { Router, Mware } from '@neabyte/deserve'

const router = new Router()

router.use(Mware.bodyLimit({
  limit: 1024 * 1024 // 1MB limit
}))

await router.serve(8000)

Limit Spesifik Rute

Terapkan limit body berbeda pada route tertentu:

// Limit 1MB untuk route umum
router.use(Mware.bodyLimit({ limit: 1024 * 1024 }))

// Limit 5MB untuk route upload
router.use('/uploads', Mware.bodyLimit({ limit: 5 * 1024 * 1024 }))

// Limit 10MB untuk route API
router.use('/api', Mware.bodyLimit({ limit: 10 * 1024 * 1024 }))

Opsi Konfigurasi

limit

Ukuran body maksimum dalam bytes:

// 1MB (1,048,576 bytes)
limit: 1024 * 1024

// 5MB (5,242,880 bytes)
limit: 5 * 1024 * 1024

// 10MB (10,485,760 bytes)
limit: 10 * 1024 * 1024

Cara Kerja

Middleware memeriksa header Content-Length sebelum body dibaca:

1. Request GET/HEAD - Secara otomatis dilewati (tidak ada body)
2. Content-Length ada - Memvalidasi terhadap limit
3. Transfer-Encoding ada - Melewati (chunked encoding)
4. Tidak ada header - Melewati (ukuran tidak diketahui)

Kepatuhan RFC 7230

Middleware mengikuti RFC 7230:

• Jika Transfer-Encoding dan Content-Length keduanya ada, Transfer-Encoding memiliki prioritas dan ukuran body tidak divalidasi
• Hanya memvalidasi Content-Length ketika Transfer-Encoding tidak ada
• Menangani chunked encoding dengan melewati (tidak dapat memeriksa ukuran sebelumnya)

Contoh Lengkap

import { Router, Mware } from '@neabyte/deserve'

const router = new Router({ routesDir: './routes' })

// Limit global 1MB
router.use(Mware.bodyLimit({ limit: 1024 * 1024 }))

// 5MB untuk upload file
router.use('/uploads', Mware.bodyLimit({ limit: 5 * 1024 * 1024 }))

// 10MB untuk route API
router.use('/api', Mware.bodyLimit({ limit: 10 * 1024 * 1024 }))

await router.serve(8000)

Penanganan Error

Body Limit secara otomatis menggunakan router.catch() jika didefinisikan:

router.catch((ctx, { statusCode, error }) => {
  if (statusCode === 413) {
    return ctx.send.json(
      { error: 'Request entity too large', message: error?.message },
      { status: 413 }
    )
  }
  return ctx.send.json({
    error: error?.message ?? 'Error tidak diketahui'
  }, { status: statusCode })
})

router.use(Mware.bodyLimit({ limit: 1024 * 1024 }))

Ketika limit terlampaui, middleware mengembalikan pesan Request entity too large dengan status code: 413 sebelum body request dibaca.