For AI agents: the complete documentation index is available at /next/llms.txt, the full documentation bundle is available at /next/llms-full.txt, and this page is available as Markdown at /next/api/errors/error-code.md.
Lynx
  • English
  • Error Codes

    Error CodeDescription
    102Error occurred while loading app bundle
    105Error occurred while reloading app bundle
    201Error occurred while executing background thread script
    202Error occurred while calling JS function from platform
    301Error occurred while loading image resource
    302Error occurred while loading font resource
    303Error occurred while loading external resource
    304Error occurred while loading i18n resource
    321Error occurred while invoking LynxResourceModule
    398Custom error for resource
    399Exception occurred while loading resource
    401Error occurred while updating data
    501Error occurred while invoking Element API
    502Error occurred while updating element
    601Internal layout error
    602Performance issues related to layout
    603Failed to update layout
    604Invalid usage or exceptions on ShadowNode
    901Common errors for invoking native modules
    998Error occurred in custom native modules
    999Exception occurred while invoking the native module
    1099Exception occurred while handling event
    1101Error occurred while executing Main thread script
    1111Error occurred while executing renderer function
    1202Running on the wrong thread
    1301Generic CSS error
    1302Error while manipulating ComputedCSSValue
    1303Error occurred while parsing CSS
    1601Failed to load a lazy bundle
    1901Error for main thread script call exception in worklet
    1902Error for requestAnimationFrame call exception
    1903Error for worklet module exception
    2001Error occurred while calling MTSBridge module
    2201Error occurred while invoking component API
    2202Error from List component
    2203Error from Image component
    2298Custom error of components
    9901Platform exceptions
    9902Exceptions encountered while calling Java native interface

    102: EB_APP_BUNDLE_LOAD

    10201: E_APP_BUNDLE_LOAD_RENDER_FAILED Fatal

    Description: Failed to render app bundle FixSuggestion: Should not call loadTemplate while the rendering pipeline of app bundle has not finished

    10202: E_APP_BUNDLE_LOAD_ENV_NOT_READY Fatal

    Description: loadTemplate while LynxEnv has not been initialized FixSuggestion: Please call the initialization method of LynxEnv before loadTemplate

    10203: E_APP_BUNDLE_LOAD_BAD_RESPONSE Fatal

    Description: Failed to fetch app bundle by provider FixSuggestion: Please check if the app bundle is available

    10204: E_APP_BUNDLE_LOAD_PARSE_FAILED Fatal

    Description: Failed to parse app bundle FixSuggestion: Please check that 1. the provided bundle is an app bundle, 2. the engine version of the bundle is compatible with that of Lynx engine, 3. the bundle file is not broken

    10205: E_APP_BUNDLE_LOAD_BAD_BUNDLE Fatal

    Description: A bad TemplateBundle is provided FixSuggestion: Please check the error message of the bundle

    10299: E_APP_BUNDLE_LOAD_EXCEPTION Fatal

    Description: Exception occurred while rendering app bundle

    105: EB_APP_BUNDLE_RELOAD

    10501: E_APP_BUNDLE_RELOAD_EARLY_RELOAD Error

    Description: reloadTemplate before loadTemplate FixSuggestion: Please loadTemplate before reloadTemplate

    201: EB_BTS_RUNTIME_ERROR

    20100: E_BTS_RUNTIME_ERROR Undecided

    Description: Runtime error for an unspecified reason

    20101: E_BTS_RUNTIME_ERROR_SCRIPT_ERROR Fatal

    Description: The script has syntax errors or other runtime errors FixSuggestion: Please check the error message and fix the script

    20102: E_BTS_RUNTIME_ERROR_BYTECODE_SCRIPT_ERROR Fatal

    Description: The bytecode script has syntax errors or other runtime errors FixSuggestion: Please check the error message and fix the script

    20103: E_BTS_RUNTIME_ERROR_BINDINGS_ERROR Error

    Description: JavaScript binding API call errors FixSuggestion: Please check the error message and fix binding API call

    202: EB_BTS_PLATFORM_CALL_JS_FUNCTION

    20201: E_BTS_PLATFORM_CALL_JS_FUNCTION_TOO_FREQUENCY Warn

    Description: Calling JS function too frequently. This may cause OOM issues FixSuggestion: Please throttle related calls

    301: EB_RESOURCE_IMAGE

    30101: E_RESOURCE_IMAGE_BIG_IMAGE Error

    Description: The image bitmap size is too large relative to the UI. FixSuggestion: Please resize the image to appropriate dimensions or enable downsampling

    30102: E_RESOURCE_IMAGE_PIC_SOURCE Error

    Description: Error occurred while decoding image FixSuggestion: Possibly due to an unsupported image format or a corrupted file. Please verify the integrity of the image file

    30103: E_RESOURCE_IMAGE_FROM_USER_OR_DESIGN Error

    Description: Error from user actions or the network conditions FixSuggestion: In most cases, the issue arises from a canceled image request or an unavailable network connection

    30196: E_RESOURCE_IMAGE_FROM_NETWORK_OR_OTHERS Error

    Description: Network or other issues FixSuggestion: Please investigate the corresponding image download workflow for potential issues

    30199: E_RESOURCE_IMAGE_EXCEPTION Error

    Description: Exception occurred while loading image FixSuggestion: An unidentified exception occurred that cannot be attributed to a specific cause. Please investigate further based on the available details

    302: EB_RESOURCE_FONT

    30200: E_RESOURCE_FONT Error

    Description: Failed to process font resource

    30201: E_RESOURCE_FONT_SRC_FORMAT_ERROR Error

    Description: Font src format error FixSuggestion: Please check the font-face format

    30202: E_RESOURCE_FONT_RESOURCE_LOAD_ERROR Error

    Description: Failed to load font resource FixSuggestion: Please check whether font resource is available

    30203: E_RESOURCE_FONT_BASE64_PARSING_ERROR Error

    Description: Failed to parse base64 resource FixSuggestion: Please check whether the base64 resource is available

    30204: E_RESOURCE_FONT_FILE_FORMAT_NOT_SUPPORTED Error

    Description: Font file format is not supported FixSuggestion: Please use a font file in ttf or otf format

    30205: E_RESOURCE_FONT_REGISTER_FAILED Undecided

    Description: Failed to register font FixSuggestion: If the font is displayed correctly, there is no need to deal with it

    303: EB_RESOURCE_EXTERNAL_RESOURCE

    30301: E_RESOURCE_EXTERNAL_RESOURCE_REQUEST_FAILED Error

    Description: Lynx resource fetcher requests failed FixSuggestion: Please check whether the url of the external resource is available

    30302: E_RESOURCE_EXTERNAL_RESOURCE_LOCAL_RESOURCE_LOAD_FAIL Error

    Description: Failed to load local resource FixSuggestion: Please check whether the local external resource is available

    304: EB_RESOURCE_I18N

    30400: E_RESOURCE_I18N Error

    Description: i18n Resource Error

    321: EB_RESOURCE_MODULE

    32101: E_RESOURCE_MODULE_PARAMS_ERROR Error

    Description: Parameter type mismatch or incorrect number of parameters while calling the requestResourcePrefetch or cancelResourcePrefetch API FixSuggestion: Please refer to the parameter descriptions of this API in documentation and check the parameters used in the call

    32102: E_RESOURCE_MODULE_IMG_PREFETCH_HELPER_NOT_EXIST Error

    Description: Unable to access the image service because the app has not integrated LynxImageService FixSuggestion: Please refer to the official documentation to integrate LynxImageService into your app

    32103: E_RESOURCE_MODULE_RESOURCE_SERVICE_NOT_EXIST Error

    Description: Unable to access resources because the app has not integrated the resource service FixSuggestion: Please refer to the official documentation to implement the ILynxResourceService and integrate it into your app

    398: EB_RESOURCE_CUSTOM

    39800: E_RESOURCE_CUSTOM Error

    Description: Unexpected custom error FixSuggestion: This is unexpected. Please file an issue to Lynx to help address it

    399: EB_RESOURCE_EXCEPTION

    39900: E_RESOURCE_EXCEPTION Error

    Description: Unexpect exception in loading resource FixSuggestion: This is unexpected. Please file an issue to Lynx to help address it

    401: EB_DATA_FLOW_UPDATE

    40101: E_DATA_FLOW_UPDATE_INVALID_PROCESSOR Error

    Description: Call built-in function as data processor FixSuggestion: Should not call getDerivedStateFromProps, getDerivedStateFromError, shouldComponentUpdate as data processor

    40102: E_DATA_FLOW_UPDATE_INVALID_TYPE Error

    Description: Invalid data type FixSuggestion: Target string data should be enabled to be parsed into a table

    40199: E_DATA_FLOW_UPDATE_EXCEPTION Error

    Description: Exception occurred while updating data

    501: EB_ELEMENT_API

    50101: E_ELEMENT_API_FATAL Fatal

    Description: Fatal error in element API. Please find detailed information in the context

    50102: E_ELEMENT_API_ERROR Error

    Description: Error in element API. Please find detailed information in the context

    502: EB_ELEMENT_UPDATE

    50201: E_ELEMENT_UPDATE_NODE_IS_NULL Fatal

    Description: Element update error for an unspecified reason

    601: EB_LAYOUT_INTERNAL

    60100: E_LAYOUT_INTERNAL Error

    Description: Cannot find ShadowNode FixSuggestion: Lynx internal error. Please check whether the creating of corresponding ShadowNode failed

    602: EB_LAYOUT_PERF

    60201: E_LAYOUT_PERF_INFINITE_LOOP Error

    Description: Infinite Loop of layout is detected FixSuggestion: Infinite loop of layout happens. It usually happens when the front-end decides the content size based on the viewport size, while the client is deciding the viewport size based on the content size

    603: EB_LAYOUT_UPDATE

    60301: E_LAYOUT_UPDATE_UI_NOT_FOUND Error

    Description: Can not find UI while updating layout FixSuggestion: This is an internal error of Lynx. LynxUI has not been created or the creation failed while updating

    604: EB_LAYOUT_PLATFORM

    60401: E_LAYOUT_PLATFORM_NODE_NULL Error

    Description: ShadowNode is accessed after destroyed FixSuggestion: This is an internal error of Lynx, which usually occurs when multiple threads access ShadowNode at the same time

    901: EB_NATIVE_MODULES_COMMON

    90101: E_NATIVE_MODULES_COMMON_MODULE_NOT_FOUND Error

    Description: Native module not found FixSuggestion: Please verify that the invoked native module name matches the registered name and confirm module registration status

    90102: E_NATIVE_MODULES_COMMON_FUNCTION_NOT_FOUND Error

    Description: Native module method not found FixSuggestion: Please verify proper method registration using platform-specific annotations on Android or static method declarations on iOS (For details, refer to the native module documentation). Additionally, ensure that the invoked method name exactly matches the registered name in the native module implementation

    90103: E_NATIVE_MODULES_COMMON_WRONG_PARAM_NUM Error

    Description: Parameter count mismatch in native module method invocation FixSuggestion: Please ensure that the number of parameters passed to the native method exactly matches the declared parameters in the native module implementation

    90104: E_NATIVE_MODULES_COMMON_WRONG_PARAM_TYPE Error

    Description: Parameter type mismatch in native module method invocation FixSuggestion: Please verify that the parameter types in the method call exactly match the native module implementation. Ensure type compatibility across all parameters and validate the parameter order corresponds to the native method signature. You can check the native module documentation for expected data types

    90105: E_NATIVE_MODULES_COMMON_AUTHORIZATION_ERROR Error

    Description: Does not have permission to call the method FixSuggestion: Please file an issue to Lynx to help address it

    90106: E_NATIVE_MODULES_COMMON_SYSTEM_AUTHORIZATION_ERROR Error

    Description: Does not have permission to call the method FixSuggestion: Please file an issue to Lynx to help address it

    90107: E_NATIVE_MODULES_COMMON_RETURN_ERROR Error

    Description: The value returned by module method is invalid FixSuggestion: Please file an issue to Lynx to help address it

    998: EB_NATIVE_MODULES_CUSTOM_ERROR

    99800: E_NATIVE_MODULES_CUSTOM_ERROR Error

    Description: Custom error reported from native module FixSuggestion: This error is explicitly defined by the native module implementation. Please refer to the module error handling guide or contact the module maintainer with complete error context

    999: EB_NATIVE_MODULES_EXCEPTION

    99900: E_NATIVE_MODULES_EXCEPTION Error

    Description: Internal exception in native module method execution FixSuggestion: This error indicates an unhandled runtime exception within the native module implementation. Please refer to the module error handling guide or contact the module maintainer with complete error context

    1099: EB_EVENT_EXCEPTION

    109900: E_EVENT_EXCEPTION Error

    Description: An exception occurred during LynxView dispatchTouchEvent FixSuggestion: This error is caught by the Lynx Engine. Please file an issue to Lynx to help address it

    1101: EB_MTS_RUNTIME_ERROR

    110100: E_MTS_RUNTIME_ERROR Undecided

    Description: Main thread script error for an unspecified reason

    1111: EB_MTS_RENDERER_FUNCTION

    111101: E_MTS_RENDERER_FUNCTION_FATAL Fatal

    Description: Fatal error during rendering. Please find detailed information in the context

    111102: E_MTS_RENDERER_FUNCTION_ERROR Error

    Description: Fatal error during rendering. Please find detailed information in the context

    1202: EB_THREAD_WRONG_THREAD

    120201: E_THREAD_WRONG_THREAD_DESTROY_ERROR Error

    Description: Please ensure that destroy is called on UI thread

    120202: E_THREAD_WRONG_THREAD_SYNC_FLUSH_ERROR Error

    Description: Please ensure that SyncFlush is called on UI thread

    1301: EB_CSS

    130100: E_CSS Undecided

    Description: CSS error for an unspecified reason

    130101: E_CSS_UNKNOWN_PROPERTY Undecided

    Description: Unknown CSS property id

    130102: E_CSS_UNSUPPORTED_VALUE Undecided

    Description: Unsupported CSS value FixSuggestion: Please check your value for the property follow the detailed message

    1302: EB_CSS_COMPUTED_CSS_VALUE

    130201: E_CSS_COMPUTED_CSS_VALUE_UNKNOWN_SETTER Error

    Description: Error occurred while setting value to ComputedCSSValue FixSuggestion: Ignore it or raise an issue on github to let us know. This error is unexpected, which might be caused by internal pipeline fault

    130202: E_CSS_COMPUTED_CSS_VALUE_UNKNOWN_GETTER Error

    Description: Error occurred while getting value from ComputedCSSValue FixSuggestion: Ignore it or raise an issue on github to let us know. This error is unexpected, which might be caused by internal pipeline fault

    130203: E_CSS_COMPUTED_CSS_VALUE_UNSUPPORTED_INHERITANCE Error

    Description: Property is not inheritable FixSuggestion: Remove property name from inheritance list

    1303: EB_CSS_PARSER

    130300: E_CSS_PARSER Error

    Description: Generic error while parsing CSS value. Value is not acceptable for the property FixSuggestion: Please use values following the property definitions. You can get the definitions at the official website

    1601: EB_LAZY_BUNDLE_LOAD

    160101: E_LAZY_BUNDLE_LOAD_BAD_RESPONSE Error

    Description: Lazy bundle request returned with bad response FixSuggestion: Please check whether the url of the lazy bundle is available

    160102: E_LAZY_BUNDLE_LOAD_EMPTY_FILE Error

    Description: The binary data of lazy bundle is empty FixSuggestion: Please check whether the lazy bundle file is empty

    160103: E_LAZY_BUNDLE_LOAD_DECODE_FAILED Error

    Description: Failed to decode lazy bundle binary data FixSuggestion: Please check whether the lazy bundle file is broken or it is compatible with the host page

    160104: E_LAZY_BUNDLE_LOAD_BAD_BUNDLE Error

    Description: A bad lazy bundle is provided FixSuggestion: Please check the error message of the bundle

    1901: EB_WORKLET_MTS_CALL_EXCEPTION

    190100: E_WORKLET_MTS_CALL_EXCEPTION Error

    Description: Please check the worklet function is callable, and the worklet file is imported correctly

    1902: EB_WORKLET_RAF_CALL_EXCEPTION

    190200: E_WORKLET_RAF_CALL_EXCEPTION Error

    Description: Error for calling requestAnimationFrame FixSuggestion: Calling requestAnimationFrame failed. This is usually caused by an error in the callback function. Please ensure that the callback function executes without errors

    1903: EB_WORKLET_MODULE_EXCEPTION

    190300: E_WORKLET_MODULE_EXCEPTION Error

    Description: Can not find worklet module FixSuggestion: Make sure you have imported worklet file correctly

    2001: EB_MTS_BRIDGE_MODULE

    200101: E_MTS_BRIDGE_MODULE_WRONG_PARAM Error

    Description: Invoke function with wrong parameter

    2201: EB_COMPONENT_API

    220101: E_COMPONENT_API_DEPRECATED Error

    Description: A deprecated component API is invoked

    2202: EB_COMPONENT_LIST

    220201: E_COMPONENT_LIST_ILLEGAL_ITEM_KEY Error

    Description: Error for illegal list item-key FixSuggestion: Please check the legality of the item-key

    220202: E_COMPONENT_LIST_DUPLICATED_CELL Error

    Description: List has duplicated cell in cache FixSuggestion: We have encountered a system-level error. Please file an issue to Lynx to help resolve this problem

    220203: E_COMPONENT_LIST_CELL_NOT_FOUND Error

    Description: List cell not found in cache FixSuggestion: We have encountered a system-level error. Please file an issue to Lynx to help resolve this problem

    220204: E_COMPONENT_LIST_DYNAMIC_CHANGE_ORIENTATION Error

    Description: List does not support changing orientation dynamically FixSuggestion: Please do not change the value of vertical-orientation dynamically

    220205: E_COMPONENT_LIST_INVALID_PROPS_ARG Error

    Description: There is an invalid parameter set in some props FixSuggestion: For parameter usage, please check documentation of list component

    220206: E_COMPONENT_LIST_CHILD_COMPONENT_NOT_EXIST Error

    Description: Child component of list does not exist FixSuggestion: The internal state of the engine has become inconsistent. Please file an issue to Lynx for help resolving this problem

    220207: E_COMPONENT_LIST_UNSUPPORTED_THREAD_STRATEGY Error

    Description: Multi thread strategy can not be used by default FixSuggestion: Please set the attribute enable-async-list of to true

    220208: E_COMPONENT_LIST_DUPLICATE_ITEM_KEY Error

    Description: Error for duplicate list item-key FixSuggestion: Please check the legality of the item-key

    2203: EB_COMPONENT_IMAGE

    220301: E_COMPONENT_IMAGE_UNSUPPORTED_PROP Error

    Description: Failed to apply blur-radius on <image> element, meaning that the effect will not be visible on this platform FixSuggestion: This may be due to platform-specific limitations or system restrictions. If blur-radius is not supported on this platform, consider using CSS filter: blur() as an alternative

    2298: EB_COMPONENT_CUSTOM

    229800: E_COMPONENT_CUSTOM Error

    Description: An error occurs in an customized element

    9901: EB_EXCEPTION_PLATFORM

    990100: E_EXCEPTION_PLATFORM Error

    Description: Platform exceptions for an unspecified reason FixSuggestion: This error is caught by Lynx engine. Please file an issue to Lynx for help

    9902: EB_EXCEPTION_JNI

    990200: E_EXCEPTION_JNI Error

    Description: JNI exceptions for an unspecified reason FixSuggestion: This error is caught by Lynx engine. Please file an issue to Lynx for help

    Except as otherwise noted, this work is licensed under a Creative Commons Attribution 4.0 International License, and code samples are licensed under the Apache License 2.0.