Penulis ingin menekankan, terkait bahasa pemrograman yang kita gunakan dalam tutorial ini, dan bahasa pemrograman Clean Code secara umum. Ini merupakan kode yang sama, namun ditulis dengan bahasa pemrograman yang berbeda.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

def create_validator(mode, number):
    if mode == 'Max':
        return lambda value: value < number
    elif mode == 'Min':
        return lambda value: value > number


is_below_max = create_validator('Max', 31)

print(is_below_max(15))
print(is_below_max(32))

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

function createValidator(mode: 'Max' | 'Min', number: number) {
    if (mode == 'Max') {
        return (value: number) => value < number;
    } else if (mode == 'Min') {
        return (value: number) => value > number;
    }
}

consts isBelowMax = createValidator('Max', 31);

console.log(isBelowMax(15));
console.log(isBelowMax(32));

Disatu sisi, kita akan menggunakan bahasa pemrograman python yang tidak memiliki deklarasi tipe secara eksplisit. Dan disisi lain, kita juga akan menggunakan bahasa pemrograman typescript.

Typescript adalah ekstensi dari javascript. Hal utama yang dilakukan typescript adalah menambahkan deklarasi tipe secara eksplisit, yang tidak dilakukan didalam kode javascript. Kita dapat melihat deklarasi tipe pada parameter fungsi utama, dan juga parameter fungsi return. Ada beberapa bahasa pemrograman lain yang menerapkan konsep deklarasi tipe serupa, seperti java dan C#. Ada juga bahasa pemrograman yang tidak menerapkan konsep ini, seperti python dan javascript.

Kamu mungkin berpendapat bahwa deklarasi tipe diperlukan untuk menulis Clean Code, karena deklarasi tipe ini dapat membantu kita dalam memahami kode yang ditulis. Deklarasi tipe memang sedikit membantu dalam membaca dan memahami kode. Namun sebenarnya, kegunaan utama dari deklarasi tipe adalah untuk membantu kita menghindari error. Mari kita lihat potongan kode dibawah ini.

1
2
3

function add(num1: number, num2: number) {
  return num1 + num2;
}

Deklarasi tipe membantu mencegah terjadinya error dan membantu dalam pembacaan kode

1
2

def add(num1, num2):
    return num1 + num2

Kode dapat dibaca dan dipahami meski tanpa deklarasi tipe

Kedua potongan kode diatas, sama-sama mudah dibaca dan dipahami, meski dengan ataupun tanpa deklarasi tipe. Jadi kita tidak harus menggunakan bahasa pemrograman dengan deklarasi tipe yang eksplisit untuk menulis Clean Code. Pada tutorial ini, kita akan banyak melihat contoh kode yang ditulis menggunakan bahasa pemrograman python dan javascript yang tidak menggunakan deklarasi tipe yang eksplisit.