TypeScript
Sınıflar
Fonksiyonlar
Lisans: Belirtilmemis
TypeScript — SymbolTable Sınıfı (SymbolTable.ts)
Orijinal Kod Adı:
TypeScript — SymbolTable.ts
Bu TypeScript kodu (`SymbolTable.ts`), modüler iş mantığını ve yardımcı rutinleri uygular. Dosya ölçeği: 40 satır (~1.1 KB). Tanımlı sınıf/yapılar: SymbolTable. Kullandığı modül/paketler: type, {. Kaynak depo: dejawu/ectype.
💡 Püf Noktaları:
• Kullanıcı veya API metinlerini DOM'a eklerken `innerHTML` yerine `textContent` kullanarak istemci taraflı XSS açıklarını engelleyin.
• Klavye girişi veya kaydırma gibi sık tetiklenen olaylarda `debounce` ekleyerek gereksiz ağ isteklerini azaltın.
• `SymbolTable.ts` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• TypeScript kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. Dosyayı proje `src/` veya `assets/js/` dizinine ekleyip gerekli ise tip/paket bağımlılıklarını (`npm install`) kurun.
2. Modülü `<script>` veya ES `import` ile sayfaya bağlayın.
3. Tarayıcı Geliştirici Araçları > Console ve Network sekmelerinden DOM güncellemeleri ile API yanıtlarını doğrulayın.
💡 Püf Noktaları:
• Kullanıcı veya API metinlerini DOM'a eklerken `innerHTML` yerine `textContent` kullanarak istemci taraflı XSS açıklarını engelleyin.
• Klavye girişi veya kaydırma gibi sık tetiklenen olaylarda `debounce` ekleyerek gereksiz ağ isteklerini azaltın.
• `SymbolTable.ts` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• TypeScript kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. Dosyayı proje `src/` veya `assets/js/` dizinine ekleyip gerekli ise tip/paket bağımlılıklarını (`npm install`) kurun.
2. Modülü `<script>` veya ES `import` ile sayfaya bağlayın.
3. Tarayıcı Geliştirici Araçları > Console ve Network sekmelerinden DOM güncellemeleri ile API yanıtlarını doğrulayın.
Dikkat Edilmesi Gerekenler:
• [Lisans & Telif] Kaynak kodun lisans türü net değildir (Sınırlı Önizleme); ticari projede veya dağıtımda kaynak depo telif koşullarını mutlaka doğrulayın.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
• [Lisans & Telif] Kaynak kodun lisans türü net değildir (Sınırlı Önizleme); ticari projede veya dağıtımda kaynak depo telif koşullarını mutlaka doğrulayın.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
Sınırlı Önizleme Politikası: Bu kodun açık kaynak lisansı doğrulanamadığı için telif kuralları gereği yalnızca kısa önizlemesi gösterilmektedir. Tam kod için
orijinal kaynağa gidin ↗.
import type { Type } from "../../core/core";
import { ErrorType } from "../../core/internal.js";
export class SymbolTable {
parent: SymbolTable | null;
values: Record<string, Type>;
// Used to store the return type seen while visiting a function.
functionScope:
| { kind: "none" } // Not a function scope.
| { kind: "inferred"; returns: Type | null } // A function scope where a return type needs to be inferred.
| { kind: "expected"; returns: Type }; // A function scope where a return type is expected and should be checked against.
constructor(
parent: SymbolTable | null,
returnType: SymbolTable["functionScope"] = { kind: "none" },
) {
this.parent = parent;
this.values = {};
this.functionScope = returnType;
}
get(name: string): Type {
if (name in this.values) {
return this.values[name];
} else if (this.parent !== null) {
return this.parent.get(name);
} else {
return ErrorType;
}
}
set(name: string, type: Type) {
if (name in this.values) {
throw new Error(`${name} is already defined in this immediate scope.`);
}