Uygulama yapısı

Hata Yönetimi

Fırlatılan, raporlanan ve uyarı olarak yazılan hataların ayrımı; MotifError, errorHandler, setUnexpectedErrorHandler ve safeCall yardımcıları.

MotifJS kullanıcı kodundan gelen hatayı yutmaz, ama uygulamayı da düşürmez. Çerçevenin fırlattığı, raporladığı ya da uyarı olarak yazdığı her durumun bir MJX kodu vardır ve bu durumlar üç yoldan birine girer. Bu bölüm o yolları, hataları dinleme noktalarını ve çerçevenin kendi hata-güvenli çağrı yardımcılarını anlatır. Kodların tam listesi Hata ve Uyarı Kodları tablosundadır.

Üç yol

MotifError

Çerçevenin fırlattığı ve raporladığı her hata MotifError'dur:

import { MotifError } from "@motifx/core";

try {
  await app.navigateByName("note", { id: note.id });
} catch (e) {
  if (e instanceof MotifError && e.code === 'MJX302') { /* adlandırılmış rota bulunamadı */ }
}

import { MotifError } from "@motifx/core";

try {
  await app.navigateByName("note", { id: note.id });
} catch (e) {
  if (e instanceof MotifError && e.code === 'MJX302') { /* adlandırılmış rota bulunamadı */ }
}

MotifErrorCode tipi bütün kodların birleşimidir; switch (e.code) yazarken tamamlama sağlar.

Raporları dinleme — errorHandler

import { errorHandler } from "@motifx/core";

const off = errorHandler.addListener((error) => {
  navigator.sendBeacon("/api/errors", JSON.stringify({ code: error.code, message: error.message, cause: String(error.cause) }));
});

import { errorHandler } from "@motifx/core";

const off = errorHandler.addListener((error) => {
  navigator.sendBeacon("/api/errors", JSON.stringify({ code: error.code, message: error.message, cause: String(error.cause) }));
});

• Dinleyici raporlanan her MotifError'u alır (MJX122, MJX123, MJX208, MJX306 …). setUnexpectedErrorHandler'a giden kodsuz hatalar da (aşağıda) dinleyicilere olduğu gibi ulaşır.
• Fırlatılan hatalar dinleyiciye gitmez (zaten çağırana döner); uyarılar da gitmez.
• Dinleyici hiçbir bileşene bağlı değildir; addListener'ın döndürdüğü fonksiyonla (off()) kaldırılır.
• Dinleyiciler eklendikleri sırayla çağrılır. Bir dinleyicinin fırlattığı hata diğer dinleyicileri ve raporu yapan akışı durdurmaz; hata setTimeout(…, 0) ile yeniden fırlatılır ve tarayıcıda window.onerror düzeyinde görünür. safeCall bu durumda da yedek değeri döndürür.
• errorHandler.report(err) ile kendi hatanızı aynı yola sokabilirsiniz; err bir Error olmalıdır, MotifError olması gerekmez.

ErrorHandler sınıfının diğer üyeleri: setDevelopmentMode(b) / isDevelopment() (app.useDevelopment bunu kullanır), setConsoleLogging(b) (app.useLogging), reportSuppressed(context, err) (yalnız geliştirme modunda konsola yazar, dinleyicilere gitmez; çerçeve kendi içinde yuttuğu hatalar için kullanır), getUnexpectedErrorHandler().

Beklenmeyen hatalar — setUnexpectedErrorHandler

safeCall/safeCallAsync içinde yakalanan ve Emitter dinleyicilerinin fırlattığı hatalar kodsuzdur; bunlar errorHandler.onUnexpectedError(err) yoluna girer:

1. setUnexpectedErrorHandler(fn) ile verilen işleyici çağrılır. Varsayılan işleyici hatayı setTimeout(…, 0) ile yeniden fırlatır: tarayıcıda window.onerror/unhandledrejection düzeyinde görünür, çağıran akış kesilmez.
2. Ardından addListener dinleyicileri hatayı olduğu gibi alır.

import { setUnexpectedErrorHandler } from "@motifx/core";

setUnexpectedErrorHandler((error) => navigator.sendBeacon("/api/errors", String(error)));   // yeniden fırlatmak yerine sunucuya gönder

import { setUnexpectedErrorHandler } from "@motifx/core";

setUnexpectedErrorHandler((error) => navigator.sendBeacon("/api/errors", String(error)));   // yeniden fırlatmak yerine sunucuya gönder

Kodlu raporlar (MJX122 …) bu işleyiciye gitmez; onlar için addListener kullanın.

Hata-güvenli çağrı yardımcıları

Çerçevenin kendi kodunu sarmak için kullandığı yardımcılar dışa açıktır:

context yalnız günlükte görünen serbest bir etikettir.

Kullanıcı kodunda hata nerede yakalanır?

Geliştirme ve üretim

app.useLogging(false) yalnız konsol çıktısını kapatır; dinleyiciler çalışmaya devam eder.

Sonraki adım

Ağ ve dış kaynak çağrılarını yeniden deneme, zaman aşımı ve devre kesiciyle sarmak için Dayanıklılık.