Pengantar Augmentasi Modul

Augmentasi modul memungkinkan Anda memperluas atau mengubah modul yang sudah ada, sehingga Anda dapat menambahkan properti atau metode khusus ke pustaka atau modul dalam TypeScript.

Hal ini sangat berguna saat Anda bekerja dengan pustaka pihak ketiga yang memerlukan fungsi tambahan atau tipe khusus.

Apa Itu Augmentasi Modul?

Augmentasi modul melibatkan pembukaan kembali modul yang sudah ada serta penambahan atau pengubahan tipe maupun fungsinya menggunakan sintaks declare module.

Contoh Dasar Augmentasi Modul

Berikut contoh augmentasi modul express untuk menambahkan properti khusus ke objek Request:

import 'express';

declare module 'express' {
  interface Request {
    user?: { id: string; role: string };
  }
}

Menggunakan Modul yang Diaugmentasi

Setelah mengaugmentasi modul, Anda dapat menggunakan fungsi yang diperluas dalam aplikasi Anda:

import express from 'express';

const app = express();

app.use((req, res, next) => {
  req.user = { id: '123', role: 'admin' };
  next();
});

app.get('/', (req, res) => {
  res.send(`User ID: ${req.user?.id}`);
});

Menambahkan Tipe Khusus ke Modul Pihak Ketiga

Augmentasi modul sering digunakan untuk menambahkan tipe khusus ke pustaka pihak ketiga yang belum sepenuhnya mendukung kebutuhan Anda.

Tindakan Pencegahan saat Melakukan Augmentasi Modul

Saat mengaugmentasi modul:

• Pastikan Anda tidak menimpa tipe yang sudah ada secara tidak sengaja.
• Dokumentasikan perubahan Anda agar kode lebih mudah dipelihara.
• Gunakan augmentasi modul hanya jika diperlukan untuk menghindari penumpukan tipe global.

Kasus Penggunaan di Dunia Nyata

Augmentasi modul biasanya digunakan untuk:

• Memperluas pustaka pihak ketiga agar mencakup properti khusus aplikasi.
• Menambahkan properti middleware khusus dalam kerangka kerja seperti Express.js.
• Mengadaptasi modul untuk persyaratan proyek tertentu.

Tugas Latihan

Perluas objek Request dari modul express agar menyertakan metode khusus isAuthenticated. Gunakan metode ini dalam fungsi middleware contoh.

Selamat!

Anda telah mempelajari cara menggunakan augmentasi modul untuk memperluas atau mengubah modul yang sudah ada dalam TypeScript. Latih keterampilan ini untuk menyesuaikan pustaka pihak ketiga dan menyempurnakan aplikasi Anda!