目录

arkweb_error_code.h

概述

声明ArkWeb NDK接口异常错误码,用于在ArkWeb相关接口调用失败时返回具体的错误信息,帮助开发者快速定位和解决问题。这些错误码覆盖了初始化、参数校验、URL处理、Cookie管理、库加载等常见异常场景。

引用文件: <web/arkweb_error_code.h>

库: libohweb.so

系统能力: SystemCapability.Web.Webview.Core

起始版本: 12

相关模块: Web

汇总

[h2]枚举

名称 typedef关键字 描述
ArkWeb_ErrorCode ArkWeb_ErrorCode 表示ArkWeb NDK接口操作的结果状态,用于判断接口调用是否成功。
ArkWeb_BlanklessErrorCode ArkWeb_BlanklessErrorCode 表示无白屏加载功能操作的结果状态,用于判断无白屏加载接口调用是否成功。

枚举类型说明

[h2]ArkWeb_ErrorCode

enum ArkWeb_ErrorCode

描述:

定义ArkWeb NDK接口异常错误码。

起始版本: 12

枚举项 描述
ARKWEB_SUCCESS = 0 成功。
ARKWEB_INIT_ERROR = 17100001 初始化失败。请检查系统环境,确保依赖库已安装,重试初始化。
ARKWEB_ERROR_UNKNOWN = 17100100 未知错误,请收集日志反馈。
ARKWEB_INVALID_PARAM = 17100101 参数无效。请检查传入参数的格式、范围和类型是否符合接口要求。
ARKWEB_SCHEME_REGISTER_FAILED = 17100102 注册scheme的配置失败,应该在创建ArkWeb之前注册。
ARKWEB_INVALID_URL = 17100103 无效的URL,请检查URL格式或协议支持。
ARKWEB_INVALID_COOKIE_VALUE = 17100104 无效的cookie值,请检查cookie格式与有效性。
ARKWEB_LIBRARY_OPEN_FAILURE = 17100105

打开动态链接库失败。请检查动态链接库文件是否存在、路径是否正确、以及是否有读取权限。

起始版本: 15

ARKWEB_LIBRARY_SYMBOL_NOT_FOUND = 17100106

动态链接库中找不到所需的符号。

起始版本: 15

ARKWEB_COOKIE_MANAGER_NOT_INITIALIZED = 17100107

CookieManager未初始化。请先调用初始化接口完成CookieManager的初始化。

起始版本: 20

ARKWEB_COOKIE_MANAGER_INITIALIZE_FAILED = 17100108

CookieManager初始化失败,请检查系统能力与权限配置。

起始版本: 20

ARKWEB_COOKIE_SAVE_FAILED = 17100109

保存cookie失败。请检查存储空间是否充足、是否有写入权限,以及cookie值是否符合规范。

起始版本: 20

[h2]ArkWeb_BlanklessErrorCode

enum ArkWeb_BlanklessErrorCode

描述:

定义无白屏加载的异常错误码。

起始版本: 20

枚举项 描述
ARKWEB_BLANKLESS_SUCCESS = 0 成功。
ARKWEB_BLANKLESS_ERR_UNKNOWN = -1 未知错误,内部状态错误等。
ARKWEB_BLANKLESS_ERR_INVALID_ARGS = -2 参数不合法。
ARKWEB_BLANKLESS_ERR_CONTROLLER_NOT_INITED = -3 WebViewController未绑定组件。
ARKWEB_BLANKLESS_ERR_KEY_NOT_MATCH = -4 未匹配到key值,对于OH_NativeArkWeb_SetBlanklessLoadingWithKey需与OH_NativeArkWeb_GetBlanklessInfoWithKey配套使用并且key值一致,否则返回该错误码。
ARKWEB_BLANKLESS_ERR_SIGNIFICANT_CHANGE = -5 当相似度较低时,系统会判定为跳变太大,OH_NativeArkWeb_SetBlanklessLoadingWithKey接口启用插帧不成功。
ARKWEB_BLANKLESS_ERR_DEVICE_NOT_SUPPORT = 801 该设备不适用于此功能。