Panduan gaya JavaScript: Menulis kode bersih dan konsisten
Hai teman-teman pemula penulis kode! Saya sangat senang untuk memulai perjalanan ini bersama Anda saat kita telusuri dunia panduan gaya JavaScript. Sebagai seseorang yang telah mengajar pemrograman selama tahun tahun, saya sungguh-sungguh tidak bisa menekankan cukup betapa pentingnya menulis kode yang bersih dan konsisten. Itu seperti menjaga kamar Anda rapi - itu membuat segala sesuatu mudah untuk ditemukan dan dikelola!
Mengapa Kita Butuh Panduan Gaya?
Sebelum kita mendalam, mari berbicara tentang mengapa kita memerlukan panduan gaya. Bayangkan Anda bekerja pada proyek kelompok, dan setiap orang menulis kode mereka secara berbeda. Itu akan menjadi chaos! Panduan gaya adalah seperti set aturan yang semua orang setuju untuk mengikuti, membuat kode lebih mudah untuk dibaca dan dipelihara.
Sekarang, mari kita masuk ke hal-hal mendalam panduan gaya JavaScript!
Indentasi Kode
H3: Dasar Kode yang Mudah Dibaca
Indentasi adalah seperti dasar rumah - itu sangat penting untuk struktur dan stabilitas. Dalam JavaScript, kita biasanya menggunakan spasi atau tab untuk mengindentasi kode kita. Mari lihat contoh:
function greetStudent(name) {
if (name) {
console.log("Hello, " + name + "!");
} else {
console.log("Hello, student!");
}
}
Dalam contoh ini, kita mengindentasi kode di dalam fungsi dan pernyataan if-else. Hal ini membuat jelas bagian mana dari kode yang bersama-sama.
Komentar
H3: Menyingkap Jejak untuk Nanti
Komentar adalah seperti catatan kecil yang Anda tinggalkan untuk diri Anda sendiri (atau orang lain) dalam kode Anda. Mereka menjelaskan apa yang dilakukan kode tanpa mengganggu bagaimana kode berjalan. Mari lihat bagaimana kita menggunakannya:
// Ini adalah komentar baris tunggal
/*
Ini adalah
komentar multi-baris
*/
/**
* Ini adalah komentar JSDoc
* Itu digunakan untuk mendokumentasikan fungsi
* @param {string} name - Nama murid
*/
function greetStudent(name) {
// Kode disini
}
Ingat, komentar yang bagus menjelaskan mengapa, bukan apa. Kode itu sendiri harus cukup jelas untuk menunjukkan apa yang sedang dilakukan.
Deklarasi Variabel
H3: Mengenalkan Karakter dalam Cerita Kode Anda
Variabel adalah seperti karakter dalam cerita kode Anda. Dalam JavaScript, kita memiliki beberapa cara untuk mendeklarasikan mereka:
// Menggunakan 'let' untuk variabel yang dapat berubah
let age = 25;
// Menggunakan 'const' untuk variabel yang tidak akan berubah
const PI = 3.14159;
// Hindari penggunaan 'var' dalam JavaScript modern
// var oldWay = "Kami tidak melakukan ini lagi";
Selalu deklarasikan variabel Anda sebelum menggunakannya, dan cobalah untuk menggunakan const
kecuali Anda tahu nilai akan berubah.
Nama Pengenal dalam camelCase
H3: Konvensi Nama yang Menggunakan Akal
Dalam JavaScript, kita menggunakan camelCase untuk sebagian besar pengenal. Itu seperti menyatukan kata-kata, tetapi mengkapitalisir setiap kata baru (kecuali yang pertama). Mari lihat bagaimana itu terlihat:
let firstName = "John";
let lastName = "Doe";
let fullName = firstName + " " + lastName;
function calculateArea(width, height) {
return width * height;
}
const MAX_SIZE = 100; // Ekspektasi: konstanta seringkali dalam ALL_CAPS
Spasi dan Kurung
H3: Memberi Kode Anda Ruang untuk Bernapas
Penempatan spasi membuat kode Anda mudah dibaca. Itu seperti menambah paragraf ke esai yang panjang. Mari lihat bagaimana kita menggunakan spasi dan kurung:
// Penempatan spasi yang baik
if (condition) {
doSomething();
} else {
doSomethingElse();
}
// Pemanggilan fungsi
console.log("Hello, World!");
// Array dan objek
let colors = ["red", "green", "blue"];
let person = { name: "Alice", age: 30 };
Perhatikan bagaimana kita menggunakan spasi di sekitar operator dan setelah koma. Itu adalah detail kecil yang membuat kode Anda terlihat profesional!
Aturan Objek
H3: Mengstrukturkan Data Anda
Objek adalah seperti wadah untuk data yang berkaitan. Mari lihat bagaimana kita biasanya mengstrukturkan mereka:
const student = {
name: "Bob",
age: 20,
grades: {
math: 90,
science: 85
},
isEnrolled: true
};
// Mengakses properti objek
console.log(student.name);
console.log(student["age"]);
Jaga properti objek Anda konsisten dan teratur. Itu akan menghindari Anda dari kesulitan nanti!
Aturan Pernyataan
H3: Satu Pemikiran, Satu Baris
Secara umum, kita mencoba untuk menjaga setiap pernyataan di baris sendiri. Itu seperti menulis kalimat-kalimat dalam esai - setiap kalimat harus menyatakan pemikiran lengkap:
let a = 5;
let b = 10;
let c = a + b;
if (c > 10) {
console.log("c lebih besar dari 10");
}
Hal ini membuat kode Anda mudah dibaca dan di debug.
Panjang Baris
H3: Menjaga Hal-hal Kompak
Coba untuk menjaga panjang baris kode Anda diukuran yang wajar - biasanya sekitar 80-100 karakter. Jika suatu baris menjadi terlalu panjang, pecahkanlah itu:
// Terlalu panjang
let result = veryLongFunctionName(extremelyLongVariableName1, extremelyLongVariableName2, extremelyLongVariableName3);
// Lebih baik
let result = veryLongFunctionName(
extremelyLongVariableName1,
extremelyLongVariableName2,
extremelyLongVariableName3
);
Hal ini meningkatkan keterbacaan dan membuat kode Anda terlihat rapih.
Menggabungkan Semua
Sekarang kita telah melihat semua panduan gaya ini, mari kita lihat contoh lengkap yang menggabungkan semua hal ini:
/**
* Menghitung harga total item di keranjang belanja
* @param {Object[]} items - Array item di keranjang
* @returns {number} Harga total
*/
function calculateTotalPrice(items) {
let total = 0;
const TAX_RATE = 0.08;
for (let i = 0; i < items.length; i++) {
let item = items[i];
let itemPrice = item.price * (1 + TAX_RATE);
total += itemPrice;
// Catat harga setiap item dengan pajak
console.log(`${item.name}: $${itemPrice.toFixed(2)}`);
}
return total.toFixed(2);
}
// Contoh penggunaan
const shoppingCart = [
{ name: "Kaus", price: 15.99 },
{ name: "Celana", price: 39.99 },
{ name: "Sepatu", price: 59.99 }
];
let finalPrice = calculateTotalPrice(shoppingCart);
console.log(`Harga total: $${finalPrice}`);
Contoh ini menampilkan indentasi yang benar, komentar, deklarasi variabel, penggunaan camelCase, spasi, penggunaan objek, dan adherensi ke panduan panjang baris.
Ingat, mengikuti panduan gaya ini akan membuat kode Anda lebih mudah dibaca dan dipelihara. Itu adalah keterampilan yang akan membantu Anda sepanjang perjalanan pemrograman Anda. Selamat pemrograman, dan may your code always be clean and consistent!
Metode | Deskripsi |
---|---|
calculateTotalPrice(items) |
Menghitung harga total item di keranjang belanja, termasuk pajak |
console.log() |
Mengeluarkan pesan ke konsol untuk debugging dan informasi |
toFixed(2) |
Memformat sebuah nomor untuk memiliki dua tempat desimal |
Credits: Image by storyset