#LynxError API

LynxError 是 Lynx 运行时返回的标准错误对象，用于表示应用运行时的失败、警告或可恢复问题。

它同时包含机器可读的信息（错误码、子错误码、严重级别）和人类可读的信息（错误消息），方便调试与错误处理。

#使用场景

• 在调试或开发模式下显示有意义的错误信息
• 当出现致命错误时触发回退界面或导航逻辑
• 将错误上报到分析或错误追踪系统中

#核心概念

#错误码（Error Code）

错误码是一个 3–4 位数字，用于表示错误的行为或类型。 例如，代码 301 表示图像加载错误。

可参考 错误码文档了解每个错误码的具体含义。

#子错误码（Sub Code）

子错误码是一个 5–6 位数字，由错误码扩展而来，用于标识错误的具体原因。 例如，子错误码 30101 表示加载的图像过大。

可参考 错误码文档了解每个子错误码所代表的具体原因。

#级别（Level）

LynxError 定义了四种错误级别：Fatal、Error、Warn 和 Undecided。

#消息（Message）

所有错误信息以 JSON 字符串的形式表示，包括以下内容：

• code（错误码）
• subcode（子错误码）
• level（错误级别）
• message（错误消息）
• suggestion（修复建议，可选）

#各平台方法

#Android

#iOS

#HarmonyOS

#示例

#JavaScript

lynx.onError = (error) => {
  const detail = JSON.parse(error.message);
  if (detail.level === 'Fatal') {
    // Possibly reload or fallback to home
    console.error('Critical error occurred:', detail.message);
  }
};

#Kotlin

fun onLynxError(error: LynxError) {
  if (error.level == "Fatal") {
    println("Fatal error: ${error.msg}")
  }
}

#Swift

func onLynxError(_ error: LynxError) {
  if error.level == "Fatal" {
    print("Fatal error: \(error.msg)")
  }
}

#ETS

onLynxError(error: LynxError) {
  if (error.level == LynxErrorLevel.Fatal) {
    console.error('Fatal error:', error.getMsg());
  }
}

#兼容性