Fungsi bernama onEdit adalah trigger sederhana. Setelah proyek disimpan, Sheets menjalankannya setiap kali seseorang mengedit sebuah sel, tanpa penyiapan apa pun. Fungsi ini menerima objek event, yang biasanya dinamai e:
- e.range adalah sel yang diedit. getSheet().getName(), getRow() dan getColumn() memberi tahu Anda letaknya.
- e.value adalah nilai baru dan e.oldValue nilai sebelumnya, keduanya sebagai teks. Kotak centang yang dicentang tiba sebagai "TRUE", bukan boolean true.
- e.source adalah spreadsheet, untuk menjangkau tab lain.
onEdit berjalan untuk setiap edit di seluruh file, jadi mulailah dengan guard clause: jika edit tidak berada di tab, kolom, atau baris yang tepat, lakukan return sebelum melakukan apa pun. Tanpa guard clause, perubahan pada header atau edit di tab lain juga akan memicu kode Anda.
Trigger sederhana tidak dapat melakukan hal yang memerlukan izin Anda, seperti mengirim email; untuk itu diperlukan trigger yang dapat diinstal, di pelajaran berikutnya. Pada salinan latihan ini, edit yang Anda lakukan di grid menjalankan onEdit yang sudah Anda simpan, dan pemeriksa memutar serangkaian edit melaluinya.
Guard clause dulu, baru pekerjaan untuk satu-satunya edit yang penting.