MODUL 14: REFACTORING CODE DENGAN STANDAR NODE.JS

 


🧠 MODUL 14: REFACTORING CODE DENGAN STANDAR NODE.JS

📘 Tujuan Pembelajaran:

  1. Mahasiswa mampu memahami pentingnya penulisan kode yang rapi dan terstruktur.
  2. Mahasiswa mampu menerapkan standar penulisan kode dalam proyek Node.js.
  3. Mahasiswa mampu melakukan refactoring terhadap kode yang sudah ada.

🔧 A. MEMBUAT PROJECT MODUL

Langkah 1: Menyalin Folder Proyek Lama

  • Pilih salah satu tugas jurnal dari modul 2 sampai modul 13, usahakan pilih yang sederhana (misal: hanya fungsi perhitungan, atau express route sederhana).
  • Copy-paste folder tersebut ke lokasi baru.
  • Rename folder hasil copy menjadi format:
    REFACTORING 
    


Langkah 2: Buka Folder di IDE

  • Gunakan IDE seperti Visual Studio Code (VSCode).
  • Buka folder hasil salinan tadi.
  • Pastikan struktur proyek masih berjalan (misal: jalankan node index.js atau npm start jika menggunakan Express).

🛠️ B. REFACTORING DENGAN STANDAR CODE

⚠️ Masalah Umum Kode Tidak Rapi:

  • Nama variabel tidak jelas (x, data1)
  • Penggunaan var alih-alih let atau const
  • Indentasi berantakan
  • Tidak ada komentar
  • Fungsi terlalu panjang dan membingungkan

✅ Refactor Kode Sesuai Standar Node.js

1. Naming Convention

a. Variable / Property / Attribute
  • Gunakan camelCase.
  • Nama harus deskriptif dan jelas.
  • // ❌ Salah
    const x = 10;
    
    // ✅ Benar
    const totalPrice = 10;
    

     

b. Function / Method / Procedure
  • Gunakan kata kerja + objek (misalnya getUser(), sendEmail()).
// ❌ Salah
function data() { ... }

// ✅ Benar
function fetchData() { ... }

 

c. Class / Constructor
  • Gunakan PascalCase.
class UserModel {
  constructor(name) {
    this.name = name;
  }
}

 

d. Constant Global
  • Gunakan UPPER_SNAKE_CASE.
const MAX_RETRIES = 5;

 


2. White Space & Indentasi

  • Gunakan indentasi 2 spasi (default di VSCode).
  • Tambahkan baris kosong antar fungsi.
  • Tambahkan spasi antar operator.
// ❌ Salah
function add(a,b){return a+b;}

// ✅ Benar
function add(a, b) {
  return a + b;
}

 


3. Deklarasi Variabel

  • Gunakan const untuk nilai tetap, let jika bisa berubah.
  • Hindari var.
// ❌ Salah
var total = 10;

// ✅ Benar
const total = 10;

 


4. Komentar

  • Komentar harus menjelaskan maksud, bukan hal yang jelas.
// ❌ Salah
// Ini fungsi
function add(a, b) { return a + b; }

// ✅ Benar
// Menambahkan dua bilangan dan mengembalikan hasilnya
function add(a, b) {
  return a + b;
}

 

  • Gunakan komentar JSDoc untuk dokumentasi fungsi.
/**
 * Menghitung total dari array harga
 * @param {number[]} prices - Array berisi harga
 * @returns {number} Total harga
 */
function getTotal(prices) {
  return prices.reduce((sum, price) => sum + price, 0);
}

 


5. Struktur File & Modul

Jika sebelumnya semua kode ditulis dalam satu file (misal index.js), cobalah memecah ke dalam file modular seperti:

refectoring/
├── index.js
├── controllers/
│   └── userController.js
├── models/
│   └── userModel.js
├── routes/
│   └── userRoutes.js

 



📝 TUGAS MAHASISWA

📌 Instruksi Tugas Refactoring

  1. Pilih salah satu tugas jurnal dari modul sebelumnya.
  2. Salin dan rename menjadi: refevtoring
  3. Lakukan refactoring pada kode tersebut dengan aturan:
Aspek Checklist
Naming convention sesuai ✅
Tidak ada penggunaan var ✅
Gunakan const/let ✅
Indentasi dan spasi rapi ✅
Komentar fungsi ditulis ✅
Minimal ada 1 komentar JSDoc ✅
File modular (jika memungkinkan) ✅
Tidak ada kode duplikat ✅
  1. Tambahkan file README.md di dalam folder modul14_NIM yang berisi:
    • Nama lengkap & NIM
    • Deskripsi singkat tugas
    • Perubahan yang dilakukan (refactoring apa saja)
    • Command untuk menjalankan proyek

🔚 PENUTUP

Dengan refactoring kode sesuai standar, kamu akan:

  • Lebih mudah membaca dan memahami kode.
  • Lebih siap kerja tim di dunia kerja.
  • Mempermudah debugging dan scaling aplikasi ke depannya.

Leave a Comment

Your email address will not be published. Required fields are marked *