Türkiye Cumhuriyeti Kimlik Numaralarının (TCKN) biçimsel ve matematiksel geçerliliğini kontrol eden hafif bir kütüphane.

dogrula, Türkiye Cumhuriyeti Kimlik Numaralarının biçimsel ve matematiksel geçerliliğini ek bir kütüphane kullanmadan kontrol eder. Uzunluk, format, ilk hane ve kontrol basamakları (10. ve 11. haneler) denetlenir.

⚠️ Bu kütüphane sadece algoritmik kontroller uygular. Algoritmadan geçen sahte TCKN'ler üretilebilir. Resmi doğrulama için Nüfus ve Vatandaşlık İşlerine başvurulmalıdır.

İleride kütüphaneye vergi numarası, posta kodu, IBAN, telefon numarası gibi diğer numaraların da doğrulayıcıları eklenecektir.

• TCKN 11 basamaklı bir sayı olmalıdır
• TCKN tamamı aynı rakamdan oluşan bir sayı olmamalıdır (örn. 11111111111)
• TCKN 0 ile başlayamaz
• TCKN'nin 1, 3, 5, 7 ve 9. hanelerinin toplamının 7 katından 2, 4, 6, 8. hanelerin toplamı çıkarılıp sonucun birler basamağı alındığında TCKN'nin 10. basamağı bulunmalıdır
• TCKN'nin ilk 10 basamağının toplamının birler basamağı alındığında TCKN'nin 11. basamağı bulunmalıdır

• TypeScript desteği
• Türkçe ve İngilizce hata mesajları
• Ek kütüphane kullanımı yok

npm install dogrula

const { TCKN } = require("dogrula");

const tc = new TCKN("10000000146");

if (tc.isValid()) {
  console.log("TCKN geçerli");
} else {
  console.error("TCKN geçersiz!");
  console.log(tc.getErrors()); // ["TCKN 11 basamaklı olmalıdır", "TCKN doğrulama algoritması başarısız oldu", vb.]
}

import { TCKN, ValidationResult } from 'dogrula';

const tc: TCKN = new TCKN("10000000146");

if (tc.isValid()) {
    console.log("TCKN geçerli");
} else {
    console.error("TCKN geçersiz!");
    console.log(tc.getErrors()); // ["TCKN 11 basamaklı olmalıdır", "TCKN doğrulama algoritması başarısız oldu", vb.]
}

const { TCKN, setLocale, getLocale, ErrorCode } = require("dogrula");

const tc = new TCKN("10000000146");

console.log("Seçili dil: ", getLocale()); // Varsayılan olarak Türkçe seçilir

setLocale("en"); // Dili İngilizce yapar. Desteklenen değerler: 'tr', 'en'

if (tc.isValid()) {
    console.log("TCKN geçerli");
} else {
    console.error("TCKN geçersiz!");
    console.log(tc.getErrors()); // ["TCKN must be 11 digits", "TCKN validation algorithm failed", vb.]
}

Sorular, hata bildirimleri veya öneriler için bana ulaşabilirsiniz.

• Twitter: @yagiz_dev
• Eposta: hi@yagiz.dev

MIT © 2025 Yağızhan Burak Yakar