Variabel, state, dan scope
Di mana sebuah variabel bisa dilihat, berapa lama ia hidup, dan siapa yang boleh mengubahnya. Scope di Python, JavaScript, dan Go, closure, dan kenapa state bersama memicu begitu banyak bug.
Bagian sebelumnya menunjukkan bahwa variabel adalah nama yang menunjuk ke sesuatu di memori. Bagian ini mengajukan tiga pertanyaan lanjutan tentang nama itu: di mana ia bisa dilihat, berapa lama ia hidup, dan siapa yang boleh mengubah isinya? Tiga pertanyaan itulah yang dimaksud dengan scope dan state, dan salah memahaminya ada di balik sebagian besar bug sehari-hari.
State: apa yang diingat program
State adalah semua yang diingat program pada satu saat: isi variabelnya, isi list-nya, baris-baris di database-nya. Tanpa state, program hanya bisa menghasilkan output yang sama dari input yang sama. Dengan state, program bisa menghitung, menyimpan keranjang belanja, atau mengingat siapa yang sedang login.
State juga tempat masalah dimulai. Nilai yang tidak pernah berubah mudah dipahami. Nilai yang bisa diubah dari banyak tempat berarti, untuk tahu isinya sekarang, kita harus tahu semua yang pernah menyentuhnya. Sebagian besar isi bagian ini adalah tentang menjaga daftar itu tetap pendek.
Scope: di mana sebuah nama terlihat
Scope adalah bagian kode tempat sebuah nama bisa dipakai. Spesifikasi Go mendefinisikannya sebagai “the extent of source text in which the identifier denotes the specified constant, type, variable, function, label, or package”, yaitu rentang kode tempat nama itu berlaku. Tutorial Python menyebutnya “a textual region of a Python program where a namespace is directly accessible”, sedangkan namespace adalah “a mapping from names to objects”.
Dalam bahasa sederhana: variabel yang dibuat di dalam sebuah fungsi atau blok biasanya hanya ada di sana. Kode di luar tidak bisa melihatnya, dan ia tidak bentrok dengan variabel bernama sama di tempat lain. Ini hal yang baik. Semakin kecil scope sebuah variabel, semakin sedikit tempat yang bisa mengubahnya, dan semakin mudah dipahami.
Python: fungsi dan kejutan UnboundLocalError
Di Python, variabel yang di-assign di dalam fungsi bersifat lokal untuk fungsi itu. Aturan ini memunculkan error membingungkan yang hampir semua orang pernah temui:
count = 0
def increment():
count = count + 1
return count
increment()
UnboundLocalError: cannot access local variable 'count' where it is not associated with a value
FAQ Python menjelaskan sebabnya: “when you make an assignment to a variable in a scope, that variable becomes local to that scope”. Begitu ada assignment ke sebuah variabel di dalam scope, variabel itu jadi lokal. Karena increment meng-assign count, Python menganggap count lokal di seluruh fungsi, termasuk di ruas kanan count + 1, padahal count lokal itu belum punya nilai.
Kalau memang ingin mengubah variabel di luar, Python meminta kita menyatakannya. Dari tutorialnya: “The global statement can be used to indicate that particular variables live in the global scope and should be rebound there”, dan “To rebind variables found outside of the innermost scope, the nonlocal statement can be used.”
def increment_global():
global count
count = count + 1
return count
print(increment_global(), increment_global()) # 1 2
Ini berjalan, tapi setiap fungsi yang menulis ke variabel global adalah satu tempat lagi yang harus dicek saat variabel itu berisi nilai aneh. Kebanyakan waktu, mengoper nilai sebagai parameter lalu mengembalikan nilai baru adalah pilihan yang lebih bersih.
PHP: fungsi mulai dari nol
PHP lebih ketat dari Python: sebuah fungsi bahkan tidak bisa membaca variabel di luarnya kecuali diminta. Kata manualnya: “Any variable created inside a named function or an anonymous function is limited to the scope of the function body.”
$count = 0;
function show() {
echo $count;
}
show();
Warning: Undefined variable $count
Untuk memakai variabel di luar, “The global keyword is used to bind a variable from a global scope into a local scope”:
function increment() {
global $count;
$count = $count + 1;
return $count;
}
echo increment(), " ", increment(); // 1 2
PHP juga punya variabel static, yang nilainya bertahan di antara pemanggilan fungsi yang sama:
function counter() {
static $n = 0;
$n++;
return $n;
}
echo counter(), " ", counter(), " ", counter(); // 1 2 3
Praktis, tapi itu state yang tersembunyi di dalam fungsi, dengan kelemahan yang sama seperti variabel global.
JavaScript: var, let, dan const
JavaScript punya tiga cara mendeklarasikan variabel, dan bedanya persis di soal scope:
var“declares function-scoped or globally-scoped variables”. Ia mengabaikan blok sepertiifdanfor.- Deklarasi
let“are scoped to blocks as well as functions.” constmiriplet, tapi namanya tidak bisa diarahkan ke nilai baru.
Bedanya paling mudah terlihat di perulangan yang menjadwalkan pekerjaan untuk nanti:
for (var i = 0; i < 3; i++) {
setTimeout(() => console.log("var", i), 0);
}
for (let j = 0; j < 3; j++) {
setTimeout(() => console.log("let", j), 0);
}
var 3
var 3
var 3
let 0
let 1
let 2
Dengan var, hanya ada satu i untuk seluruh fungsi, dan saat callback dijalankan, perulangan sudah selesai sehingga i bernilai 3. Dengan let, setiap iterasi punya j-nya sendiri.
const sering disalahpahami. Kata MDN: “The const declaration creates an immutable reference to a value. It does not mean the value it holds is immutable — just that the variable identifier cannot be reassigned.” Yang dikunci adalah namanya, bukan isi objeknya.
const config = { debug: false };
config.debug = true; // boleh: mengubah isi objek
console.log(config.debug); // true
config = {}; // TypeError: Assignment to constant variable.
Dua detail lagi menjelaskan beberapa error yang membingungkan. Deklarasi var “are processed before any code within the script is executed” (disebut hoisting), tapi “Only a variable’s declaration is hoisted, not its initialization”, jadi membaca var sebelum waktunya menghasilkan undefined, bukan error. Variabel let yang dibaca terlalu awal berada di “temporal dead zone”, dan “any attempt to access it will result in a ReferenceError”:
console.log(typeof hoisted, hoisted); // undefined undefined
var hoisted = 5;
console.log(total); // ReferenceError: Cannot access 'total' before initialization
let total = 1;
Aturan praktis yang dipakai kebanyakan tim: const sebagai bawaan, let kalau memang perlu diubah, dan tidak ada var di kode baru.
Go: blok dan shadowing
Go membatasi variabel per blok, dan membolehkan nama yang sama dipakai lagi di blok yang lebih dalam. Kata spesifikasinya: “An identifier declared in a block may be redeclared in an inner block. While the identifier of the inner declaration is in scope, it denotes the entity declared by the inner declaration.” Ini disebut shadowing:
x := 1
if true {
x := 2 // x baru, hanya di dalam blok ini
fmt.Println("inside:", x)
}
fmt.Println("outside:", x)
inside: 2
outside: 1
Jebakannya ada di :=. Menulis x := 2 alih-alih x = 2 membuat variabel baru, bukan mengubah yang di luar, dan kodenya tetap bisa di-compile. Kalau ada nilai yang “tidak berubah” di Go, shadowing yang tidak disengaja adalah salah satu hal pertama yang perlu dicek.
Closure: fungsi yang ingat
Sebuah fungsi bisa memakai variabel dari scope tempat ia dibuat, bahkan setelah scope itu selesai. MDN mendefinisikan closure sebagai “the combination of a function bundled together (enclosed) with references to its surrounding state (the lexical environment)”, yaitu fungsi beserta referensi ke lingkungan di sekitarnya.
def make_counter():
n = 0
def step():
nonlocal n
n += 1
return n
return step
a = make_counter()
b = make_counter()
print(a(), a(), a(), b()) # 1 2 3 1
Setiap counter punya n pribadinya sendiri. Tidak ada yang bisa menyentuhnya dari luar kecuali lewat step. Itulah state dengan scope yang sangat kecil, persis yang kita inginkan.
Closure juga menjelaskan kenapa contoh perulangan tadi berperilaku begitu: setiap callback memegang sebuah variabel, dan pertanyaannya adalah apakah variabel itu dipakai bersama atau satu per iterasi. Go punya masalah yang sama selama bertahun-tahun, dan tulisan di blog Go tahun 2023 mengumumkan rencana untuk “make these variables have per-iteration scope instead of per-loop scope” mulai Go 1.22. Di Go 1.24, kode ini sekarang mencetak tiap nilai satu kali:
var printers []func()
for i := 0; i < 3; i++ {
printers = append(printers, func() { fmt.Print(i, " ") })
}
for _, p := range printers {
p()
}
// 0 1 2
Kenapa ini penting sehari-hari
- Variabel global membuat bug jauh dari sumbernya. Saat variabel global berisi nilai yang salah, penyebabnya bisa di mana saja yang menulis ke sana. Simpan state sedekat mungkin dengan kode yang memakainya.
- Server berbagi state antar-request. List atau objek di level modul pada web server dipakai bersama oleh semua request dan semua pengguna. Sesuatu yang dimaksudkan untuk satu request bisa terlihat oleh request lain.
- Kode async membaca variabel belakangan. Callback, promise, dan goroutine berjalan setelah kode di sekitarnya sudah lanjut. Kalau yang dibaca sudah berubah, muncullah bug “nilai terakhir” seperti contoh
vardi atas. - Scope kecil, kode lebih mudah. Variabel yang dipakai di tiga baris gampang dipahami. Variabel yang dipakai di seluruh file memaksa kita membaca seluruh file.
Coba sendiri
- Jalankan contoh
incrementdi Python, baca error-nya, lalu perbaiki dengan dua cara: pakaiglobal, dan dengan mengopercountsebagai parameter lalu mengembalikan nilai barunya. Mana yang lebih mudah dites? - Di console browser, jalankan perulangan
var/let. Lalu gantivarmenjadiletdi perulangan pertama. - Buat array dengan
constdan panggil.push(). Lalu coba assign array baru ke sana. - Di Go, tulis blok
ifyang tanpa sengaja melakukan shadowing dengan:=, lalu perbaiki dengan=.
Ringkasan
- State adalah apa yang diingat program; makin banyak tempat yang bisa mengubahnya, makin sulit dipahami.
- Scope adalah tempat sebuah nama terlihat. Scope kecil berarti lebih sedikit kejutan.
- Python membuat variabel yang di-assign jadi lokal di fungsi; fungsi PHP sama sekali tidak bisa melihat variabel di luarnya. Pakai
global/nonlocalhanya kalau memang perlu. - Di JavaScript, utamakan
const, lalulet; hindarivar.constmengunci nama, bukan isi objek. - Go membatasi scope per blok, dan
:=di blok dalam membuat variabel baru yang menutupi variabel luar. - Closure adalah fungsi beserta variabel di sekitarnya; cara rapi untuk menjaga state tetap pribadi.
Referensi
- Python Scopes and Namespaces, tutorial Python.
- Programming FAQ: Why am I getting an UnboundLocalError when the variable has a value?, dokumentasi Python.
- let, var, const, dan Closures, MDN.
- The Go Programming Language Specification: Declarations and scope.
- David Chase dan Russ Cox, Fixing For Loops in Go 1.22, The Go Blog, September 2023.
- Variable scope, PHP Manual.