JavaScript nasıl çalışır

Discord botları çoğunlukla JavaScript ile yazılır. Bot yazmak için bilmen gereken her şey birkaç fikre dayanır: değer, fonksiyon, nesne, olay ve bekleme.

Dokümantasyon / Bot yazmayı öğren / JavaScript nasıl çalışır

  1. Değerler kutulara konur

    const ile bir değere isim verirsin: const isim = "Aegis".

  2. Fonksiyonlar iş yapar

    Bir fonksiyon girdi alır, bir şey yapar, sonuç döndürür.

  3. Bot olayları dinler

    Biri komut yazınca Discord bir olay gönderir, senin fonksiyonun çalışır.

JavaScript, satır satır yukarıdan aşağı okunan bir dildir. Bir Discord botu aslında bilgisayarında ya da bir sunucuda sürekli açık duran bir JavaScript programıdır. Node.js bu programı tarayıcı dışında çalıştırır; discord.js ise Discord ile konuşmayı kolaylaştıran bir kütüphanedir. Bu derste kodu okuyabilecek kadar JavaScript öğreneceksin.

Değerler ve değişkenler

Programdaki her şey bir değerdir: metin, sayı, doğru/yanlış. Bir değere isim vermek için const kullanırsın. Sonradan değişecekse let kullanırsın.

degerler.jsjavascript
const botAdi = "Aegis";        // metin (string)
const uyeSayisi = 425;          // sayı (number)
const korumaAcik = true;        // doğru/yanlış (boolean)

let uyari = 0;                  // let: değeri sonradan değişebilir
uyari = uyari + 1;

console.log(botAdi, uyeSayisi, korumaAcik, uyari);
// Ekrana yazar: Aegis 425 true 1

console.log terminale yazı basar; kodunun ne yaptığını görmenin en kolay yoludur.

  • // ile başlayan satırlar yorumdur, bilgisayar onları okumaz. Kendine not bırakmak için kullan.

Fonksiyonlar

Fonksiyon, bir işi paketleyip istediğin zaman çalıştırmanı sağlar. Parantez içindekiler girdidir, return sonucu geri verir.

fonksiyon.jsjavascript
function selamla(isim) {
  return "Merhaba, " + isim + "!";
}

// Aynı şeyin kısa yazımı (ok fonksiyonu):
const selamla2 = (isim) => `Merhaba, ${isim}!`;

console.log(selamla("Deniz"));   // Merhaba, Deniz!
console.log(selamla2("Mert"));   // Merhaba, Mert!

Ters tırnak (`) içinde ${...} yazarak metnin içine değer koyabilirsin.

Nesneler ve diziler

Nesne, ilgili değerleri bir arada tutar ve noktayla okunur. Dizi ise sıralı bir listedir. discord.js'teki her şey (üye, mesaj, kanal) birer nesnedir.

nesne.jsjavascript
const uye = {
  kullaniciAdi: "deniz_dev",
  roller: ["Üye", "Yetkili"],   // dizi
  bot: false,
};

console.log(uye.kullaniciAdi);        // deniz_dev
console.log(uye.roller[0]);           // Üye (sayım 0'dan başlar)
console.log(uye.roller.length);       // 2
console.log(uye.roller.includes("Yetkili")); // true

Koşullar

if ile "şu doğruysa bunu yap" dersin. === iki değerin aynı olup olmadığını kontrol eder; ! bir şeyi tersine çevirir.

kosul.jsjavascript
const mesaj = "discord.gg/bedava-nitro";

if (mesaj.includes("discord.gg/")) {
  console.log("Davet linki var, mesajı sil.");
} else if (mesaj.length > 2000) {
  console.log("Mesaj çok uzun.");
} else {
  console.log("Sorun yok.");
}

Olaylar

Bot kendi başına bir şey yapmaz; bir şey olmasını bekler. client.on("olay", fonksiyon) yazdığında "bu olay olunca bu fonksiyonu çalıştır" demiş olursun. Bu fonksiyona geri çağırma (callback) denir.

olay.jsjavascript
const { Client, Events, GatewayIntentBits } = require("discord.js");
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

// Bot Discord'a bağlanınca bir kez çalışır
client.once(Events.ClientReady, (c) => {
  console.log(`${c.user.tag} çevrimiçi!`);
});

// Biri slash komutu kullandıkça çalışır
client.on(Events.InteractionCreate, (interaction) => {
  console.log("Bir komut geldi:", interaction.commandName);
});

once yalnızca ilk seferde, on ise her seferinde çalışır.

Beklemek: async ve await

Discord'a mesaj göndermek internet üzerinden olur ve biraz zaman alır. Böyle işler bir Promise (söz) döndürür. Sonucu beklemek için fonksiyonun başına async, beklenen işin başına await yazarsın.

bekle.jsjavascript
client.on(Events.InteractionCreate, async (interaction) => {
  // await: Discord cevabı alana kadar bekle, sonra devam et
  await interaction.reply("Bir saniye...");
  await interaction.editReply("Tamam, hazır!");
});

await yalnızca async bir fonksiyonun içinde kullanılabilir.

  • Bir şey ters giderse await hata fırlatır. try { ... } catch (hata) { ... } ile yakalayıp botun çökmesini önleyebilirsin.

Hepsi bir arada: örnek komut

Şimdi öğrendiklerini birleştirelim. Bu kod /zar komutu gelince 1 ile 6 arasında rastgele bir sayı atar. Her satırı artık okuyabiliyorsun.

zar.jsjavascript
client.on(Events.InteractionCreate, async (interaction) => {
  // Slash komutu değilse (ör. düğme) hiçbir şey yapma
  if (!interaction.isChatInputCommand()) return;

  if (interaction.commandName === "zar") {
    const sayi = Math.floor(Math.random() * 6) + 1; // 1-6
    await interaction.reply(`Zar: **${sayi}**`);
  }
});

Math.random() 0 ile 1 arasında sayı verir; 6 ile çarpıp aşağı yuvarlayıp 1 eklersek 1-6 olur.

Sıradaki derste bu kodu gerçek bir bota dönüştüreceğiz.