# arkweb_error_code.h

> phone 12+ | 2in1 13+ | tablet 12+ | tv 19+ | wearable 18+

## 概述

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

**引用文件：** <web/arkweb_error_code.h>

**库：** libohweb.so

**系统能力：** SystemCapability.Web.Webview.Core

**起始版本：** 12

**相关模块：** [Web](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-web)

## 汇总

### 枚举

|名称|typedef关键字|描述|
|:------------------------------------------------------|:------------------------|:----------------------------------|
|[ArkWeb_ErrorCode](#arkweb_errorcode)|ArkWeb_ErrorCode|表示ArkWeb NDK接口操作的结果状态，用于判断接口调用是否成功。|
|[ArkWeb_BlanklessErrorCode](#arkweb_blanklesserrorcode)|ArkWeb_BlanklessErrorCode|表示无白屏加载功能操作的结果状态，用于判断无白屏加载接口调用是否成功。|

## 枚举类型说明

### ArkWeb_ErrorCode

```c
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|

### ArkWeb_BlanklessErrorCode

```c
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|该设备不适用于此功能。|