1# Web 2 3 4## 概述 5 6为ArkWeb NDK接口发生异常提供错误码。 7 8提供注入对象和执行JavaScript代码的API接口。 9 10提供用于拦截ArkWeb请求的API。 11 12为ArkWeb网络协议栈提供错误码。 13 14提供ArkWeb在Native侧的能力，如网页刷新、执行JavaScript、注册回调等。 15 16**起始版本：** 12 17 18 19## 汇总 20 21 22### 文件 23 24| 名称 | 描述 | 25| -------- | -------- | 26| [arkweb_error_code.h](arkweb__error__code_8h.md) | 声明ArkWeb NDK接口异常错误码。 | 27| [arkweb_interface.h](arkweb__interface_8h.md) | 提供ArkWeb在Native侧获取API的接口，及基础Native API类型。 | 28| [arkweb_net_error_list.h](arkweb__net__error__list_8h.md) | 声明ArkWeb网络协议栈错误码。 | 29| [arkweb_scheme_handler.h](arkweb__scheme__handler_8h.md) | 声明用于拦截来自ArkWeb的请求的API。 | 30| [arkweb_type.h](arkweb__type_8h.md) | 提供ArkWeb在Native侧的公共类型定义。 | 31| [native_interface_arkweb.h](native__interface__arkweb_8h.md) | 声明API接口供开发者使用注入对象和执行JavaScript代码等功能。 | 32 33 34### 结构体 35 36| 名称 | 描述 | 37| -------- | -------- | 38| struct [ArkWeb_AnyNativeAPI](_ark_web___any_native_a_p_i.md) | 定义基础Native API类型。 | 39| struct [ArkWeb_JavaScriptBridgeData](_ark_web___java_script_bridge_data.md) | 定义JavaScript Bridge数据的基础结构。 | 40| struct [ArkWeb_JavaScriptObject](_ark_web___java_script_object.md) | 注入的JavaScript结构体。 | 41| struct [ArkWeb_ProxyMethod](_ark_web___proxy_method.md) | 注入的Proxy方法通用结构体。 | 42| struct [ArkWeb_ProxyObject](_ark_web___proxy_object.md) | 注入的Proxy对象通用结构体。 | 43| struct [ArkWeb_ControllerAPI](_ark_web___controller_a_p_i.md) | Controller相关的Native API结构体。 在调用API前建议通过ARKWEB_MEMBER_MISSING校验该函数结构体是否有对应函数指针，避免SDK与设备ROM不匹配导致crash问题。 | 44| struct [ArkWeb_ComponentAPI](_ark_web___component_a_p_i.md) | Component相关的Native API结构体。 | 45| struct [ArkWeb_WebMessagePortAPI](_ark_web___web_message_port_a_p_i.md) | Post Message相关的Native API结构体。 在调用API前建议通过ARKWEB_MEMBER_MISSING校验该函数结构体是否有对应函数指针，避免SDK与设备ROM不匹配导致crash问题。 | 46| struct [ArkWeb_WebMessageAPI](_ark_web___web_message_a_p_i.md) | Post Message数据相关的Native API结构体。 在调用API前建议通过ARKWEB_MEMBER_MISSING校验该函数结构体是否有对应函数指针，避免SDK与设备ROM不匹配导致crash问题。 | 47| struct [ArkWeb_CookieManagerAPI](_ark_web___cookie_manager_a_p_i.md) | 定义了ArkWeb原生CookieManager接口。 在调用API之前，建议使用ARKWEB_MEMBER_MISSING检查函数结构体是否有对应的函数指针，避免SDK与设备ROM不匹配导致崩溃。 | 48 49 50### 宏定义 51 52| 名称 | 描述 | 53| -------- | -------- | 54| [ARKWEB_MEMBER_EXISTS](#arkweb_member_exists)(s, f) ((intptr_t) & ((s)->f) - (intptr_t)(s) + sizeof((s)->f) <= \*reinterpret_cast<size_t\*>(s)) | 检查结构体中是否存在该成员变量。 | 55| [ARKWEB_MEMBER_MISSING](#arkweb_member_missing)(s, f) (\(s, f) \|\| !((s)->f)) | 当前结构体存在该成员变量则返回false，否则返回true。 | 56 57 58### 类型定义 59 60| 名称 | 描述 | 61| -------- | -------- | 62| typedef enum [ArkWeb_ErrorCode](#arkweb_errorcode) [ArkWeb_ErrorCode](#arkweb_errorcode) | 定义ArkWeb NDK接口异常错误码。 | 63| typedef enum [ArkWeb_NetError](#arkweb_neterror) [ArkWeb_NetError](#arkweb_neterror) | 定义ArkWeb网络协议栈错误码。 | 64| typedef enum [ArkWeb_CustomSchemeOption](#arkweb_customschemeoption) [ArkWeb_CustomSchemeOption](#arkweb_customschemeoption) | custom scheme的配置信息。 | 65| typedef enum [ArkWeb_ResourceType](#arkweb_resourcetype) [ArkWeb_ResourceType](#arkweb_resourcetype) | 请求的资源类型。 | 66| typedef struct ArkWeb_SchemeHandler_ [ArkWeb_SchemeHandler](#arkweb_schemehandler) | 该类用于拦截指定scheme的请求。 | 67| typedef struct ArkWeb_ResourceHandler_ [ArkWeb_ResourceHandler](#arkweb_resourcehandler) | 用于被拦截的URL请求。 | 68| typedef struct ArkWeb_Response_ [ArkWeb_Response](#arkweb_response) | 为被拦截的请求构造一个ArkWeb_Response。 | 69| typedef struct ArkWeb_ResourceRequest_ [ArkWeb_ResourceRequest](#arkweb_resourcerequest) | 对应内核的一个请求，可以通过OH_ArkWeb_ResourceRequest获取请求的URL、method、post data以及其他信息。 | 70| typedef struct ArkWeb_RequestHeaderList_ [ArkWeb_RequestHeaderList](#arkweb_requestheaderlist) | 请求头列表。 | 71| typedef struct ArkWeb_HttpBodyStream_ [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) | 请求的上传数据。 | 72| typedef void(\* [ArkWeb_OnRequestStart](#arkweb_onrequeststart)) (const [ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler, [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, const [ArkWeb_ResourceHandler](#arkweb_resourcehandler) \*resourceHandler, bool \*intercept) | 请求开始的回调，这将在IO线程上被调用。 | 73| typedef void(\* [ArkWeb_OnRequestStop](#arkweb_onrequeststop)) (const [ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler, const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 请求完成时的回调函数。 | 74| typedef void(\* [ArkWeb_HttpBodyStreamReadCallback](#arkweb_httpbodystreamreadcallback)) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream, uint8_t \*buffer, int bytesRead) | 当OH_ArkWebHttpBodyStream_Read读取操作完成时的回调函数。 | 75| typedef void(\* [ArkWeb_HttpBodyStreamInitCallback](#arkweb_httpbodystreaminitcallback)) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream, [ArkWeb_NetError](#arkweb_neterror) result) | ArkWeb_HttpBodyStream初始化操作完成时回调函数。 | 76| typedef enum [ArkWeb_WebMessageType](#arkweb_webmessagetype) [ArkWeb_WebMessageType](#arkweb_webmessagetype) | Post Message数据类型。 | 77| typedef struct ArkWeb_WebMessage \* [ArkWeb_WebMessagePtr](#arkweb_webmessageptr) | Post Message数据结构体指针。 | 78| typedef void(\* [ArkWeb_OnJavaScriptCallback](#arkweb_onjavascriptcallback)) (const char \*webTag, const [ArkWeb_JavaScriptBridgeData](_ark_web___java_script_bridge_data.md) \*data, void \*userData) | 注入的JavaScript执行完成的回调。 | 79| typedef void(\* [ArkWeb_OnJavaScriptProxyCallback](#arkweb_onjavascriptproxycallback)) (const char \*webTag, const [ArkWeb_JavaScriptBridgeData](_ark_web___java_script_bridge_data.md) \*dataArray, size_t arraySize, void \*userData) | Proxy方法被执行的回调。 | 80| typedef void(\* [ArkWeb_OnComponentCallback](#arkweb_oncomponentcallback)) (const char \*webTag, void \*userData) | 组件事件通知相关的通用回调。 | 81| typedef struct ArkWeb_WebMessagePort \* [ArkWeb_WebMessagePortPtr](#arkweb_webmessageportptr) | Post Message端口结构体指针。 | 82| typedef void(\* [ArkWeb_OnMessageEventHandler](#arkweb_onmessageeventhandler)) (const char \*webTag, const [ArkWeb_WebMessagePortPtr](#arkweb_webmessageportptr) port, const [ArkWeb_WebMessagePtr](#arkweb_webmessageptr) message, void \*userData) | 处理HTML发送过来的Post Message数据。 | 83| typedef void(\* [NativeArkWeb_OnJavaScriptCallback](#nativearkweb_onjavascriptcallback)) (const char \*) | 定义执行JavaScript代码后返回结果的回调函数的类型。 | 84| typedef char \*(\* [NativeArkWeb_OnJavaScriptProxyCallback](#nativearkweb_onjavascriptproxycallback)) (const char \*\*argv, int32_t argc) | 定义注入对象的回调函数的类型。 | 85| typedef void(\* [NativeArkWeb_OnValidCallback](#nativearkweb_onvalidcallback)) (const char \*) | 定义Web组件可用时的回调函数的类型。 | 86| typedef void(\* [NativeArkWeb_OnDestroyCallback](#nativearkweb_ondestroycallback)) (const char \*) | 定义Web组件销毁时的回调函数的类型。 | 87 88 89### 枚举 90 91| 名称 | 描述 | 92| -------- | -------- | 93| [ArkWeb_ErrorCode](#arkweb_errorcode) {<br/>ARKWEB_SUCCESS = 0, ARKWEB_INIT_ERROR = 17100001, ARKWEB_ERROR_UNKNOWN = 17100100, ARKWEB_INVALID_PARAM = 17100101,<br/>ARKWEB_SCHEME_REGISTER_FAILED = 17100102, ARKWEB_INVALID_URL = 17100103, ARKWEB_INVALID_COOKIE_VALUE = 17100104<br/>} | 定义ArkWeb NDK接口异常错误码。 | 94| [ArkWeb_NativeAPIVariantKind](#arkweb_nativeapivariantkind) {<br/>ARKWEB_NATIVE_COMPONENT, ARKWEB_NATIVE_CONTROLLER, ARKWEB_NATIVE_WEB_MESSAGE_PORT, ARKWEB_NATIVE_WEB_MESSAGE,<br/>ARKWEB_NATIVE_COOKIE_MANAGER<br/>} | 定义Native API的类型枚举。 | 95| [ArkWeb_NetError](#arkweb_neterror) {<br/>ARKWEB_NET_OK = 0, ARKWEB_ERR_IO_PENDING = -1, ARKWEB_ERR_FAILED = -2, ARKWEB_ERR_ABORTED = -3,<br/>ARKWEB_ERR_INVALID_ARGUMENT = -4, ARKWEB_ERR_INVALID_HANDLE = -5, ARKWEB_ERR_FILE_NOT_FOUND = -6, ARKWEB_ERR_TIMED_OUT = -7,<br/>ARKWEB_ERR_FILE_TOO_LARGE = -8, ARKWEB_ERR_UNEXPECTED = -9, ARKWEB_ERR_ACCESS_DENIED = -10, ARKWEB_ERR_NOT_IMPLEMENTED = -11,<br/>ARKWEB_ERR_INSUFFICIENT_RESOURCES = -12, ARKWEB_ERR_OUT_OF_MEMORY = -13, ARKWEB_ERR_UPLOAD_FILE_CHANGED = -14, ARKWEB_ERR_SOCKET_NOT_CONNECTED = -15,<br/>ARKWEB_ERR_FILE_EXISTS = -16, ARKWEB_ERR_FILE_PATH_TOO_LONG = -17, ARKWEB_ERR_FILE_NO_SPACE = -18, ARKWEB_ERR_FILE_VIRUS_INFECTED = -19,<br/>ARKWEB_ERR_BLOCKED_BY_CLIENT = -20, ARKWEB_ERR_NETWORK_CHANGED = -21, ARKWEB_ERR_BLOCKED_BY_ADMINISTRATOR = -22, ARKWEB_ERR_SOCKET_CONNECTED = -23,<br/>ARKWEB_ERR_UPLOAD_STREAM_REWIND_NOT_SUPPORTED = -25, ARKWEB_ERR_CONTEXT_SHUT_DOWN = -26, ARKWEB_ERR_BLOCKED_BY_RESPONSE = -27, ARKWEB_ERR_CLEARTEXT_NOT_PERMITTED = -29,<br/>ARKWEB_ERR_BLOCKED_BY_CSP = -30, ARKWEB_ERR_H2_OR_QUIC_REQUIRED = -31, ARKWEB_ERR_BLOCKED_BY_ORB = -32, ARKWEB_ERR_CONNECTION_CLOSED = -100,<br/>ARKWEB_ERR_CONNECTION_RESET = -101, ARKWEB_ERR_CONNECTION_REFUSED = -102, ARKWEB_ERR_CONNECTION_ABORTED = -103, ARKWEB_ERR_CONNECTION_FAILED = -104,<br/>ARKWEB_ERR_NAME_NOT_RESOLVED = -105, ARKWEB_ERR_INTERNET_DISCONNECTED = -106, ARKWEB_ERR_SSL_PROTOCOL_ERROR = -107, ARKWEB_ERR_ADDRESS_INVALID = -108,<br/>ARKWEB_ERR_ADDRESS_UNREACHABLE = -109, ARKWEB_ERR_SSL_CLIENT_AUTH_CERT_NEEDED = -110, ARKWEB_ERR_TUNNEL_CONNECTION_FAILED = -111, ARKWEB_ERR_NO_SSL_VERSIONS_ENABLED = -112,<br/>ARKWEB_ERR_SSL_VERSION_OR_CIPHER_MISMATCH = -113, ARKWEB_ERR_SSL_RENEGOTIATION_REQUESTED = -114, ARKWEB_ERR_PROXY_AUTH_UNSUPPORTED = -115, ARKWEB_ERR_BAD_SSL_CLIENT_AUTH_CERT = -117,<br/>ARKWEB_ERR_CONNECTION_TIMED_OUT = -118, ARKWEB_ERR_HOST_RESOLVER_QUEUE_TOO_LARGE = -119, ARKWEB_ERR_SOCKS_CONNECTION_FAILED = -120, ARKWEB_ERR_SOCKS_CONNECTION_HOST_UNREACHABLE = -121,<br/>ARKWEB_ERR_ALPN_NEGOTIATION_FAILED = -122, ARKWEB_ERR_SSL_NO_RENEGOTIATION = -123, ARKWEB_ERR_WINSOCK_UNEXPECTED_WRITTEN_BYTES = -124, ARKWEB_ERR_SSL_DECOMPRESSION_FAILURE_ALERT = -125,<br/>ARKWEB_ERR_SSL_BAD_RECORD_MAC_ALERT = -126, ARKWEB_ERR_PROXY_AUTH_REQUESTED = -127, ARKWEB_ERR_PROXY_CONNECTION_FAILED = -130, ARKWEB_ERR_MANDATORY_PROXY_CONFIGURATION_FAILED = -131,<br/>ARKWEB_ERR_PRECONNECT_MAX_SOCKET_LIMIT = -133, ARKWEB_ERR_SSL_CLIENT_AUTH_PRIVATE_KEY_ACCESS_DENIED = -134, ARKWEB_ERR_SSL_CLIENT_AUTH_CERT_NO_PRIVATE_KEY = -135, ARKWEB_ERR_PROXY_CERTIFICATE_INVALID = -136,<br/>ARKWEB_ERR_NAME_RESOLUTION_FAILED = -137, ARKWEB_ERR_NETWORK_ACCESS_DENIED = -138, ARKWEB_ERR_TEMPORARILY_THROTTLED = -139, ARKWEB_ERR_HTTPS_PROXY_TUNNEL_RESPONSE_REDIRECT = -140,<br/>ARKWEB_ERR_SSL_CLIENT_AUTH_SIGNATURE_FAILED = -141, ARKWEB_ERR_MSG_TOO_BIG = -142, ARKWEB_ERR_WS_PROTOCOL_ERROR = -145, ARKWEB_ERR_ADDRESS_IN_USE = -147,<br/>ARKWEB_ERR_SSL_HANDSHAKE_NOT_COMPLETED = -148, ARKWEB_ERR_SSL_BAD_PEER_PUBLIC_KEY = -149, ARKWEB_ERR_SSL_PINNED_KEY_NOT_IN_CERT_CHAIN = -150, ARKWEB_ERR_CLIENT_AUTH_CERT_TYPE_UNSUPPORTED = -151,<br/>ARKWEB_ERR_SSL_DECRYPT_ERROR_ALERT = -153, ARKWEB_ERR_WS_THROTTLE_QUEUE_TOO_LARGE = -154, ARKWEB_ERR_SSL_SERVER_CERT_CHANGED = -156, ARKWEB_ERR_SSL_UNRECOGNIZED_NAME_ALERT = -159,<br/>ARKWEB_ERR_SOCKET_SET_RECEIVE_BUFFER_SIZE_ERROR = -160, ARKWEB_ERR_SOCKET_SET_SEND_BUFFER_SIZE_ERROR = -161, ARKWEB_ERR_SOCKET_RECEIVE_BUFFER_SIZE_UNCHANGEABLE = -162, ARKWEB_ERR_SOCKET_SEND_BUFFER_SIZE_UNCHANGEABLE = -163,<br/>ARKWEB_ERR_SSL_CLIENT_AUTH_CERT_BAD_FORMAT = -164, ARKWEB_ERR_ICANN_NAME_COLLISION = -166, ARKWEB_ERR_SSL_SERVER_CERT_BAD_FORMAT = -167, ARKWEB_ERR_CT_STH_PARSING_FAILED = -168,<br/>ARKWEB_ERR_CT_STH_INCOMPLETE = -169, ARKWEB_ERR_UNABLE_TO_REUSE_CONNECTION_FOR_PROXY_AUTH = -170, ARKWEB_ERR_CT_CONSISTENCY_PROOF_PARSING_FAILED = -171, ARKWEB_ERR_SSL_OBSOLETE_CIPHER = -172,<br/>ARKWEB_ERR_WS_UPGRADE = -173, ARKWEB_ERR_READ_IF_READY_NOT_IMPLEMENTED = -174, ARKWEB_ERR_NO_BUFFER_SPACE = -176, ARKWEB_ERR_SSL_CLIENT_AUTH_NO_COMMON_ALGORITHMS = -177,<br/>ARKWEB_ERR_EARLY_DATA_REJECTED = -178, ARKWEB_ERR_WRONG_VERSION_ON_EARLY_DATA = -179, ARKWEB_ERR_TLS13_DOWNGRADE_DETECTED = -180, ARKWEB_ERR_SSL_KEY_USAGE_INCOMPATIBLE = -181,<br/>ARKWEB_ERR_INVALID_ECH_CONFIG_LIST = -182, ARKWEB_ERR_ECH_NOT_NEGOTIATED = -183, ARKWEB_ERR_ECH_FALLBACK_CERTIFICATE_INVALID = -184, ARKWEB_ERR_CERT_COMMON_NAME_INVALID = -200,<br/>ARKWEB_ERR_CERT_DATE_INVALID = -201, ARKWEB_ERR_CERT_AUTHORITY_INVALID = -202, ARKWEB_ERR_CERT_CONTAINS_ERRORS = -203, ARKWEB_ERR_CERT_NO_REVOCATION_MECHANISM = -204,<br/>ARKWEB_ERR_CERT_UNABLE_TO_CHECK_REVOCATION = -205, ARKWEB_ERR_CERT_REVOKED = -206, ARKWEB_ERR_CERT_INVALID = -207, ARKWEB_ERR_CERT_WEAK_SIGNATURE_ALGORITHM = -208,<br/>ARKWEB_ERR_CERT_NON_UNIQUE_NAME = -210, ARKWEB_ERR_CERT_WEAK_KEY = -211, ARKWEB_ERR_CERT_NAME_CONSTRAINT_VIOLATION = -212, ARKWEB_ERR_CERT_VALIDITY_TOO_LONG = -213,<br/>ARKWEB_ERR_CERTIFICATE_TRANSPARENCY_REQUIRED = -214, ARKWEB_ERR_CERT_SYMANTEC_LEGACY = -215, ARKWEB_ERR_CERT_KNOWN_INTERCEPTION_BLOCKED = -217, ARKWEB_ERR_SSL_OBSOLETE_VERSION_OR_CIPHER = -218,<br/>ARKWEB_ERR_CERT_END = -219, ARKWEB_ERR_INVALID_URL = -300, ARKWEB_ERR_DISALLOWED_URL_SCHEME = -301, ARKWEB_ERR_UNKNOWN_URL_SCHEME = -302,<br/>ARKWEB_ERR_INVALID_REDIRECT = -303, ARKWEB_ERR_TOO_MANY_REDIRECTS = -310, ARKWEB_ERR_UNSAFE_REDIRECT = -311, ARKWEB_ERR_UNSAFE_PORT = -312,<br/>ARKWEB_ERR_INVALID_RESPONSE = -320, ARKWEB_ERR_INVALID_CHUNKED_ENCODING = -321, ARKWEB_ERR_METHOD_UNSUPPORTED = -322, ARKWEB_ERR_UNEXPECTED_PROXY_AUTH = -323,<br/>ARKWEB_ERR_EMPTY_RESPONSE = -324, ARKWEB_ERR_RESPONSE_HEADERS_TOO_BIG = -325, ARKWEB_ERR_PAC_SCRIPT_FAILED = -327, ARKWEB_ERR_REQUEST_RANGE_NOT_SATISFIABLE = -328,<br/>ARKWEB_ERR_MALFORMED_IDENTITY = -329, ARKWEB_ERR_CONTENT_DECODING_FAILED = -330, ARKWEB_ERR_NETWORK_IO_SUSPENDED = -331, ARKWEB_ERR_SYN_REPLY_NOT_RECEIVED = -332,<br/>ARKWEB_ERR_ENCODING_CONVERSION_FAILED = -333, ARKWEB_ERR_UNRECOGNIZED_FTP_DIRECTORY_LISTING_FORMAT = -334, ARKWEB_ERR_NO_SUPPORTED_PROXIES = -336, ARKWEB_ERR_HTTP2_PROTOCOL_ERROR = -337,<br/>ARKWEB_ERR_INVALID_AUTH_CREDENTIALS = -338, ARKWEB_ERR_UNSUPPORTED_AUTH_SCHEME = -339, ARKWEB_ERR_ENCODING_DETECTION_FAILED = -340, ARKWEB_ERR_MISSING_AUTH_CREDENTIALS = -341,<br/>ARKWEB_ERR_UNEXPECTED_SECURITY_LIBRARY_STATUS = -342, ARKWEB_ERR_MISCONFIGURED_AUTH_ENVIRONMENT = -343, ARKWEB_ERR_UNDOCUMENTED_SECURITY_LIBRARY_STATUS = -344, ARKWEB_ERR_RESPONSE_BODY_TOO_BIG_TO_DRAIN = -345,<br/>ARKWEB_ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_LENGTH = -346, ARKWEB_ERR_INCOMPLETE_HTTP2_HEADERS = -347, ARKWEB_ERR_PAC_NOT_IN_DHCP = -348, ARKWEB_ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_DISPOSITION = -349,<br/>ARKWEB_ERR_RESPONSE_HEADERS_MULTIPLE_LOCATION = -350, ARKWEB_ERR_HTTP2_SERVER_REFUSED_STREAM = -351, ARKWEB_ERR_HTTP2_PING_FAILED = -352, ARKWEB_ERR_CONTENT_LENGTH_MISMATCH = -354,<br/>ARKWEB_ERR_INCOMPLETE_CHUNKED_ENCODING = -355, ARKWEB_ERR_QUIC_PROTOCOL_ERROR = -356, ARKWEB_ERR_RESPONSE_HEADERS_TRUNCATED = -357, ARKWEB_ERR_QUIC_HANDSHAKE_FAILED = -358,<br/>ARKWEB_ERR_HTTP2_INADEQUATE_TRANSPORT_SECURITY = -360, ARKWEB_ERR_HTTP2_FLOW_CONTROL_ERROR = -361, ARKWEB_ERR_HTTP2_FRAME_SIZE_ERROR = -362, ARKWEB_ERR_HTTP2_COMPRESSION_ERROR = -363,<br/>ARKWEB_ERR_PROXY_AUTH_REQUESTED_WITH_NO_CONNECTION = -364, ARKWEB_ERR_HTTP_1_1_REQUIRED = -365, ARKWEB_ERR_PROXY_HTTP_1_1_REQUIRED = -366, ARKWEB_ERR_PAC_SCRIPT_TERMINATED = -367,<br/>ARKWEB_ERR_INVALID_HTTP_RESPONSE = -370, ARKWEB_ERR_CONTENT_DECODING_INIT_FAILED = -371, ARKWEB_ERR_HTTP2_RST_STREAM_NO_ERROR_RECEIVED = -372, ARKWEB_ERR_HTTP2_PUSHED_STREAM_NOT_AVAILABLE = -373,<br/>ARKWEB_ERR_HTTP2_CLAIMED_PUSHED_STREAM_RESET_BY_SERVER = -374, ARKWEB_ERR_TOO_MANY_RETRIES = -375, ARKWEB_ERR_HTTP2_STREAM_CLOSED = -376, ARKWEB_ERR_HTTP2_CLIENT_REFUSED_STREAM = -377,<br/>ARKWEB_ERR_HTTP2_PUSHED_RESPONSE_DOES_NOT_MATCH = -378, ARKWEB_ERR_HTTP_RESPONSE_CODE_FAILURE = -379, ARKWEB_ERR_QUIC_UNKNOWN_CERT_ROOT = -380, ARKWEB_ERR_QUIC_GOAWAY_REQUEST_CAN_BE_RETRIED = -381,<br/>ARKWEB_ERR_TOO_MANY_ACCEPT_CH_RESTARTS = -382, ARKWEB_ERR_INCONSISTENT_IP_ADDRESS_SPACE = -383, ARKWEB_ERR_CACHED_IP_ADDRESS_SPACE_BLOCKED_BY_LOCAL_NETWORK_ACCESS_POLICY = -384, ARKWEB_ERR_CACHE_MISS = -400,<br/>ARKWEB_ERR_CACHE_READ_FAILURE = -401, ARKWEB_ERR_CACHE_WRITE_FAILURE = -402, ARKWEB_ERR_CACHE_OPERATION_UNSUPPORTED = -403, ARKWEB_ERR_CACHE_OPEN_FAILURE = -404,<br/>ARKWEB_ERR_CACHE_CREATE_FAILURE = -405, ARKWEB_ERR_CACHE_RACE = -406, ARKWEB_ERR_CACHE_CHECKSUM_READ_FAILURE = -407, ARKWEB_ERR_CACHE_CHECKSUM_MISMATCH = -408,<br/>ARKWEB_ERR_CACHE_LOCK_TIMEOUT = -409, ARKWEB_ERR_CACHE_AUTH_FAILURE_AFTER_READ = -410, ARKWEB_ERR_CACHE_ENTRY_NOT_SUITABLE = -411, ARKWEB_ERR_CACHE_DOOM_FAILURE = -412,<br/>ARKWEB_ERR_CACHE_OPEN_OR_CREATE_FAILURE = -413, ARKWEB_ERR_INSECURE_RESPONSE = -501, ARKWEB_ERR_NO_PRIVATE_KEY_FOR_CERT = -502, ARKWEB_ERR_ADD_USER_CERT_FAILED = -503,<br/>ARKWEB_ERR_INVALID_SIGNED_EXCHANGE = -504, ARKWEB_ERR_INVALID_WEB_BUNDLE = -505, ARKWEB_ERR_TRUST_TOKEN_OPERATION_FAILED = -506, ARKWEB_ERR_TRUST_TOKEN_OPERATION_SUCCESS_WITHOUT_SENDING_REQUEST = -507,<br/>ARKWEB_ERR_FTP_FAILED = -601, ARKWEB_ERR_FTP_SERVICE_UNAVAILABLE = -602, ARKWEB_ERR_FTP_TRANSFER_ABORTED = -603, ARKWEB_ERR_FTP_FILE_BUSY = -604,<br/>ARKWEB_ERR_FTP_SYNTAX_ERROR = -605, ARKWEB_ERR_FTP_COMMAND_UNSUPPORTED = -606, ARKWEB_ERR_FTP_BAD_COMMAND_SEQUENCE = -607, ARKWEB_ERR_PKCS12_IMPORT_BAD_PASSWORD = -701,<br/>ARKWEB_ERR_PKCS12_IMPORT_FAILED = -702, ARKWEB_ERR_IMPORT_CA_CERT_NOT_CA = -703, ARKWEB_ERR_IMPORT_CERT_ALREADY_EXISTS = -704, ARKWEB_ERR_IMPORT_CA_CERT_FAILED = -705,<br/>ARKWEB_ERR_IMPORT_SERVER_CERT_FAILED = -706, ARKWEB_ERR_PKCS12_IMPORT_INVALID_MAC = -707, ARKWEB_ERR_PKCS12_IMPORT_INVALID_FILE = -708, ARKWEB_ERR_PKCS12_IMPORT_UNSUPPORTED = -709,<br/>ARKWEB_ERR_KEY_GENERATION_FAILED = -710, ARKWEB_ERR_PRIVATE_KEY_EXPORT_FAILED = -712, ARKWEB_ERR_SELF_SIGNED_CERT_GENERATION_FAILED = -713, ARKWEB_ERR_CERT_DATABASE_CHANGED = -714,<br/>ARKWEB_ERR_CERT_VERIFIER_CHANGED = -716, ARKWEB_ERR_DNS_MALFORMED_RESPONSE = -800, ARKWEB_ERR_DNS_SERVER_REQUIRES_TCP = -801, ARKWEB_ERR_DNS_SERVER_FAILED = -802,<br/>ARKWEB_ERR_DNS_TIMED_OUT = -803, ARKWEB_ERR_DNS_CACHE_MISS = -804, ARKWEB_ERR_DNS_SEARCH_EMPTY = -805, ARKWEB_ERR_DNS_SORT_ERROR = -806,<br/>ARKWEB_ERR_DNS_SECURE_RESOLVER_HOSTNAME_RESOLUTION_FAILED = -808, ARKWEB_ERR_DNS_NAME_HTTPS_ONLY = -809, ARKWEB_ERR_DNS_REQUEST_CANCELED = -810, ARKWEB_ERR_DNS_NO_MATCHING_SUPPORTED_ALPN = -811<br/>} | 定义ArkWeb网络协议栈错误码。 | 96| [ArkWeb_CustomSchemeOption](#arkweb_customschemeoption) {<br/>**OH_ARKWEB_SCHEME_OPTION_NONE** = 0, ARKWEB_SCHEME_OPTION_STANDARD = 1 << 0, ARKWEB_SCHEME_OPTION_LOCAL = 1 << 1, ARKWEB_SCHEME_OPTION_DISPLAY_ISOLATED = 1 << 2,<br/>ARKWEB_SCHEME_OPTION_SECURE = 1 << 3, ARKWEB_SCHEME_OPTION_CORS_ENABLED = 1 << 4, ARKWEB_SCHEME_OPTION_CSP_BYPASSING = 1 << 5, ARKWEB_SCHEME_OPTION_FETCH_ENABLED = 1 << 6,<br/>ARKWEB_SCHEME_OPTION_CODE_CACHE_ENABLED = 1 << 7<br/>} | custom scheme的配置信息。 | 97| [ArkWeb_ResourceType](#arkweb_resourcetype) {<br/>MAIN_FRAME = 0, SUB_FRAME = 1, STYLE_SHEET = 2, SCRIPT = 3,<br/>IMAGE = 4, FONT_RESOURCE = 5, SUB_RESOURCE = 6, OBJECT = 7,<br/>MEDIA = 8, WORKER = 9, SHARED_WORKER = 10, PREFETCH = 11,<br/>FAVICON = 12, XHR = 13, PING = 14, SERVICE_WORKER = 15,<br/>CSP_REPORT = 16, PLUGIN_RESOURCE = 17, NAVIGATION_PRELOAD_MAIN_FRAME = 19, NAVIGATION_PRELOAD_SUB_FRAME = 20<br/>} | 请求的资源类型。 | 98| [ArkWeb_WebMessageType](#arkweb_webmessagetype) { ARKWEB_NONE = 0, ARKWEB_STRING, ARKWEB_BUFFER } | Post Message数据类型。 | 99 100### 函数 101 102| 名称 | 描述 | 103| -------- | -------- | 104| [ArkWeb_AnyNativeAPI](_ark_web___any_native_a_p_i.md) \* [OH_ArkWeb_GetNativeAPI](#oh_arkweb_getnativeapi) ([ArkWeb_NativeAPIVariantKind](#arkweb_nativeapivariantkind) type) | 根据传入的API类型，获取对应的Native API结构体。 | 105| void [OH_ArkWebRequestHeaderList_Destroy](#oh_arkwebrequestheaderlist_destroy) ([ArkWeb_RequestHeaderList](#arkweb_requestheaderlist) \*requestHeaderList) | 销毁ArkWeb_RequestHeaderList对象。 | 106| int32_t [OH_ArkWebRequestHeaderList_GetSize](#oh_arkwebrequestheaderlist_getsize) (const [ArkWeb_RequestHeaderList](#arkweb_requestheaderlist) \*requestHeaderList) | 获取请求头列表的大小。 | 107| void [OH_ArkWebRequestHeaderList_GetHeader](#oh_arkwebrequestheaderlist_getheader) (const [ArkWeb_RequestHeaderList](#arkweb_requestheaderlist) \*requestHeaderList, int32_t index, char \*\*key, char \*\*value) | 获取指定的请求头。 | 108| int32_t [OH_ArkWebResourceRequest_SetUserData](#oh_arkwebresourcerequest_setuserdata) ([ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, void \*userData) | 将一个用户数据设置到ArkWeb_ResourceRequest对象中。 | 109| void \* [OH_ArkWebResourceRequest_GetUserData](#oh_arkwebresourcerequest_getuserdata) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 从ArkWeb_ResourceRequest获取用户数据。 | 110| void [OH_ArkWebResourceRequest_GetMethod](#oh_arkwebresourcerequest_getmethod) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, char \*\*method) | 获取请求的method。 | 111| void [OH_ArkWebResourceRequest_GetUrl](#oh_arkwebresourcerequest_geturl) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, char \*\*url) | 获取请求的url。 | 112| void [OH_ArkWebResourceRequest_GetHttpBodyStream](#oh_arkwebresourcerequest_gethttpbodystream) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*\*httpBodyStream) | 创建一个ArkWeb_HttpBodyStream，用于读取请求的上传数据。 | 113| void [OH_ArkWebResourceRequest_DestroyHttpBodyStream](#oh_arkwebresourcerequest_destroyhttpbodystream) ([ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 销毁ArkWeb_HttpBodyStream对象。 | 114| int32_t [OH_ArkWebResourceRequest_GetResourceType](#oh_arkwebresourcerequest_getresourcetype) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 获取请求的资源类型。 | 115| void [OH_ArkWebResourceRequest_GetFrameUrl](#oh_arkwebresourcerequest_getframeurl) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, char \*\*frameUrl) | 获取触发此请求的Frame的URL。 | 116| int32_t [OH_ArkWebHttpBodyStream_SetUserData](#oh_arkwebhttpbodystream_setuserdata) ([ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream, void \*userData) | 将一个用户数据设置到ArkWeb_HttpBodyStream对象中。 | 117| void \* [OH_ArkWebHttpBodyStream_GetUserData](#oh_arkwebhttpbodystream_getuserdata) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 从ArkWeb_HttpBodyStream获取用户数据。 | 118| int32_t [OH_ArkWebHttpBodyStream_SetReadCallback](#oh_arkwebhttpbodystream_setreadcallback) ([ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream, [ArkWeb_HttpBodyStreamReadCallback](#arkweb_httpbodystreamreadcallback) readCallback) | 为OH_ArkWebHttpBodyStream_Read设置回调函数。 | 119| int32_t [OH_ArkWebHttpBodyStream_Init](#oh_arkwebhttpbodystream_init) ([ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream, [ArkWeb_HttpBodyStreamInitCallback](#arkweb_httpbodystreaminitcallback) initCallback) | 初始化ArkWeb_HttpBodyStream。 | 120| void [OH_ArkWebHttpBodyStream_Read](#oh_arkwebhttpbodystream_read) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream, uint8_t \*buffer, int bufLen) | 将请求的上传数据读取到buffer。 | 121| uint64_t [OH_ArkWebHttpBodyStream_GetSize](#oh_arkwebhttpbodystream_getsize) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 获取httpBodyStream的大小。 | 122| uint64_t [OH_ArkWebHttpBodyStream_GetPosition](#oh_arkwebhttpbodystream_getposition) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 获取httpBodyStream当前的读取位置。 | 123| bool [OH_ArkWebHttpBodyStream_IsChunked](#oh_arkwebhttpbodystream_ischunked) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 获取httpBodyStream是否采用分块传输。 | 124| bool [OH_ArkWebHttpBodyStream_IsEof](#oh_arkwebhttpbodystream_iseof) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 如果httpBodyStream中的所有数据都已被读取，则返回true。 | 125| bool [OH_ArkWebHttpBodyStream_IsInMemory](#oh_arkwebhttpbodystream_isinmemory) (const [ArkWeb_HttpBodyStream](#arkweb_httpbodystream) \*httpBodyStream) | 如果httpBodyStream中的上传数据完全在内存中，并且所有读取请求都将同步成功，则返回true。 | 126| int32_t [OH_ArkWebResourceRequest_Destroy](#oh_arkwebresourcerequest_destroy) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 销毁ArkWeb_ResourceRequest对象。 | 127| void [OH_ArkWebResourceRequest_GetReferrer](#oh_arkwebresourcerequest_getreferrer) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, char \*\*referrer) | 获取请求的Referrer。 | 128| void [OH_ArkWebResourceRequest_GetRequestHeaders](#oh_arkwebresourcerequest_getrequestheaders) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest, [ArkWeb_RequestHeaderList](#arkweb_requestheaderlist) \*\*requestHeaderList) | 获取请求的请求头列表OH_ArkWeb_RequestHeaderList。 | 129| bool [OH_ArkWebResourceRequest_IsRedirect](#oh_arkwebresourcerequest_isredirect) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 判断这是否是一个重定向请求。 | 130| bool [OH_ArkWebResourceRequest_IsMainFrame](#oh_arkwebresourcerequest_ismainframe) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 判断这是否是主框架文档资源的请求。 | 131| bool [OH_ArkWebResourceRequest_HasGesture](#oh_arkwebresourcerequest_hasgesture) (const [ArkWeb_ResourceRequest](#arkweb_resourcerequest) \*resourceRequest) | 判断这是否是一个由用户手势触发的请求。 | 132| int32_t [OH_ArkWeb_RegisterCustomSchemes](#oh_arkweb_registercustomschemes) (const char \*scheme, int32_t option) | 将custom scheme注册到ArkWeb。 | 133| bool [OH_ArkWebServiceWorker_SetSchemeHandler](#oh_arkwebserviceworker_setschemehandler) (const char \*scheme, [ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler) | 为指定scheme设置一个ArkWeb_SchemeHandler以拦截ServiceWorker触发的该scheme类型的请求。 | 134| bool [OH_ArkWeb_SetSchemeHandler](#oh_arkweb_setschemehandler) (const char \*scheme, const char \*webTag, [ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler) | 为指定scheme设置一个ArkWeb_SchemeHandler以拦截该scheme类型的请求。 | 135| int32_t [OH_ArkWebServiceWorker_ClearSchemeHandlers](#oh_arkwebserviceworker_clearschemehandlers) () | 清除为ServiceWorker注册的SchemeHandler。 | 136| int32_t [OH_ArkWeb_ClearSchemeHandlers](#oh_arkweb_clearschemehandlers) (const char \*webTag) | 清除为指定web注册的SchemeHandler。 | 137| void [OH_ArkWeb_CreateSchemeHandler](#oh_arkweb_createschemehandler) ([ArkWeb_SchemeHandler](#arkweb_schemehandler) \*\*schemeHandler) | 创建一个ArkWeb_SchemeHandler对象。 | 138| void [OH_ArkWeb_DestroySchemeHandler](#oh_arkweb_destroyschemehandler) ([ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler) | 销毁一个ArkWeb_SchemeHandler对象。 | 139| int32_t [OH_ArkWebSchemeHandler_SetUserData](#oh_arkwebschemehandler_setuserdata) ([ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler, void \*userData) | 将一个用户数据设置到ArkWeb_SchemeHandler对象中。 | 140| void \* [OH_ArkWebSchemeHandler_GetUserData](#oh_arkwebschemehandler_getuserdata) (const [ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler) | 从ArkWeb_SchemeHandler获取用户数据。 | 141| int32_t [OH_ArkWebSchemeHandler_SetOnRequestStart](#oh_arkwebschemehandler_setonrequeststart) ([ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler, [ArkWeb_OnRequestStart](#arkweb_onrequeststart) onRequestStart) | 为SchemeHandler设置OnRequestStart回调。 | 142| int32_t [OH_ArkWebSchemeHandler_SetOnRequestStop](#oh_arkwebschemehandler_setonrequeststop) ([ArkWeb_SchemeHandler](#arkweb_schemehandler) \*schemeHandler, [ArkWeb_OnRequestStop](#arkweb_onrequeststop) onRequestStop) | 为SchemeHandler设置OnRequestStop回调。 | 143| void [OH_ArkWeb_CreateResponse](#oh_arkweb_createresponse) ([ArkWeb_Response](#arkweb_response) \*\*response) | 为被拦截的请求创建一个ArkWeb_Response对象。 | 144| void [OH_ArkWeb_DestroyResponse](#oh_arkweb_destroyresponse) ([ArkWeb_Response](#arkweb_response) \*response) | 销毁一个ArkWeb_Response对象。 | 145| int32_t [OH_ArkWebResponse_SetUrl](#oh_arkwebresponse_seturl) ([ArkWeb_Response](#arkweb_response) \*response, const char \*url) | 设置经过重定向或由于HSTS而改变后的解析URL，设置后会触发跳转。 | 146| void [OH_ArkWebResponse_GetUrl](#oh_arkwebresponse_geturl) (const [ArkWeb_Response](#arkweb_response) \*response, char \*\*url) | 获取经过重定向或由于HSTS而更改后的解析URL。 | 147| int32_t [OH_ArkWebResponse_SetError](#oh_arkwebresponse_seterror) ([ArkWeb_Response](#arkweb_response) \*response, [ArkWeb_NetError](#arkweb_neterror) errorCode) | 给ArkWeb_Response对象设置一个错误码。 | 148| [ArkWeb_NetError](#arkweb_neterror) [OH_ArkWebResponse_GetError](#oh_arkwebresponse_geterror) (const [ArkWeb_Response](#arkweb_response) \*response) | 获取ArkWeb_Response的错误码。 | 149| int32_t [OH_ArkWebResponse_SetStatus](#oh_arkwebresponse_setstatus) ([ArkWeb_Response](#arkweb_response) \*response, int status) | 为ArkWeb_Response对象设置一个HTTP状态码。 | 150| int [OH_ArkWebResponse_GetStatus](#oh_arkwebresponse_getstatus) (const [ArkWeb_Response](#arkweb_response) \*response) | 获取ArkWeb_Response的HTTP状态码。 | 151| int32_t [OH_ArkWebResponse_SetStatusText](#oh_arkwebresponse_setstatustext) ([ArkWeb_Response](#arkweb_response) \*response, const char \*statusText) | 为ArkWeb_Response设置状态文本。 | 152| void [OH_ArkWebResponse_GetStatusText](#oh_arkwebresponse_getstatustext) (const [ArkWeb_Response](#arkweb_response) \*response, char \*\*statusText) | 获取ArkWeb_Response的状态文本。 | 153| int32_t [OH_ArkWebResponse_SetMimeType](#oh_arkwebresponse_setmimetype) ([ArkWeb_Response](#arkweb_response) \*response, const char \*mimeType) | 为ArkWeb_Response设置媒体类型。 | 154| void [OH_ArkWebResponse_GetMimeType](#oh_arkwebresponse_getmimetype) (const [ArkWeb_Response](#arkweb_response) \*response, char \*\*mimeType) | 获取ArkWeb_Response的媒体类型。 | 155| int32_t [OH_ArkWebResponse_SetCharset](#oh_arkwebresponse_setcharset) ([ArkWeb_Response](#arkweb_response) \*response, const char \*charset) | 为ArkWeb_Response设置字符集。 | 156| void [OH_ArkWebResponse_GetCharset](#oh_arkwebresponse_getcharset) (const [ArkWeb_Response](#arkweb_response) \*response, char \*\*charset) | 获取ArkWeb_Response的字符集。 | 157| int32_t [OH_ArkWebResponse_SetHeaderByName](#oh_arkwebresponse_setheaderbyname) ([ArkWeb_Response](#arkweb_response) \*response, const char \*name, const char \*value, bool overwrite) | 为ArkWeb_Response设置一个header。 | 158| void [OH_ArkWebResponse_GetHeaderByName](#oh_arkwebresponse_getheaderbyname) (const [ArkWeb_Response](#arkweb_response) \*response, const char \*name, char \*\*value) | 从ArkWeb_Response中获取header。 | 159| int32_t [OH_ArkWebResourceHandler_Destroy](#oh_arkwebresourcehandler_destroy) (const [ArkWeb_ResourceHandler](#arkweb_resourcehandler) \*resourceHandler) | 销毁一个ArkWeb_ResourceHandler对象。 | 160| int32_t [OH_ArkWebResourceHandler_DidReceiveResponse](#oh_arkwebresourcehandler_didreceiveresponse) (const [ArkWeb_ResourceHandler](#arkweb_resourcehandler) \*resourceHandler, const [ArkWeb_Response](#arkweb_response) \*response) | 将构造的响应头传递给被拦截的请求。 | 161| int32_t [OH_ArkWebResourceHandler_DidReceiveData](#oh_arkwebresourcehandler_didreceivedata) (const [ArkWeb_ResourceHandler](#arkweb_resourcehandler) \*resourceHandler, const uint8_t \*buffer, int64_t bufLen) | 将构造的响应体传递给被拦截的请求。 | 162| int32_t [OH_ArkWebResourceHandler_DidFinish](#oh_arkwebresourcehandler_didfinish) (const [ArkWeb_ResourceHandler](#arkweb_resourcehandler) \*resourceHandler) | 通知ArkWeb内核被拦截的请求已经完成，并且没有更多的数据可用。 | 163| int32_t [OH_ArkWebResourceHandler_DidFailWithError](#oh_arkwebresourcehandler_didfailwitherror) (const [ArkWeb_ResourceHandler](#arkweb_resourcehandler) \*resourceHandler, [ArkWeb_NetError](#arkweb_neterror) errorCode) | 通知ArkWeb内核被拦截请求应该失败。 | 164| void [OH_ArkWeb_ReleaseString](#oh_arkweb_releasestring) (char \*string) | 释放由NDK接口创建的字符串 | 165| void [OH_ArkWeb_ReleaseByteArray](#oh_arkweb_releasebytearray) (uint8_t \*byteArray) | 释放由NDK接口创建的字节数组。 | 166| void [OH_NativeArkWeb_RunJavaScript](#oh_nativearkweb_runjavascript) (const char \*webTag, const char \*jsCode, [NativeArkWeb_OnJavaScriptCallback](#nativearkweb_onjavascriptcallback) callback) | 在当前显示页面的环境下，加载并执行一段JavaScript代码。 | 167| void [OH_NativeArkWeb_RegisterJavaScriptProxy](#oh_nativearkweb_registerjavascriptproxy) (const char \*webTag, const char \*objName, const char \*\*methodList, [NativeArkWeb_OnJavaScriptProxyCallback](#nativearkweb_onjavascriptproxycallback) \*callback, int32_t size, bool needRefresh) | 注册对象及函数名称列表。 | 168| void [OH_NativeArkWeb_UnregisterJavaScriptProxy](#oh_nativearkweb_unregisterjavascriptproxy) (const char \*webTag, const char \*objName) | 删除已注册的对象及其下的回调函数。 | 169| void [OH_NativeArkWeb_SetJavaScriptProxyValidCallback](#oh_nativearkweb_setjavascriptproxyvalidcallback) (const char \*webTag, [NativeArkWeb_OnValidCallback](#nativearkweb_onvalidcallback) callback) | 设置对象可注册时的回调函数。 | 170| [NativeArkWeb_OnValidCallback](#nativearkweb_onvalidcallback) [OH_NativeArkWeb_GetJavaScriptProxyValidCallback](#oh_nativearkweb_getjavascriptproxyvalidcallback) (const char \*webTag) | 获取已注册的对象可注册时的回调函数。 | 171| void [OH_NativeArkWeb_SetDestroyCallback](#oh_nativearkweb_setdestroycallback) (const char \*webTag, [NativeArkWeb_OnDestroyCallback](#nativearkweb_ondestroycallback) callback) | 设置组件销毁时的回调函数。 | 172| [NativeArkWeb_OnDestroyCallback](#nativearkweb_ondestroycallback) [OH_NativeArkWeb_GetDestroyCallback](#oh_nativearkweb_getdestroycallback) (const char \*webTag) | 获取已注册的组件销毁时的回调函数。 | 173 174 175## 宏定义说明 176 177 178### ARKWEB_MEMBER_EXISTS 179 180``` 181#define ARKWEB_MEMBER_EXISTS( s, f ) ((intptr_t) & ((s)->f) - (intptr_t)(s) + sizeof((s)->f) <= *reinterpret_cast<size_t*>(s)) 182``` 183**描述：** 184 185检查结构体中是否存在该成员变量。 186 187**起始版本：** 12 188 189 190### ARKWEB_MEMBER_MISSING 191 192``` 193#define ARKWEB_MEMBER_MISSING( s, f ) (!ARKWEB_MEMBER_EXISTS(s, f) || !((s)->f)) 194``` 195**描述：** 196 197当前结构体存在该成员变量则返回false，否则返回true。 198 199**起始版本：** 12 200 201## 类型定义说明 202 203 204### ArkWeb_CustomSchemeOption 205 206``` 207typedef enum ArkWeb_CustomSchemeOption ArkWeb_CustomSchemeOption 208``` 209**描述：** 210 211custom scheme的配置信息。 212 213**系统能力：** SystemCapability.Web.Webview.Core 214 215**起始版本：** 12 216 217 218### ArkWeb_ErrorCode 219 220``` 221typedef enum ArkWeb_ErrorCode ArkWeb_ErrorCode 222``` 223**描述：** 224 225定义ArkWeb NDK接口异常错误码。 226 227**系统能力：** SystemCapability.Web.Webview.Core 228 229**起始版本：** 12 230 231 232### ArkWeb_HttpBodyStream 233 234``` 235typedef struct ArkWeb_HttpBodyStream_ ArkWeb_HttpBodyStream 236``` 237**描述：** 238 239请求的上传数据。 240 241使用OH_ArkWebHttpBodyStream_\*接口来读取上传的数据。 242 243**系统能力：** SystemCapability.Web.Webview.Core 244 245**起始版本：** 12 246 247 248### ArkWeb_HttpBodyStreamInitCallback 249 250``` 251typedef void(* ArkWeb_HttpBodyStreamInitCallback) (const ArkWeb_HttpBodyStream *httpBodyStream, ArkWeb_NetError result) 252``` 253**描述：** 254 255ArkWeb_HttpBodyStream初始化操作完成时回调函数。 256 257**系统能力：** SystemCapability.Web.Webview.Core 258 259**起始版本：** 12 260 261**参数:** 262 263| 名称 | 描述 | 264| -------- | -------- | 265| httpBodyStream | ArkWeb_HttpBodyStream。 | 266| result | 成功时返回ARKWEB_NET_OK，否则请参考[arkweb_net_error_list.h](arkweb__net__error__list_8h.md)。 | 267 268 269### ArkWeb_HttpBodyStreamReadCallback 270 271``` 272typedef void(* ArkWeb_HttpBodyStreamReadCallback) (const ArkWeb_HttpBodyStream *httpBodyStream, uint8_t *buffer, int bytesRead) 273``` 274**描述：** 275 276当OH_ArkWebHttpBodyStream_Read读取操作完成时的回调函数。 277 278**系统能力：** SystemCapability.Web.Webview.Core 279 280**起始版本：** 12 281 282**参数:** 283 284| 名称 | 描述 | 285| -------- | -------- | 286| httpBodyStream | ArkWeb_HttpBodyStream。 | 287| buffer | 接收数据的buffer。 | 288| bytesRead | OH_ArkWebHttpBodyStream_Read后的回调函数。如果bytesRead大于0，则表示buffer已填充了bytesRead大小的数据。 调用者可以从buffer中读取数据，如果OH_ArkWebHttpBodyStream_IsEOF为false，则调用者可以继续读取剩余的数据。 | 289 290 291### ArkWeb_NetError 292 293``` 294typedef enum ArkWeb_NetError ArkWeb_NetError 295``` 296**描述：** 297 298定义ArkWeb网络协议栈错误码。 299 300**系统能力：** SystemCapability.Web.Webview.Core 301 302**起始版本：** 12 303 304 305### ArkWeb_OnComponentCallback 306 307``` 308typedef void(* ArkWeb_OnComponentCallback) (const char *webTag, void *userData) 309``` 310**描述：** 311 312组件事件通知相关的通用回调。 313 314**起始版本：** 12 315 316 317### ArkWeb_OnJavaScriptCallback 318 319``` 320typedef void(* ArkWeb_OnJavaScriptCallback) (const char *webTag, const ArkWeb_JavaScriptBridgeData *data, void *userData) 321``` 322**描述：** 323 324注入的JavaScript执行完成的回调。 325 326**起始版本：** 12 327 328 329### ArkWeb_OnJavaScriptProxyCallback 330 331``` 332typedef void(* ArkWeb_OnJavaScriptProxyCallback) (const char *webTag, const ArkWeb_JavaScriptBridgeData *dataArray, size_t arraySize, void *userData) 333``` 334**描述：** 335 336Proxy方法被执行的回调。 337 338**起始版本：** 12 339 340 341### ArkWeb_OnMessageEventHandler 342 343``` 344typedef void(* ArkWeb_OnMessageEventHandler) (const char *webTag, const ArkWeb_WebMessagePortPtr port, const ArkWeb_WebMessagePtr message, void *userData) 345``` 346**描述：** 347 348处理HTML发送过来的Post Message数据。 349 350**起始版本：** 12 351 352**参数:** 353 354| 名称 | 描述 | 355| -------- | -------- | 356| webTag | Web组件名字。 | 357| port | Post Message端口。 | 358| message | Post Message数据。 | 359| userData | 用户自定义数据。 | 360 361 362### ArkWeb_OnRequestStart 363 364``` 365typedef void(* ArkWeb_OnRequestStart) (const ArkWeb_SchemeHandler *schemeHandler, ArkWeb_ResourceRequest *resourceRequest, const ArkWeb_ResourceHandler *resourceHandler, bool *intercept) 366``` 367**描述：** 368 369请求开始的回调，这将在IO线程上被调用。 370 371**系统能力：** SystemCapability.Web.Webview.Core 372 373**起始版本：** 12 374 375**参数:** 376 377| 名称 | 描述 | 378| -------- | -------- | 379| schemeHandler | ArkWeb_SchemeHandler。 | 380| resourceRequest | 通过该对象获取请求的信息。 | 381| resourceHandler | 请求的ArkWeb_ResourceHandler。如果intercept设置为false，则不应使用它。 | 382| intercept | 如果为true，则会拦截请求；如果为false，则不会拦截。 | 383 384 385### ArkWeb_OnRequestStop 386 387``` 388typedef void(* ArkWeb_OnRequestStop) (const ArkWeb_SchemeHandler *schemeHandler, const ArkWeb_ResourceRequest *resourceRequest) 389``` 390**描述：** 391 392请求完成时的回调函数。 393 394这将在IO线程上被调用。 395 396应该使用ArkWeb_ResourceRequest_Destroy销毁resourceRequest， 397 398并使用ArkWeb_ResourceHandler_Destroy销毁在ArkWeb_OnRequestStart中接收到的ArkWeb_ResourceHandler。 399 400**系统能力：** SystemCapability.Web.Webview.Core 401 402**起始版本：** 12 403 404**参数:** 405 406| 名称 | 描述 | 407| -------- | -------- | 408| schemeHandler | ArkWeb_SchemeHandler。 | 409| resourceRequest | ArkWeb_ResourceRequest。 | 410 411 412### ArkWeb_RequestHeaderList 413 414``` 415typedef struct ArkWeb_RequestHeaderList_ ArkWeb_RequestHeaderList 416``` 417**描述：** 418 419请求头列表。 420 421**系统能力：** SystemCapability.Web.Webview.Core 422 423**起始版本：** 12 424 425 426### ArkWeb_ResourceHandler 427 428``` 429typedef struct ArkWeb_ResourceHandler_ ArkWeb_ResourceHandler 430``` 431**描述：** 432 433用于被拦截的URL请求。 434 435可以通过ArkWeb_ResourceHandler发送自定义请求头以及自定义请求体。 436 437**系统能力：** SystemCapability.Web.Webview.Core 438 439**起始版本：** 12 440 441 442### ArkWeb_ResourceRequest 443 444``` 445typedef struct ArkWeb_ResourceRequest_ ArkWeb_ResourceRequest 446``` 447**描述：** 448 449对应内核的一个请求，可以通过OH_ArkWeb_ResourceRequest获取请求的URL、method、post data以及其他信息。 450 451**系统能力：** SystemCapability.Web.Webview.Core 452 453**起始版本：** 12 454 455 456### ArkWeb_ResourceType 457 458``` 459typedef enum ArkWeb_ResourceType ArkWeb_ResourceType 460``` 461**描述：** 462 463请求的资源类型。 464 465这些常量与Chromium中的ResourceType的对应项相匹配，不应重新编号。 466 467**系统能力：** SystemCapability.Web.Webview.Core 468 469**起始版本：** 12 470 471 472### ArkWeb_Response 473 474``` 475typedef struct ArkWeb_Response_ ArkWeb_Response 476``` 477**描述：** 478 479为被拦截的请求构造一个ArkWeb_Response。 480 481**系统能力：** SystemCapability.Web.Webview.Core 482 483**起始版本：** 12 484 485 486### ArkWeb_SchemeHandler 487 488``` 489typedef struct ArkWeb_SchemeHandler_ ArkWeb_SchemeHandler 490``` 491**描述：** 492 493该类用于拦截指定scheme的请求。 494 495**系统能力：** SystemCapability.Web.Webview.Core 496 497**起始版本：** 12 498 499 500### ArkWeb_WebMessagePortPtr 501 502``` 503typedef struct ArkWeb_WebMessagePort* ArkWeb_WebMessagePortPtr 504``` 505**描述：** 506 507Post Message端口结构体指针。 508 509**起始版本：** 12 510 511 512### ArkWeb_WebMessagePtr 513 514``` 515typedef struct ArkWeb_WebMessage* ArkWeb_WebMessagePtr 516``` 517**描述：** 518 519Post Message数据结构体指针。 520 521**起始版本：** 12 522 523 524### ArkWeb_WebMessageType 525 526``` 527typedef enum ArkWeb_WebMessageType ArkWeb_WebMessageType 528``` 529**描述：** 530 531Post Message数据类型。 532 533**起始版本：** 12 534 535 536### NativeArkWeb_OnDestroyCallback 537 538``` 539typedef void(* NativeArkWeb_OnDestroyCallback) (const char *) 540``` 541**描述：** 542 543定义Web组件销毁时的回调函数的类型。 544 545**起始版本：** 11 546 547 548### NativeArkWeb_OnJavaScriptCallback 549 550``` 551typedef void(* NativeArkWeb_OnJavaScriptCallback) (const char *) 552``` 553**描述：** 554 555定义执行JavaScript代码后返回结果的回调函数的类型。 556 557**起始版本：** 11 558 559 560### NativeArkWeb_OnJavaScriptProxyCallback 561 562``` 563typedef char*(* NativeArkWeb_OnJavaScriptProxyCallback) (const char **argv, int32_t argc) 564``` 565**描述：** 566 567定义注入对象的回调函数的类型。 568 569**起始版本：** 11 570 571 572### NativeArkWeb_OnValidCallback 573 574``` 575typedef void(* NativeArkWeb_OnValidCallback) (const char *) 576``` 577**描述：** 578 579定义Web组件可用时的回调函数的类型。 580 581**起始版本：** 11 582 583 584## 枚举类型说明 585 586 587### ArkWeb_CustomSchemeOption 588 589``` 590enum ArkWeb_CustomSchemeOption 591``` 592**描述：** 593 594custom scheme的配置信息。 595 596**系统能力：** SystemCapability.Web.Webview.Core 597 598**起始版本：** 12 599 600| 枚举值 | 描述 | 601| -------- | -------- | 602| ARKWEB_SCHEME_OPTION_STANDARD | 如果设置了ARKWEB_SCHEME_OPTION_STANDARD，那么该scheme将被视为标准scheme来处理。 标准scheme需要遵守在RFC 1738第3.1节中定义的URL规范化和解析规则，该规则可以在http:\//www\.ietf.org/rfc/rfc1738.txt中找到。 | 603| ARKWEB_SCHEME_OPTION_LOCAL | 如果设置了ARKWEB_SCHEME_OPTION_LOCAL，则将使用与“file” URL相同的安全规则来处理该scheme。 | 604| ARKWEB_SCHEME_OPTION_DISPLAY_ISOLATED | 如果设置了ARKWEB_SCHEME_OPTION_DISPLAY_ISOLATED，则该scheme的请求只能由使用相同scheme加载的页面中发起。 | 605| ARKWEB_SCHEME_OPTION_SECURE | 如果设置了ARKWEB_SCHEME_OPTION_SECURE，则将使用与“https” URL相同的安全规则来处理该scheme。 | 606| ARKWEB_SCHEME_OPTION_CORS_ENABLED | 如果设置了ARKWEB_SCHEME_OPTION_CORS_ENABLED，则该scheme可以发送CORS请求。在大多数情况下，当设置了ARKWEB_SCHEME_OPTION_STANDARD时，应该设置此值。 | 607| ARKWEB_SCHEME_OPTION_CSP_BYPASSING | 如果设置了ARKWEB_SCHEME_OPTION_CSP_BYPASSING，则该scheme可以绕过内容安全策略（CSP）检查。 在大多数情况下，当设置了ARKWEB_SCHEME_OPTION_STANDARD时，不应设置此值。 | 608| ARKWEB_SCHEME_OPTION_FETCH_ENABLED | 如果设置了ARKWEB_SCHEME_OPTION_FETCH_ENABLED，则可以发起该scheme的FETCH API请求。 | 609| ARKWEB_SCHEME_OPTION_CODE_CACHE_ENABLED | 如果设置了ARKWEB_SCHEME_OPTION_CODE_CACHE_ENABLED，则该scheme的js资源支持生成code cache。 | 610 611 612### ArkWeb_ErrorCode 613 614``` 615enum ArkWeb_ErrorCode 616``` 617**描述：** 618 619定义ArkWeb NDK接口异常错误码。 620 621**系统能力：** SystemCapability.Web.Webview.Core 622 623**起始版本：** 12 624 625| 枚举值 | 描述 | 626| -------- | -------- | 627| ARKWEB_SUCCESS | 成功. | 628| ARKWEB_INIT_ERROR | 初始化失败. | 629| ARKWEB_ERROR_UNKNOWN | 未知错误。 | 630| ARKWEB_INVALID_PARAM | 参数无效。 | 631| ARKWEB_SCHEME_REGISTER_FAILED | 注册scheme的配置失败，应该在创建ArkWeb之前注册。 | 632| ARKWEB_INVALID_URL | 无效的URL。 | 633| ARKWEB_INVALID_COOKIE_VALUE | 无效的cookie值。 | 634 635 636### ArkWeb_NativeAPIVariantKind 637 638``` 639enum ArkWeb_NativeAPIVariantKind 640``` 641**描述：** 642 643定义Native API的类型枚举。 644 645**起始版本：** 12 646 647| 枚举值 | 描述 | 648| -------- | -------- | 649| ARKWEB_NATIVE_COMPONENT | component相关API类型。 | 650| ARKWEB_NATIVE_CONTROLLER | controller相关API类型。 | 651| ARKWEB_NATIVE_WEB_MESSAGE_PORT | webMessagePort相关API类型。 | 652| ARKWEB_NATIVE_WEB_MESSAGE | webMessage相关API类型。 | 653| ARKWEB_NATIVE_COOKIE_MANAGER | cookieManager相关API类型。 | 654 655 656### ArkWeb_NetError 657 658``` 659enum ArkWeb_NetError 660``` 661**描述：** 662 663定义ArkWeb网络协议栈错误码。 664 665**系统能力：** SystemCapability.Web.Webview.Core 666 667**起始版本：** 12 668 669| 枚举值 | 描述 | 670| -------- | -------- | 671| ARKWEB_NET_OK | 正常。 | 672| ARKWEB_ERR_IO_PENDING | 异步IO操作尚未完成。这通常并不表示致命错误。通常，这个错误将作为通知生成，以等待某个外部通知，表明IO操作最终已完成。 | 673| ARKWEB_ERR_FAILED | 发生了通用故障。 | 674| ARKWEB_ERR_ABORTED | 操作被中止（由于用户操作）。 | 675| ARKWEB_ERR_INVALID_ARGUMENT | 该函数的参数不正确。 | 676| ARKWEB_ERR_INVALID_HANDLE | 句柄或文件描述符无效。 | 677| ARKWEB_ERR_FILE_NOT_FOUND | 文件或目录无法找到。 | 678| ARKWEB_ERR_TIMED_OUT | 操作超时。 | 679| ARKWEB_ERR_FILE_TOO_LARGE | 文件过大。 | 680| ARKWEB_ERR_UNEXPECTED | 发生了一个意外的错误。这可能是由编程错误或无效的假设导致的。 | 681| ARKWEB_ERR_ACCESS_DENIED | 访问除网络外的资源被拒绝。 | 682| ARKWEB_ERR_NOT_IMPLEMENTED | 由于功能未实现，操作失败。 | 683| ARKWEB_ERR_INSUFFICIENT_RESOURCES | 没有足够的资源来完成操作。 | 684| ARKWEB_ERR_OUT_OF_MEMORY | 内存溢出。 | 685| ARKWEB_ERR_UPLOAD_FILE_CHANGED | 文件上传失败，因为文件的修改时间与预期不同。 | 686| ARKWEB_ERR_SOCKET_NOT_CONNECTED | socket未连接。 | 687| ARKWEB_ERR_FILE_EXISTS | 文件已存在。 | 688| ARKWEB_ERR_FILE_PATH_TOO_LONG | 文件路径或者文件名过长。 | 689| ARKWEB_ERR_FILE_NO_SPACE | 磁盘上剩余空间不足。 | 690| ARKWEB_ERR_FILE_VIRUS_INFECTED | 文件含有病毒。 | 691| ARKWEB_ERR_BLOCKED_BY_CLIENT | 客户端选择阻止该请求。 | 692| ARKWEB_ERR_NETWORK_CHANGED | 网络发生变化。 | 693| ARKWEB_ERR_BLOCKED_BY_ADMINISTRATOR | 请求被域管理员配置的URL阻止列表所阻止。 | 694| ARKWEB_ERR_SOCKET_CONNECTED | socket已连接。 | 695| ARKWEB_ERR_UPLOAD_STREAM_REWIND_NOT_SUPPORTED | 由于重试或重定向，需要重新读取上传流，但上传流不支持该操作，因此上传失败。 | 696| ARKWEB_ERR_CONTEXT_SHUT_DOWN | 请求失败，因为URLRequestContext正在关闭或已经关闭。 | 697| ARKWEB_ERR_BLOCKED_BY_RESPONSE | 请求失败，因为响应不满足要求（例如“X-Frame-Options”和“Content Security Policy”检查以及“Cross Origin Resource Policy”）。 | 698| ARKWEB_ERR_CLEARTEXT_NOT_PERMITTED | 由于系统策略禁止某些或所有明文请求，请求被阻止。 | 699| ARKWEB_ERR_BLOCKED_BY_CSP | 请求被内容安全策略阻止。 | 700| ARKWEB_ERR_H2_OR_QUIC_REQUIRED | 由于没有H/2或QUIC会话，请求被阻止。 | 701| ARKWEB_ERR_BLOCKED_BY_ORB | 请求被CORB或ORB阻止。 | 702| ARKWEB_ERR_CONNECTION_CLOSED | 连接已关闭（对应于TCP FIN）。 | 703| ARKWEB_ERR_CONNECTION_RESET | 连接被重置（对应于TCP RST）。 | 704| ARKWEB_ERR_CONNECTION_REFUSED | 连接尝试被拒绝。 | 705| ARKWEB_ERR_CONNECTION_ABORTED | 由于未收到发送数据的ACK而导致连接超时。这可能包括未收到ACK的FIN数据包。 | 706| ARKWEB_ERR_CONNECTION_FAILED | 连接尝试失败。 | 707| ARKWEB_ERR_NAME_NOT_RESOLVED | 域名无法解析。 | 708| ARKWEB_ERR_INTERNET_DISCONNECTED | 网络断开。 | 709| ARKWEB_ERR_SSL_PROTOCOL_ERROR | 发生了SSL协议错误。 | 710| ARKWEB_ERR_ADDRESS_INVALID | IP地址或端口号无效（例如，无法连接到IP地址0或端口0）。 | 711| ARKWEB_ERR_ADDRESS_UNREACHABLE | IP地址无法访问。这通常意味着没有到达指定主机或网络的路由。 | 712| ARKWEB_ERR_SSL_CLIENT_AUTH_CERT_NEEDED | 服务器请求SSL客户端身份验证的客户端证书。 | 713| ARKWEB_ERR_TUNNEL_CONNECTION_FAILED | 无法通过代理建立隧道连接。 | 714| ARKWEB_ERR_NO_SSL_VERSIONS_ENABLED | 未启用任何SSL协议版本。 | 715| ARKWEB_ERR_SSL_VERSION_OR_CIPHER_MISMATCH | 客户端和服务器不支持通用的SSL协议版本或密码套件。 | 716| ARKWEB_ERR_SSL_RENEGOTIATION_REQUESTED | 服务器请求重新协商（重新握手）。 | 717| ARKWEB_ERR_PROXY_AUTH_UNSUPPORTED | 代理请求进行身份验证（用于建立隧道，但使用的方法不受支持）。 | 718| ARKWEB_ERR_BAD_SSL_CLIENT_AUTH_CERT | SSL握手未能成功，原因是客户端证书不正确或缺失。 | 719| ARKWEB_ERR_CONNECTION_TIMED_OUT | 连接尝试超时。 | 720| ARKWEB_ERR_HOST_RESOLVER_QUEUE_TOO_LARGE | 有太多待处理的DNS解析，因此队列中的一个请求被中止了。 | 721| ARKWEB_ERR_SOCKS_CONNECTION_FAILED | 为目标主机建立到SOCKS代理服务器的连接失败。 | 722| ARKWEB_ERR_SOCKS_CONNECTION_HOST_UNREACHABLE | SOCKS代理服务器无法建立与目标主机的连接，因为该主机无法访问。 | 723| ARKWEB_ERR_ALPN_NEGOTIATION_FAILED | 协商备用协议的请求失败。 | 724| ARKWEB_ERR_SSL_NO_RENEGOTIATION | 对等端发送了SSL no_regregation警报消息。 | 725| ARKWEB_ERR_WINSOCK_UNEXPECTED_WRITTEN_BYTES | Winsock有时会报告写入的数据多于传递的数据。这可能是由于LSP损坏。 | 726| ARKWEB_ERR_SSL_DECOMPRESSION_FAILURE_ALERT | SSL对等端向我们发送了一个致命的decompression_failure警告。这通常发生在对等端错误地认为它支持DEFLATE压缩并选择它时。 | 727| ARKWEB_ERR_SSL_BAD_RECORD_MAC_ALERT | SSL对等端向我们发送了一个致命的bad_record_mac警告。这通常发生在错误支持DEFLATE的服务器上。 | 728| ARKWEB_ERR_PROXY_AUTH_REQUESTED | 代理请求身份验证（用于建立隧道）。 | 729| ARKWEB_ERR_PROXY_CONNECTION_FAILED | 无法创建到代理服务器的连接。在解析其名称或将其套接字连接到代理服务器时发生错误。请注意，这不包括HTTP代理的实际“CONNECT”方法期间的失败。 | 730| ARKWEB_ERR_MANDATORY_PROXY_CONFIGURATION_FAILED | 无法使用强制代理配置。目前，这意味着无法获取、解析或执行强制PAC脚本。 | 731| ARKWEB_ERR_PRECONNECT_MAX_SOCKET_LIMIT | 在预连接时，我们已达到套接字池的最大套接字限制。我们不再尝试预连接更多套接字。 | 732| ARKWEB_ERR_SSL_CLIENT_AUTH_PRIVATE_KEY_ACCESS_DENIED | 使用SSL客户端证书的私钥的权限被拒绝。 | 733| ARKWEB_ERR_SSL_CLIENT_AUTH_CERT_NO_PRIVATE_KEY | SSL客户端证书没有私钥。 | 734| ARKWEB_ERR_PROXY_CERTIFICATE_INVALID | HTTPS代理提供的证书无效。 | 735| ARKWEB_ERR_NAME_RESOLUTION_FAILED | 在尝试进行域名解析（DNS）时发生错误。 | 736| ARKWEB_ERR_NETWORK_ACCESS_DENIED | 访问网络的权限被拒绝。这用于区分很可能是由防火墙导致的错误和其他访问被拒绝的错误。另请参阅ERR_ACCESS_DENIED。 | 737| ARKWEB_ERR_TEMPORARILY_THROTTLED | 请求节流模块取消了此请求，以避免DDOS攻击。 | 738| ARKWEB_ERR_HTTPS_PROXY_TUNNEL_RESPONSE_REDIRECT | 通过HTTPS代理创建SSL隧道连接的请求收到了302（临时重定向）响应。响应体可能包含请求失败原因的说明。 | 739| ARKWEB_ERR_SSL_CLIENT_AUTH_SIGNATURE_FAILED | 我们无法使用客户端证书的私钥签署SSL客户端身份验证握手的CertificateVerify数据。 可能导致这种情况的原因包括用户隐式或显式地拒绝访问私钥，私钥可能无法用于签名，密钥可能依赖于已无效的缓存句柄，或者CSP不允许签署任意数据。 | 740| ARKWEB_ERR_MSG_TOO_BIG | 消息对于传输来说太大了。（例如，UDP消息超过了大小阈值）。 | 741| ARKWEB_ERR_WS_PROTOCOL_ERROR | Websocket协议错误。表示由于帧格式错误或其他协议违规，我们正在终止连接。 | 742| ARKWEB_ERR_ADDRESS_IN_USE | 当尝试绑定已使用的地址时返回。 | 743| ARKWEB_ERR_SSL_HANDSHAKE_NOT_COMPLETED | 由于SSL握手尚未完成，操作失败。 | 744| ARKWEB_ERR_SSL_BAD_PEER_PUBLIC_KEY | SSL对等方的公钥无效。 | 745| ARKWEB_ERR_SSL_PINNED_KEY_NOT_IN_CERT_CHAIN | 证书与主机名的内置公钥Pins不匹配。Pin在net/http/transport_security_state.cc中设置，并且要求在从叶节点到根节点的路径上存在一组公钥中的一个。 | 746| ARKWEB_ERR_CLIENT_AUTH_CERT_TYPE_UNSUPPORTED | 服务器请求客户端证书，但请求中未包含我们支持的任何类型。 | 747| ARKWEB_ERR_SSL_DECRYPT_ERROR_ALERT | SSL对等端向我们发送了一个致命的decrypt_error警告。这通常发生在对等端无法正确验证签名（在CertificateVerify或ServerKeyExchange中）或验证Finished消息时。 | 748| ARKWEB_ERR_WS_THROTTLE_QUEUE_TOO_LARGE | 待处理的WebSocketJob实例太多，因此新任务没有推送到队列中。 | 749| ARKWEB_ERR_SSL_SERVER_CERT_CHANGED | 在重新协商过程中，SSL服务器证书发生了更改。 | 750| ARKWEB_ERR_SSL_UNRECOGNIZED_NAME_ALERT | SSL服务器向我们发送了一个致命的unrecognized_name警告。 | 751| ARKWEB_ERR_SOCKET_SET_RECEIVE_BUFFER_SIZE_ERROR | 无法按照请求设置套接字的接收缓冲区大小。 | 752| ARKWEB_ERR_SOCKET_SET_SEND_BUFFER_SIZE_ERROR | 无法按照请求设置套接字的发送缓冲区大小。 | 753| ARKWEB_ERR_SOCKET_RECEIVE_BUFFER_SIZE_UNCHANGEABLE | 尽管setsockopt返回成功代码，但无法将套接字的接收缓冲区大小设置为所请求的值。 | 754| ARKWEB_ERR_SOCKET_SEND_BUFFER_SIZE_UNCHANGEABLE | 尽管setsockopt返回成功代码，但无法将套接字的发送缓冲区大小设置为所请求的值。 | 755| ARKWEB_ERR_SSL_CLIENT_AUTH_CERT_BAD_FORMAT | 无法将客户端证书从平台存储导入到SSL库中。 | 756| ARKWEB_ERR_ICANN_NAME_COLLISION | 将主机名解析为IP地址列表时，包含了IPv4地址“127.0.53.53”。这是ICANN推荐的一个特殊IP地址，用于指示存在名称冲突，并提醒管理员注意潜在问题。 | 757| ARKWEB_ERR_SSL_SERVER_CERT_BAD_FORMAT | SSL服务器提供了一个无法解码的证书。这不是一个证书错误代码，因为没有可用的X509Certificate对象。这个错误是致命的。 | 758| ARKWEB_ERR_CT_STH_PARSING_FAILED | Certificate Transparency:收到的Signed Tree Head无法解析。 | 759| ARKWEB_ERR_CT_STH_INCOMPLETE | 证书透明度：收到的已签名树头可以成功解析为JSON，但缺少某些字段。 | 760| ARKWEB_ERR_UNABLE_TO_REUSE_CONNECTION_FOR_PROXY_AUTH | 在AuthController用于生成凭据之前，尝试重用连接以发送代理身份验证凭据失败。调用者应该使用新连接重新使用控制器。此错误仅由网络堆栈内部使用。 | 761| ARKWEB_ERR_CT_CONSISTENCY_PROOF_PARSING_FAILED | 证书透明度：无法解析收到的一致性证明。 | 762| ARKWEB_ERR_SSL_OBSOLETE_CIPHER | SSL服务器要求一个已被移除的不受支持的密码套件。在这个密码套件被移除后的一两个版本更新中，作为回退策略，这个错误将被临时发出信号，之后回退策略将被移除。 | 763| ARKWEB_ERR_WS_UPGRADE | 当WebSocket握手成功完成并且连接已升级时，将使用此错误代码取消URLRequest。 | 764| ARKWEB_ERR_READ_IF_READY_NOT_IMPLEMENTED | Socket ReadIfReady支持尚未实现。这个错误不应该被用户看到，因为正常的Read方法将作为备选方案使用。 | 765| ARKWEB_ERR_NO_BUFFER_SPACE | 没有可用的套接字缓冲区空间。 | 766| ARKWEB_ERR_SSL_CLIENT_AUTH_NO_COMMON_ALGORITHMS | 我们的客户端证书私钥和服务器的首选项之间没有共同的签名算法。 | 767| ARKWEB_ERR_EARLY_DATA_REJECTED | TLS 1.3 Early Data被服务器拒绝。这将在从套接字返回任何数据之前收到。应该禁用Early Data并重试请求。 | 768| ARKWEB_ERR_WRONG_VERSION_ON_EARLY_DATA | 提供了TLS 1.3 Early Data，但服务器以TLS 1.2或更早版本进行响应。这是为了解决Early Data和TLS 1.2之间向后兼容问题的内部错误代码。 在套接字返回任何数据之前将收到此错误代码。应该禁用Early Data后重试请求。详情请参阅https://tools.ietf.org/html/rfc8446\#appendix-D.3。 | 769| ARKWEB_ERR_TLS13_DOWNGRADE_DETECTED | 启用了TLS 1.3，但协商了一个较低版本，并且服务器返回了一个值，表明它支持TLS 1.3。 这是TLS 1.3安全检查的一部分，但也可能表明用户位于一个有问题的TLS终止代理之后，该代理错误地实现了TLS 1.2。（参见https://crbug.com/boringssl/226） | 770| ARKWEB_ERR_SSL_KEY_USAGE_INCOMPATIBLE | 服务器的证书有一个与协商的TLS密钥交换方法不兼容的keyUsage扩展。 | 771| ARKWEB_ERR_INVALID_ECH_CONFIG_LIST | 通过DNS获取的ECHConfigList无法解析。 | 772| ARKWEB_ERR_ECH_NOT_NEGOTIATED | 已启用ECH（Encrypted Client Hello，加密客户端Hello），但服务器无法解密加密的ClientHello。 | 773| ARKWEB_ERR_ECH_FALLBACK_CERTIFICATE_INVALID | ECH（Encrypted Client Hello）已启用，但服务器无法解密加密的ClientHello，并且没有提供对公共名称有效的证书。 | 774| ARKWEB_ERR_CERT_COMMON_NAME_INVALID | 服务器响应了一个证书，其通用名称与主机名不匹配。这可能意味着：1. 攻击者已将我们的流量重定向到他们的服务器，并呈现了一个他们知道私钥的证书。<br/>1. 服务器配置错误，响应了错误的证书。3. 用户处于无线网络中，被重定向到网络的登录页面。4. 操作系统使用了DNS搜索后缀，而服务器没有为地址栏中的缩写名称提供证书。 | 775| ARKWEB_ERR_CERT_DATE_INVALID | 服务器以证书作为响应，但根据我们的时钟，该证书似乎尚未生效或已过期。这可能是以下情况之一：1. 攻击者提供了旧的证书，并设法获取了私钥。2. 服务器配置错误，没有提供有效的证书。3. 我们的时钟错误。 | 776| ARKWEB_ERR_CERT_AUTHORITY_INVALID | 服务器回应了一个由我们不信任的机构签名的证书。这可能意味着：1. 攻击者已经将真实的证书替换为包含其公钥并由其同伙签名的证书。<br/>1. 服务器运营商拥有一个来自我们不了解但应该信任的CA的合法证书。3. 服务器正在展示一个自签名证书，这无法抵御活跃攻击者（但可以挫败被动攻击者）。 | 777| ARKWEB_ERR_CERT_CONTAINS_ERRORS | 服务器返回的证书包含错误。此错误无法恢复。MSDN对此错误的描述如下："SSL证书包含错误。"注意：目前尚不清楚这与ERR_CERT_INVALID有何不同。 为了保持一致性，从现在开始，请使用ERR_CERT_INVALID代码代替此代码。 | 778| ARKWEB_ERR_CERT_NO_REVOCATION_MECHANISM | 该证书没有用于确定其是否被吊销的机制。实际上，此证书无法被吊销。 | 779| ARKWEB_ERR_CERT_UNABLE_TO_CHECK_REVOCATION | 此站点的安全证书的吊销信息不可用。这可能意味着：1. 攻击者已破解证书中的私钥，并阻止了我们尝试查明证书已被吊销的操作。2. 证书未被吊销，但吊销服务器繁忙或不可用。 | 780| ARKWEB_ERR_CERT_REVOKED | 服务器响应的证书已被吊销。我们有能力忽略此错误，但这可能不是正确的做法。 | 781| ARKWEB_ERR_CERT_INVALID | 服务器以无效的证书进行了响应。这个错误无法恢复。MSDN描述此错误如下："SSL证书无效。" | 782| ARKWEB_ERR_CERT_WEAK_SIGNATURE_ALGORITHM | 服务器使用弱签名算法签名的证书进行了响应。 | 783| ARKWEB_ERR_CERT_NON_UNIQUE_NAME | 证书中指定的主机名不是唯一的。 | 784| ARKWEB_ERR_CERT_WEAK_KEY | 服务器响应了一个包含弱密钥（例如，太小的RSA密钥）的证书。 | 785| ARKWEB_ERR_CERT_NAME_CONSTRAINT_VIOLATION | 证书中声明的DNS名称违反了名称约束。 | 786| ARKWEB_ERR_CERT_VALIDITY_TOO_LONG | 证书的有效期太长。 | 787| ARKWEB_ERR_CERTIFICATE_TRANSPARENCY_REQUIRED | 此连接需要证书透明度，但服务器未提供符合策略的CT信息。 | 788| ARKWEB_ERR_CERT_SYMANTEC_LEGACY | 证书链接到不再受信任的旧版Symantec根证书。 | 789| ARKWEB_ERR_CERT_KNOWN_INTERCEPTION_BLOCKED | 已知该证书被除设备所有者之外的其他实体拦截。 | 790| ARKWEB_ERR_SSL_OBSOLETE_VERSION_OR_CIPHER | 连接使用了SSL/TLS或加密算法的过时版本。 | 791| ARKWEB_ERR_CERT_END | 紧接在最后一个证书错误代码之后的值。 | 792| ARKWEB_ERR_INVALID_URL | URL无效。 | 793| ARKWEB_ERR_DISALLOWED_URL_SCHEME | URL的scheme不被允许。 | 794| ARKWEB_ERR_UNKNOWN_URL_SCHEME | 该URL的scheme未知。 | 795| ARKWEB_ERR_INVALID_REDIRECT | 尝试加载一个URL导致重定向到一个无效的URL。 | 796| ARKWEB_ERR_TOO_MANY_REDIRECTS | 尝试加载一个URL时发生了太多次重定向。 | 797| ARKWEB_ERR_UNSAFE_REDIRECT | 尝试加载某个URL时出现了不安全的重定向（例如，重定向到file://被视为不安全）。 | 798| ARKWEB_ERR_UNSAFE_PORT | 尝试加载带有不安全端口号的URL。 | 799| ARKWEB_ERR_INVALID_RESPONSE | 服务器的响应无效。 | 800| ARKWEB_ERR_INVALID_CHUNKED_ENCODING | 块传输编码中出现错误。 | 801| ARKWEB_ERR_METHOD_UNSUPPORTED | 服务器不支持该请求方法。 | 802| ARKWEB_ERR_UNEXPECTED_PROXY_AUTH | 响应是407（需要代理身份验证），但我们并没有将请求发送到代理。 | 803| ARKWEB_ERR_EMPTY_RESPONSE | 服务器关闭了连接而没有发送任何数据。 | 804| ARKWEB_ERR_RESPONSE_HEADERS_TOO_BIG | 响应的headers部分过大。 | 805| ARKWEB_ERR_PAC_SCRIPT_FAILED | PAC脚本的执行失败。 | 806| ARKWEB_ERR_REQUEST_RANGE_NOT_SATISFIABLE | 响应是416（请求的范围无法满足，服务器无法满足请求的范围）。 | 807| ARKWEB_ERR_MALFORMED_IDENTITY | 用于身份验证的身份无效。 | 808| ARKWEB_ERR_CONTENT_DECODING_FAILED | 响应体的内容解码失败。 | 809| ARKWEB_ERR_NETWORK_IO_SUSPENDED | 一个操作无法完成，因为所有网络IO都已挂起。 | 810| ARKWEB_ERR_SYN_REPLY_NOT_RECEIVED | 在流上未收到SYN_REPLY就接收到了FLIP数据。 | 811| ARKWEB_ERR_ENCODING_CONVERSION_FAILED | 将响应转换为目标编码失败。 | 812| ARKWEB_ERR_UNRECOGNIZED_FTP_DIRECTORY_LISTING_FORMAT | 服务器发送了一个我们无法理解的FTP目录列表格式。 | 813| ARKWEB_ERR_NO_SUPPORTED_PROXIES | 提供的列表中没有任何受支持的代理。 | 814| ARKWEB_ERR_HTTP2_PROTOCOL_ERROR | 存在一个HTTP/2协议错误。 | 815| ARKWEB_ERR_INVALID_AUTH_CREDENTIALS | 在HTTP认证过程中无法建立凭据。 | 816| ARKWEB_ERR_UNSUPPORTED_AUTH_SCHEME | 尝试了一种此计算机不支持的HTTP身份验证方案。 | 817| ARKWEB_ERR_ENCODING_DETECTION_FAILED | 检测响应的编码失败。 | 818| ARKWEB_ERR_MISSING_AUTH_CREDENTIALS | （GSSAPI）在HTTP身份验证期间没有可用的Kerberos凭据。 | 819| ARKWEB_ERR_UNEXPECTED_SECURITY_LIBRARY_STATUS | 返回了一个意外但已记录的SSPI或GSSAPI状态码。 | 820| ARKWEB_ERR_MISCONFIGURED_AUTH_ENVIRONMENT | 认证环境未正确设置（例如，找不到KDC或主体未知）。 | 821| ARKWEB_ERR_UNDOCUMENTED_SECURITY_LIBRARY_STATUS | 返回了一个未记录的SSPI或GSSAPI状态码。 | 822| ARKWEB_ERR_RESPONSE_BODY_TOO_BIG_TO_DRAIN | HTTP响应太大，无法完全读取。 | 823| ARKWEB_ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_LENGTH | HTTP响应包含了多个不同的Content-Length响应头。 | 824| ARKWEB_ERR_INCOMPLETE_HTTP2_HEADERS | 已经接收到HTTP/2的响应头，但并非全部——缺失了状态码或版本等响应头，因此我们期望更多的帧来完成它们。 | 825| ARKWEB_ERR_PAC_NOT_IN_DHCP | 无法从DHCP检索PAC URL配置。这可能表明检索DHCP配置失败，或者在DHCP中没有配置PAC URL。 | 826| ARKWEB_ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_DISPOSITION | HTTP响应包含多个Content-Disposition响应头。 | 827| ARKWEB_ERR_RESPONSE_HEADERS_MULTIPLE_LOCATION | HTTP响应包含了多个Location响应头。 | 828| ARKWEB_ERR_HTTP2_SERVER_REFUSED_STREAM | HTTP/2服务器在未处理请求的情况下拒绝了请求，并发送了带有错误代码NO_ERROR和低于与请求对应的流ID的Last-Stream-ID的GOAWAY帧， 表明该请求尚未处理，或者发送了带有错误代码REFUSED_STREAM的RST_STREAM帧。客户端可以重试（在不同的连接上）。请参阅RFC7540第8.1.4节。 | 829| ARKWEB_ERR_HTTP2_PING_FAILED | HTTP/2服务器未响应PING消息。 | 830| ARKWEB_ERR_CONTENT_LENGTH_MISMATCH | 当连接关闭时，HTTP响应主体传输的字节数少于Content-Length头中公布的字节数。 | 831| ARKWEB_ERR_INCOMPLETE_CHUNKED_ENCODING | HTTP响应体使用分块编码传输，但在连接关闭时，终止的零长度区块从未被发送。 | 832| ARKWEB_ERR_QUIC_PROTOCOL_ERROR | 存在QUIC协议错误。 | 833| ARKWEB_ERR_RESPONSE_HEADERS_TRUNCATED | HTTP响应头信息被文件结束符（EOF）截断。 | 834| ARKWEB_ERR_QUIC_HANDSHAKE_FAILED | QUIC加密握手失败。这意味着服务器无法读取发送的任何请求，因此它们可能会被重新发送。 | 835| ARKWEB_ERR_HTTP2_INADEQUATE_TRANSPORT_SECURITY | 传输安全性不适合HTTP/2版本。 | 836| ARKWEB_ERR_HTTP2_FLOW_CONTROL_ERROR | 对等方违反了HTTP/2流控制。 | 837| ARKWEB_ERR_HTTP2_FRAME_SIZE_ERROR | 对等方发送了大小不正确的HTTP/2帧。 | 838| ARKWEB_ERR_HTTP2_COMPRESSION_ERROR | 压缩HTTP/2响应头信息的解码或编码失败。 | 839| ARKWEB_ERR_PROXY_AUTH_REQUESTED_WITH_NO_CONNECTION | 请求的代理身份验证没有有效的客户端套接字句柄。 | 840| ARKWEB_ERR_HTTP_1_1_REQUIRED | 在HTTP/2会话中收到HTTP_1_1_REQUIRED错误代码。 | 841| ARKWEB_ERR_PROXY_HTTP_1_1_REQUIRED | 在通过HTTP/2会话代理时收到HTTP_1_1_REQUIRED错误代码。 | 842| ARKWEB_ERR_PAC_SCRIPT_TERMINATED | PAC脚本已终止并必须重新加载。 | 843| ARKWEB_ERR_INVALID_HTTP_RESPONSE | 服务器应返回HTTP/1.x响应，但未返回。而不是将其视为HTTP/0.9，返回此错误。 | 844| ARKWEB_ERR_CONTENT_DECODING_INIT_FAILED | 初始化内容解码失败。 | 845| ARKWEB_ERR_HTTP2_RST_STREAM_NO_ERROR_RECEIVED | 收到带有NO_ERROR错误代码的HTTP/2 RST_STREAM帧。此错误应由HTTP/2代码内部处理，而不应超过SpdyStream层。 | 846| ARKWEB_ERR_HTTP2_PUSHED_STREAM_NOT_AVAILABLE | 请求声明的推送流不再可用。 | 847| ARKWEB_ERR_HTTP2_CLAIMED_PUSHED_STREAM_RESET_BY_SERVER | 已声明推送的流，随后服务器将其重置。发生这种情况时，应该重试请求。 | 848| ARKWEB_ERR_TOO_MANY_RETRIES | 由于身份验证或证书无效，重试次数过多。 | 849| ARKWEB_ERR_HTTP2_STREAM_CLOSED | 在已关闭的流上收到一个HTTP/2帧。 | 850| ARKWEB_ERR_HTTP2_CLIENT_REFUSED_STREAM | 客户端拒绝了一个HTTP/2流。 | 851| ARKWEB_ERR_HTTP2_PUSHED_RESPONSE_DOES_NOT_MATCH | 基于匹配的URL和请求头，一个HTTP/2推送的流被请求所接收，但是推送的响应头并不匹配请求。 | 852| ARKWEB_ERR_HTTP_RESPONSE_CODE_FAILURE | 服务器返回了非2xx的HTTP响应代码。 | 853| ARKWEB_ERR_QUIC_UNKNOWN_CERT_ROOT | 在QUIC连接上展示的证书未链接到已知根证书，并且连接到的原始服务器不在允许未知根证书的域名列表中。 | 854| ARKWEB_ERR_QUIC_GOAWAY_REQUEST_CAN_BE_RETRIED | 已接收到一个GOAWAY帧，表明请求未得到处理，因此可以安全地在不同的连接上重试。 | 855| ARKWEB_ERR_TOO_MANY_ACCEPT_CH_RESTARTS | ACCEPT_CH重启已被触发太多次。 | 856| ARKWEB_ERR_INCONSISTENT_IP_ADDRESS_SPACE | 在相同的请求期间，远程端点的IP地址空间与先前观察到的值不同。任何受影响的请求的缓存条目都应被标记为无效。 | 857| ARKWEB_ERR_CACHED_IP_ADDRESS_SPACE_BLOCKED_BY_LOCAL_NETWORK_ACCESS_POLICY | 缓存的远程端点的IP地址空间被本地网络访问检查所阻止。 | 858| ARKWEB_ERR_CACHE_MISS | 缓存中没有请求的条目。 | 859| ARKWEB_ERR_CACHE_READ_FAILURE | 无法从磁盘缓存中读取。 | 860| ARKWEB_ERR_CACHE_WRITE_FAILURE | 无法写入磁盘缓存。 | 861| ARKWEB_ERR_CACHE_OPERATION_UNSUPPORTED | 此条目不支持此操作。 | 862| ARKWEB_ERR_CACHE_OPEN_FAILURE | 磁盘缓存无法打开此条目。 | 863| ARKWEB_ERR_CACHE_CREATE_FAILURE | 磁盘缓存无法创建此条目。 | 864| ARKWEB_ERR_CACHE_RACE | 多个事务正在竞相创建磁盘缓存条目。 | 865| ARKWEB_ERR_CACHE_CHECKSUM_READ_FAILURE | 缓存无法读取条目上的校验和记录。 | 866| ARKWEB_ERR_CACHE_CHECKSUM_MISMATCH | 缓存发现一个具有无效校验和的条目。 | 867| ARKWEB_ERR_CACHE_LOCK_TIMEOUT | HTTP缓存的内部错误代码。 | 868| ARKWEB_ERR_CACHE_AUTH_FAILURE_AFTER_READ | 在事务读取某些数据后收到质询，但凭据不可用。 | 869| ARKWEB_ERR_CACHE_ENTRY_NOT_SUITABLE | 针对HTTP缓存的一个内部使用的、非标准的错误代码。 | 870| ARKWEB_ERR_CACHE_DOOM_FAILURE | 磁盘缓存无法删除此条目。 | 871| ARKWEB_ERR_CACHE_OPEN_OR_CREATE_FAILURE | 磁盘缓存无法打开或创建此条目。 | 872| ARKWEB_ERR_INSECURE_RESPONSE | 服务器的响应不安全（例如，存在证书错误）。 | 873| ARKWEB_ERR_NO_PRIVATE_KEY_FOR_CERT | 尝试导入客户端证书失败，因为用户的密钥数据库缺少相应的私钥。 | 874| ARKWEB_ERR_ADD_USER_CERT_FAILED | 向操作系统证书数据库添加证书时发生错误。 | 875| ARKWEB_ERR_INVALID_SIGNED_EXCHANGE | 处理已签名的交换时发生错误。 | 876| ARKWEB_ERR_INVALID_WEB_BUNDLE | 处理Web Bundle源时发生错误。 | 877| ARKWEB_ERR_TRUST_TOKEN_OPERATION_FAILED | 执行Trust Tokens协议操作的请求失败（原因包括：预置条件失败、内部错误、不良响应）。 | 878| ARKWEB_ERR_TRUST_TOKEN_OPERATION_SUCCESS_WITHOUT_SENDING_REQUEST | 在处理一个与Trust Tokens协议相关的操作执行请求时，系统能够执行该请求中的Trust Tokens操作，但并没有将请求发送到其指定的目的地。 | 879| ARKWEB_ERR_FTP_FAILED | FTP控制连接命令失败的通用错误。如果可能的话，请使用或添加一个更具体的错误代码。 | 880| ARKWEB_ERR_FTP_SERVICE_UNAVAILABLE | 服务器目前无法满足请求。这是一个临时错误。FTP响应代码421。 | 881| ARKWEB_ERR_FTP_TRANSFER_ABORTED | 服务器已中止传输。FTP响应代码426。 | 882| ARKWEB_ERR_FTP_FILE_BUSY | 文件正在使用中，或在打开文件时发生了一些其他临时错误条件。FTP响应代码450。 | 883| ARKWEB_ERR_FTP_SYNTAX_ERROR | 由于语法错误，服务器拒绝了我们的命令。FTP响应代码500、501。 | 884| ARKWEB_ERR_FTP_COMMAND_UNSUPPORTED | 服务器不支持我们发出的命令。FTP响应代码502、504。 | 885| ARKWEB_ERR_FTP_BAD_COMMAND_SEQUENCE | 服务器拒绝了我们的命令，因为我们没有按照正确的顺序发出命令。FTP响应代码503。 | 886| ARKWEB_ERR_PKCS12_IMPORT_BAD_PASSWORD | 由于密码不正确，PKCS \#12导入失败。 | 887| ARKWEB_ERR_PKCS12_IMPORT_FAILED | 由于其他错误，PKCS \#12导入失败。 | 888| ARKWEB_ERR_IMPORT_CA_CERT_NOT_CA | CA导入失败——不是CA证书。 | 889| ARKWEB_ERR_IMPORT_CERT_ALREADY_EXISTS | 导入失败——数据库中已存在证书。 | 890| ARKWEB_ERR_IMPORT_CA_CERT_FAILED | 由于其他错误，CA导入失败。 | 891| ARKWEB_ERR_IMPORT_SERVER_CERT_FAILED | 由于某些内部错误，服务器证书导入失败。 | 892| ARKWEB_ERR_PKCS12_IMPORT_INVALID_MAC | PKCS \#12导入失败，因为MAC（消息认证码）无效。 | 893| ARKWEB_ERR_PKCS12_IMPORT_INVALID_FILE | PKCS \#12导入失败，因为文件无效或已损坏。 | 894| ARKWEB_ERR_PKCS12_IMPORT_UNSUPPORTED | 由于不支持的特性，PKCS \#12导入失败。 | 895| ARKWEB_ERR_KEY_GENERATION_FAILED | 密钥生成失败。 | 896| ARKWEB_ERR_PRIVATE_KEY_EXPORT_FAILED | 无法导出私钥。 | 897| ARKWEB_ERR_SELF_SIGNED_CERT_GENERATION_FAILED | 自签名证书生成失败。 | 898| ARKWEB_ERR_CERT_DATABASE_CHANGED | 证书数据库已发生某种更改。 | 899| ARKWEB_ERR_CERT_VERIFIER_CHANGED | 证书验证配置已发生某种更改。 | 900| ARKWEB_ERR_DNS_MALFORMED_RESPONSE | DNS解析程序收到格式错误的响应。 | 901| ARKWEB_ERR_DNS_SERVER_REQUIRES_TCP | DNS服务器需要TCP。 | 902| ARKWEB_ERR_DNS_SERVER_FAILED | DNS服务器失败。对于以下所有错误情况，都会返回此错误：1 - 格式错误 - 名称服务器无法解释查询。 2 - 服务器故障 - 名称服务器由于自身问题无法处理这个查询。4 - 未实现 - 名称服务器不支持请求的查询类型。 5 - 拒绝 - 名称服务器出于策略原因拒绝执行指定的操作。 | 903| ARKWEB_ERR_DNS_TIMED_OUT | DNS事务超时。 | 904| ARKWEB_ERR_DNS_CACHE_MISS | 对于只查询本地源的查找，在缓存或其他本地源中未找到该条目。 | 905| ARKWEB_ERR_DNS_SEARCH_EMPTY | 后缀搜索列表规则阻止了给定主机名的解析。 | 906| ARKWEB_ERR_DNS_SORT_ERROR | 未能根据RFC3484对地址进行排序。 | 907| ARKWEB_ERR_DNS_SECURE_RESOLVER_HOSTNAME_RESOLUTION_FAILED | 未能解析DNS-over-HTTPS服务器的主机名。 | 908| ARKWEB_ERR_DNS_NAME_HTTPS_ONLY | DNS已识别请求因不安全的连接（http/ws）而被禁止。应用程序应该像处理HTTP重定向一样处理这个错误，将连接重定向到安全的https或wss。 | 909| ARKWEB_ERR_DNS_REQUEST_CANCELED | 与此任务相关的所有DNS请求已被取消。 | 910| ARKWEB_ERR_DNS_NO_MATCHING_SUPPORTED_ALPN | HTTPS记录的主机名解析预期未能使用受支持协议的ALPN值进行解析。 | 911 912### ArkWeb_ResourceType 913 914``` 915enum ArkWeb_ResourceType 916``` 917**描述：** 918 919请求的资源类型。 920 921这些常量与Chromium中的ResourceType的对应项相匹配，不应重新编号。 922 923**系统能力：** SystemCapability.Web.Webview.Core 924 925**起始版本：** 12 926 927| 枚举值 | 描述 | 928| -------- | -------- | 929| MAIN_FRAME | 顶层页面。 | 930| SUB_FRAME | Frame或Iframe。 | 931| STYLE_SHEET | CSS样式表。 | 932| SCRIPT | 外部脚本。 | 933| IMAGE | 图片（jpg/gif/png/以及其他）。 | 934| FONT_RESOURCE | 字体。 | 935| SUB_RESOURCE | 其他子资源。如果实际类型未知，则是默认类型。 | 936| OBJECT | 插件的Object（或embed）标签，或者插件请求的资源。 | 937| MEDIA | 媒体资源。 | 938| WORKER | 专用工作线程的主资源。 | 939| SHARED_WORKER | 共享工作线程的主资源。 | 940| PREFETCH | 明确的预取请求。 | 941| FAVICON | 网站图标。 | 942| XHR | XMLHttpRequest。 | 943| PING | /sendBeacon的Ping请求。 | 944| SERVICE_WORKER | service worker的主资源。 | 945| CSP_REPORT | 内容安全策略违规报告。 | 946| PLUGIN_RESOURCE | 插件请求的资源。 | 947| NAVIGATION_PRELOAD_MAIN_FRAME | 触发service worker预热的主frame跳转请求。 | 948| NAVIGATION_PRELOAD_SUB_FRAME | 触发service worker预热的子frame跳转请求。 | 949 950 951### ArkWeb_WebMessageType 952 953``` 954enum ArkWeb_WebMessageType 955``` 956**描述：** 957 958Post Message数据类型。 959 960**起始版本：** 12 961 962| 枚举值 | 描述 | 963| -------- | -------- | 964| ARKWEB_NONE | 错误数据。 | 965| ARKWEB_STRING | 字符串数据类型。 | 966| ARKWEB_BUFFER | 字节流数据类型。 | 967 968 969## 函数说明 970 971 972### OH_ArkWeb_ClearSchemeHandlers() 973 974``` 975int32_t OH_ArkWeb_ClearSchemeHandlers (const char * webTag) 976``` 977**描述：** 978 979清除为指定web注册的SchemeHandler。 980 981**系统能力：** SystemCapability.Web.Webview.Core 982 983**起始版本：** 12 984 985**参数:** 986 987| 名称 | 描述 | 988| -------- | -------- | 989| webTag | Web组件的标签名称，用于标识某个唯一组件，由开发者来保证名称唯一性。 | 990 991**返回：** 992 993如果返回0，表示成功；返回17100101，表示参数无效。 994 995 996### OH_ArkWeb_CreateResponse() 997 998``` 999void OH_ArkWeb_CreateResponse (ArkWeb_Response ** response) 1000``` 1001**描述：** 1002 1003为被拦截的请求创建一个ArkWeb_Response对象。 1004 1005**系统能力：** SystemCapability.Web.Webview.Core 1006 1007**起始版本：** 12 1008 1009**参数:** 1010 1011| 名称 | 描述 | 1012| -------- | -------- | 1013| response | 返回创建的ArkWeb_Response。在不需要时使用OH_ArkWeb_DestoryResponse进行销毁。 | 1014 1015 1016### OH_ArkWeb_CreateSchemeHandler() 1017 1018``` 1019void OH_ArkWeb_CreateSchemeHandler (ArkWeb_SchemeHandler ** schemeHandler) 1020``` 1021**描述：** 1022 1023创建一个ArkWeb_SchemeHandler对象。 1024 1025**系统能力：** SystemCapability.Web.Webview.Core 1026 1027**起始版本：** 12 1028 1029**参数:** 1030 1031| 名称 | 描述 | 1032| -------- | -------- | 1033| schemeHandler | 返回创建的ArkWeb_SchemeHandler。在不需要时使用OH_ArkWeb_DestoryschemeHandler销毁它。 | 1034 1035 1036### OH_ArkWeb_DestroyResponse() 1037 1038``` 1039void OH_ArkWeb_DestroyResponse (ArkWeb_Response * response) 1040``` 1041**描述：** 1042 1043销毁一个ArkWeb_Response对象。 1044 1045**系统能力：** SystemCapability.Web.Webview.Core 1046 1047**起始版本：** 12 1048 1049**参数:** 1050 1051| 名称 | 描述 | 1052| -------- | -------- | 1053| response | 待销毁的ArkWeb_Response。 | 1054 1055 1056### OH_ArkWeb_DestroySchemeHandler() 1057 1058``` 1059void OH_ArkWeb_DestroySchemeHandler (ArkWeb_SchemeHandler * schemeHandler) 1060``` 1061**描述：** 1062 1063销毁一个ArkWeb_SchemeHandler对象。 1064 1065**系统能力：** SystemCapability.Web.Webview.Core 1066 1067**起始版本：** 12 1068 1069**参数:** 1070 1071| 名称 | 描述 | 1072| -------- | -------- | 1073| schemeHandler | 待销毁的ArkWeb_SchemeHandler。 | 1074 1075 1076### OH_ArkWeb_GetNativeAPI() 1077 1078``` 1079ArkWeb_AnyNativeAPI* OH_ArkWeb_GetNativeAPI (ArkWeb_NativeAPIVariantKind type) 1080``` 1081**描述：** 1082 1083根据传入的API类型，获取对应的Native API结构体。 1084 1085**系统能力：** SystemCapability.Web.Webview.Core 1086 1087**起始版本：** 12 1088 1089**参数:** 1090 1091| 名称 | 描述 | 1092| -------- | -------- | 1093| type | ArkWeb支持的Native API类型。 | 1094 1095**返回：** 1096 1097根据传入的API类型，返回对应的Native API结构体指针，结构体第一个成员为当前结构体的大小。 1098 1099 1100### OH_ArkWeb_RegisterCustomSchemes() 1101 1102``` 1103int32_t OH_ArkWeb_RegisterCustomSchemes (const char * scheme, int32_t option ) 1104``` 1105**描述：** 1106 1107将custom scheme注册到ArkWeb。 1108 1109对于内置的HTTP、HTTPS、FILE、FTP、ABOUT和DATA协议，不应调用此函数。 1110 1111此函数应在主线程上调用并且需要在内核初始化之前调用。 1112 1113**系统能力：** SystemCapability.Web.Webview.Core 1114 1115**起始版本：** 12 1116 1117**参数:** 1118 1119| 名称 | 描述 | 1120| -------- | -------- | 1121| scheme | 待注册的scheme。 | 1122| option | scheme的配置（行为）。 | 1123 1124**返回：** 1125 1126如果返回0，表示成功；返回17100100，表示未知错误；返回17100101，表示参数无效；返回17100102，表示注册scheme的配置失败，应该在创建ArkWeb之前注册。 1127 1128 1129### OH_ArkWeb_ReleaseByteArray() 1130 1131``` 1132void OH_ArkWeb_ReleaseByteArray (uint8_t * byteArray) 1133``` 1134**描述：** 1135 1136释放由NDK接口创建的字节数组。 1137 1138**系统能力：** SystemCapability.Web.Webview.Core 1139 1140**起始版本：** 12 1141 1142**参数:** 1143 1144| 名称 | 描述 | 1145| -------- | -------- | 1146| byteArray | 待释放的字节数组。 | 1147 1148 1149### OH_ArkWeb_ReleaseString() 1150 1151``` 1152void OH_ArkWeb_ReleaseString (char * string) 1153``` 1154**描述：** 1155 1156释放由NDK接口创建的字符串 1157 1158**系统能力：** SystemCapability.Web.Webview.Core 1159 1160**起始版本：** 12 1161 1162**参数:** 1163 1164| 名称 | 描述 | 1165| -------- | -------- | 1166| string | 待释放的字符串。 | 1167 1168 1169### OH_ArkWeb_SetSchemeHandler() 1170 1171``` 1172bool OH_ArkWeb_SetSchemeHandler (const char * scheme, const char * webTag, ArkWeb_SchemeHandler * schemeHandler ) 1173``` 1174**描述：** 1175 1176为指定scheme设置一个ArkWeb_SchemeHandler以拦截该scheme类型的请求。 1177 1178应该在创建BrowserContext之后设置SchemeHandler。 1179 1180可以使用WebviewController.initializeWebEngine来初始化BrowserContext而无需创建ArkWeb。 1181 1182**系统能力：** SystemCapability.Web.Webview.Core 1183 1184**起始版本：** 12 1185 1186**参数:** 1187 1188| 名称 | 描述 | 1189| -------- | -------- | 1190| scheme | 需要被拦截的scheme。 | 1191| webTag | Web组件的标签名称，用于标识某个唯一组件，由开发者来保证名称唯一性。 | 1192| schemeHandler | 该scheme的拦截器ArkWeb_SchemeHandler。只有从指定web触发的请求才会通过这个schemeHandler进行通知。 | 1193 1194**返回：** 1195 1196如果为指定scheme设置SchemeHandler成功，则返回true，否则返回false。 1197 1198 1199### OH_ArkWebHttpBodyStream_GetPosition() 1200 1201``` 1202uint64_t OH_ArkWebHttpBodyStream_GetPosition (const ArkWeb_HttpBodyStream * httpBodyStream) 1203``` 1204**描述：** 1205 1206获取httpBodyStream当前的读取位置。 1207 1208**系统能力：** SystemCapability.Web.Webview.Core 1209 1210**起始版本：** 12 1211 1212**参数:** 1213 1214| 名称 | 描述 | 1215| -------- | -------- | 1216| httpBodyStream | ArkWeb_HttpBodyStream。 | 1217 1218**返回：** 1219 1220httpBodyStream当前的读取位置。如果httpBodyStream无效，则位置为0。 1221 1222 1223### OH_ArkWebHttpBodyStream_GetSize() 1224 1225``` 1226uint64_t OH_ArkWebHttpBodyStream_GetSize (const ArkWeb_HttpBodyStream * httpBodyStream) 1227``` 1228**描述：** 1229 1230获取httpBodyStream的大小。 1231 1232当数据以分块的形式传输或httpBodyStream无效时，始终返回0。 1233 1234**系统能力：** SystemCapability.Web.Webview.Core 1235 1236**起始版本：** 12 1237 1238**参数:** 1239 1240| 名称 | 描述 | 1241| -------- | -------- | 1242| httpBodyStream | ArkWeb_HttpBodyStream。 | 1243 1244**返回：** 1245 1246httpBodyStream的大小。 1247 1248 1249### OH_ArkWebHttpBodyStream_GetUserData() 1250 1251``` 1252void* OH_ArkWebHttpBodyStream_GetUserData (const ArkWeb_HttpBodyStream * httpBodyStream) 1253``` 1254**描述：** 1255 1256从ArkWeb_HttpBodyStream获取用户数据。 1257 1258**系统能力：** SystemCapability.Web.Webview.Core 1259 1260**起始版本：** 12 1261 1262**参数:** 1263 1264| 名称 | 描述 | 1265| -------- | -------- | 1266| httpBodyStream | ArkWeb_HttpBodyStream。 | 1267 1268**返回：** 1269 1270设置的用户数据。 1271 1272 1273### OH_ArkWebHttpBodyStream_Init() 1274 1275``` 1276int32_t OH_ArkWebHttpBodyStream_Init (ArkWeb_HttpBodyStream * httpBodyStream, ArkWeb_HttpBodyStreamInitCallback initCallback ) 1277``` 1278**描述：** 1279 1280初始化ArkWeb_HttpBodyStream。 1281 1282在调用任何其他函数之前，必须调用此函数。该接口需要在IO线程调用。 1283 1284**系统能力：** SystemCapability.Web.Webview.Core 1285 1286**起始版本：** 12 1287 1288**参数:** 1289 1290| 名称 | 描述 | 1291| -------- | -------- | 1292| httpBodyStream | ArkWeb_HttpBodyStream。 | 1293| initCallback | 初始化的回调函数。 | 1294 1295**返回：** 1296 1297如果返回0，表示成功；返回17100101，表示参数无效。 1298 1299 1300### OH_ArkWebHttpBodyStream_IsChunked() 1301 1302``` 1303bool OH_ArkWebHttpBodyStream_IsChunked (const ArkWeb_HttpBodyStream * httpBodyStream) 1304``` 1305**描述：** 1306 1307获取httpBodyStream是否采用分块传输。 1308 1309**系统能力：** SystemCapability.Web.Webview.Core 1310 1311**起始版本：** 12 1312 1313**参数:** 1314 1315| 名称 | 描述 | 1316| -------- | -------- | 1317| httpBodyStream | ArkWeb_HttpBodyStream。 | 1318 1319**返回：** 1320 1321如果采用分块传输则返回true;否则返回false。 1322 1323 1324### OH_ArkWebHttpBodyStream_IsEof() 1325 1326``` 1327bool OH_ArkWebHttpBodyStream_IsEof (const ArkWeb_HttpBodyStream * httpBodyStream) 1328``` 1329**描述：** 1330 1331如果httpBodyStream中的所有数据都已被读取，则返回true。 1332 1333对于分块传输类型的httpBodyStream，在第一次读取尝试之前返回false。 1334 1335**系统能力：** SystemCapability.Web.Webview.Core 1336 1337**起始版本：** 12 1338 1339**参数:** 1340 1341| 名称 | 描述 | 1342| -------- | -------- | 1343| httpBodyStream | ArkWeb_HttpBodyStream。 | 1344 1345**返回：** 1346 1347如果所有数据都已被读取则返回true；否则返回false。 1348 1349 1350### OH_ArkWebHttpBodyStream_IsInMemory() 1351 1352``` 1353bool OH_ArkWebHttpBodyStream_IsInMemory (const ArkWeb_HttpBodyStream * httpBodyStream) 1354``` 1355**描述：** 1356 1357如果httpBodyStream中的上传数据完全在内存中，并且所有读取请求都将同步成功，则返回true。 1358 1359对于分块传输类型的数据，预期返回false。 1360 1361**系统能力：** SystemCapability.Web.Webview.Core 1362 1363**起始版本：** 12 1364 1365**参数:** 1366 1367| 名称 | 描述 | 1368| -------- | -------- | 1369| httpBodyStream | ArkWeb_HttpBodyStream。 | 1370 1371**返回：** 1372 1373如果上传数据完全在内存中则返回true；否则返回false。 1374 1375 1376### OH_ArkWebHttpBodyStream_Read() 1377 1378``` 1379void OH_ArkWebHttpBodyStream_Read (const ArkWeb_HttpBodyStream * httpBodyStream, uint8_t * buffer, int bufLen ) 1380``` 1381**描述：** 1382 1383将请求的上传数据读取到buffer。 1384 1385buffer的大小必须大于bufLen。我们将从工作线程读取数据到buffer，因此在回调函数返回之前，不应在其他线程中使用buffer，以避免并发问题。 1386 1387**系统能力：** SystemCapability.Web.Webview.Core 1388 1389**起始版本：** 12 1390 1391**参数:** 1392 1393| 名称 | 描述 | 1394| -------- | -------- | 1395| httpBodyStream | ArkWeb_HttpBodyStream。 | 1396| buffer | 接收数据的buffer。 | 1397| bufLen | 要读取的字节的大小。 | 1398 1399 1400### OH_ArkWebHttpBodyStream_SetReadCallback() 1401 1402``` 1403int32_t OH_ArkWebHttpBodyStream_SetReadCallback (ArkWeb_HttpBodyStream * httpBodyStream, ArkWeb_HttpBodyStreamReadCallback readCallback ) 1404``` 1405**描述：** 1406 1407为OH_ArkWebHttpBodyStream_Read设置回调函数。 1408 1409OH_ArkWebHttpBodyStream_Read的结果将通过readCallback通知给调用者。 1410 1411该回调函数将在与OH_ArkWebHttpBodyStream_Read相同的线程中运行。 1412 1413**系统能力：** SystemCapability.Web.Webview.Core 1414 1415**起始版本：** 12 1416 1417**参数:** 1418 1419| 名称 | 描述 | 1420| -------- | -------- | 1421| httpBodyStream | ArkWeb_HttpBodyStream。 | 1422| readCallback | OH_ArkWebHttpBodyStream_Read的回调函数。 | 1423 1424**返回：** 1425 1426如果返回0，表示成功；返回17100101，表示参数无效。 1427 1428 1429### OH_ArkWebHttpBodyStream_SetUserData() 1430 1431``` 1432int32_t OH_ArkWebHttpBodyStream_SetUserData (ArkWeb_HttpBodyStream * httpBodyStream, void * userData ) 1433``` 1434**描述：** 1435 1436将一个用户数据设置到ArkWeb_HttpBodyStream对象中。 1437 1438**系统能力：** SystemCapability.Web.Webview.Core 1439 1440**起始版本：** 12 1441 1442**参数:** 1443 1444| 名称 | 描述 | 1445| -------- | -------- | 1446| httpBodyStream | ArkWeb_HttpBodyStream。 | 1447| userData | 要设置的用户数据。 | 1448 1449**返回：** 1450 1451如果返回0，表示成功；返回17100101，表示参数无效。 1452 1453 1454### OH_ArkWebRequestHeaderList_Destroy() 1455 1456``` 1457void OH_ArkWebRequestHeaderList_Destroy (ArkWeb_RequestHeaderList * requestHeaderList) 1458``` 1459**描述：** 1460 1461销毁ArkWeb_RequestHeaderList对象。 1462 1463**系统能力：** SystemCapability.Web.Webview.Core 1464 1465**起始版本：** 12 1466 1467**参数:** 1468 1469| 名称 | 描述 | 1470| -------- | -------- | 1471| requestHeaderList | 将被销毁的ArkWeb_RequestHeaderList。 | 1472 1473 1474### OH_ArkWebRequestHeaderList_GetHeader() 1475 1476``` 1477void OH_ArkWebRequestHeaderList_GetHeader (const ArkWeb_RequestHeaderList * requestHeaderList, int32_t index, char ** key, char ** value ) 1478``` 1479**描述：** 1480 1481获取指定的请求头。 1482 1483**系统能力：** SystemCapability.Web.Webview.Core 1484 1485**起始版本：** 12 1486 1487**参数:** 1488 1489| 名称 | 描述 | 1490| -------- | -------- | 1491| requestHeaderList | 请求头列表。 | 1492| index | 请求头的索引。 | 1493| key | 请求头的键（key）。调用者必须使用OH_ArkWeb_ReleaseString函数来释放这个字符串。 | 1494| value | 请求头的值（value）。调用者必须使用OH_ArkWeb_ReleaseString函数来释放这个字符串。 | 1495 1496 1497### OH_ArkWebRequestHeaderList_GetSize() 1498 1499``` 1500int32_t OH_ArkWebRequestHeaderList_GetSize (const ArkWeb_RequestHeaderList * requestHeaderList) 1501``` 1502**描述：** 1503 1504获取请求头列表的大小。 1505 1506**系统能力：** SystemCapability.Web.Webview.Core 1507 1508**起始版本：** 12 1509 1510**参数:** 1511 1512| 名称 | 描述 | 1513| -------- | -------- | 1514| requestHeaderList | 请求头的列表。 | 1515 1516**返回：** 1517 1518请求头的大小。如果requestHeaderList无效，则为-1。 1519 1520 1521### OH_ArkWebResourceHandler_Destroy() 1522 1523``` 1524int32_t OH_ArkWebResourceHandler_Destroy (const ArkWeb_ResourceHandler * resourceHandler) 1525``` 1526**描述：** 1527 1528销毁一个ArkWeb_ResourceHandler对象。 1529 1530**系统能力：** SystemCapability.Web.Webview.Core 1531 1532**起始版本：** 12 1533 1534**参数:** 1535 1536| 名称 | 描述 | 1537| -------- | -------- | 1538| resourceHandler | ArkWeb_ResourceHandler。 | 1539 1540**返回：** 1541 1542如果返回0，表示成功；返回17100101，表示参数无效。 1543 1544 1545### OH_ArkWebResourceHandler_DidFailWithError() 1546 1547``` 1548int32_t OH_ArkWebResourceHandler_DidFailWithError (const ArkWeb_ResourceHandler * resourceHandler, ArkWeb_NetError errorCode ) 1549``` 1550**描述：** 1551 1552通知ArkWeb内核被拦截请求应该失败。 1553 1554**系统能力：** SystemCapability.Web.Webview.Core 1555 1556**起始版本：** 12 1557 1558**参数:** 1559 1560| 名称 | 描述 | 1561| -------- | -------- | 1562| resourceHandler | 该请求的ArkWeb_ResourceHandler。 | 1563| errorCode | 该请求的错误码。请参考[arkweb_net_error_list.h](arkweb__net__error__list_8h.md)。 | 1564 1565**返回：** 1566 1567如果返回0，表示成功；返回17100101，表示参数无效。 1568 1569 1570### OH_ArkWebResourceHandler_DidFinish() 1571 1572``` 1573int32_t OH_ArkWebResourceHandler_DidFinish (const ArkWeb_ResourceHandler * resourceHandler) 1574``` 1575**描述：** 1576 1577通知ArkWeb内核被拦截的请求已经完成，并且没有更多的数据可用。 1578 1579**系统能力：** SystemCapability.Web.Webview.Core 1580 1581**起始版本：** 12 1582 1583**参数:** 1584 1585| 名称 | 描述 | 1586| -------- | -------- | 1587| resourceHandler | 该请求的ArkWeb_ResourceHandler。 | 1588 1589**返回：** 1590 1591如果返回0，表示成功；返回17100101，表示参数无效。 1592 1593 1594### OH_ArkWebResourceHandler_DidReceiveData() 1595 1596``` 1597int32_t OH_ArkWebResourceHandler_DidReceiveData (const ArkWeb_ResourceHandler * resourceHandler, const uint8_t * buffer, int64_t bufLen ) 1598``` 1599**描述：** 1600 1601将构造的响应体传递给被拦截的请求。 1602 1603**系统能力：** SystemCapability.Web.Webview.Core 1604 1605**起始版本：** 12 1606 1607**参数:** 1608 1609| 名称 | 描述 | 1610| -------- | -------- | 1611| resourceHandler | 该请求的ArkWeb_ResourceHandler。 | 1612| buffer | 要发送的buffer数据。 | 1613| bufLen | buffer的大小。 | 1614 1615**返回：** 1616 1617如果返回0，表示成功；返回17100101，表示参数无效。 1618 1619 1620### OH_ArkWebResourceHandler_DidReceiveResponse() 1621 1622``` 1623int32_t OH_ArkWebResourceHandler_DidReceiveResponse (const ArkWeb_ResourceHandler * resourceHandler, const ArkWeb_Response * response ) 1624``` 1625**描述：** 1626 1627将构造的响应头传递给被拦截的请求。 1628 1629**系统能力：** SystemCapability.Web.Webview.Core 1630 1631**起始版本：** 12 1632 1633**参数:** 1634 1635| 名称 | 描述 | 1636| -------- | -------- | 1637| resourceHandler | 该请求的ArkWeb_ResourceHandler。 | 1638| response | 该拦截请求的ArkWeb_Response。 | 1639 1640**返回：** 1641 1642如果返回0，表示成功；返回17100101，表示参数无效。 1643 1644 1645### OH_ArkWebResourceRequest_Destroy() 1646 1647``` 1648int32_t OH_ArkWebResourceRequest_Destroy (const ArkWeb_ResourceRequest * resourceRequest) 1649``` 1650**描述：** 1651 1652销毁ArkWeb_ResourceRequest对象。 1653 1654**系统能力：** SystemCapability.Web.Webview.Core 1655 1656**起始版本：** 12 1657 1658**参数:** 1659 1660| 名称 | 描述 | 1661| -------- | -------- | 1662| resourceRequest | ArkWeb_ResourceRequest。 | 1663 1664**返回：** 1665 1666如果返回0，表示成功；返回17100101，表示参数无效。 1667 1668 1669### OH_ArkWebResourceRequest_DestroyHttpBodyStream() 1670 1671``` 1672void OH_ArkWebResourceRequest_DestroyHttpBodyStream (ArkWeb_HttpBodyStream * httpBodyStream) 1673``` 1674**描述：** 1675 1676销毁ArkWeb_HttpBodyStream对象。 1677 1678**系统能力：** SystemCapability.Web.Webview.Core 1679 1680**起始版本：** 12 1681 1682**参数:** 1683 1684| 名称 | 描述 | 1685| -------- | -------- | 1686| httpBodyStream | 待销毁的httpBodyStream。 | 1687 1688 1689### OH_ArkWebResourceRequest_GetFrameUrl() 1690 1691``` 1692void OH_ArkWebResourceRequest_GetFrameUrl (const ArkWeb_ResourceRequest * resourceRequest, char ** frameUrl ) 1693``` 1694**描述：** 1695 1696获取触发此请求的Frame的URL。 1697 1698**系统能力：** SystemCapability.Web.Webview.Core 1699 1700**起始版本：** 12 1701 1702**参数:** 1703 1704| 名称 | 描述 | 1705| -------- | -------- | 1706| resourceRequest | ArkWeb_ResourceRequest。 | 1707| frameUrl | 触发此请求的Frame的URL。此函数将为URL字符串分配内存，并且调用者必须通过OH_ArkWeb_ReleaseString来释放该字符串。 | 1708 1709 1710### OH_ArkWebResourceRequest_GetHttpBodyStream() 1711 1712``` 1713void OH_ArkWebResourceRequest_GetHttpBodyStream (const ArkWeb_ResourceRequest * resourceRequest, ArkWeb_HttpBodyStream ** httpBodyStream ) 1714``` 1715**描述：** 1716 1717创建一个ArkWeb_HttpBodyStream，用于读取请求的上传数据。 1718 1719**系统能力：** SystemCapability.Web.Webview.Core 1720 1721**起始版本：** 12 1722 1723**参数:** 1724 1725| 名称 | 描述 | 1726| -------- | -------- | 1727| resourceRequest | ArkWeb_ResourceRequest。 | 1728| httpBodyStream | 请求的上传数据。此函数将为httpBodyStream分配内存， 调用者必须使用OH_ArkWebResourceRequest_DestroyHttpBodyStream释放httpBodyStream。 | 1729 1730 1731### OH_ArkWebResourceRequest_GetMethod() 1732 1733``` 1734void OH_ArkWebResourceRequest_GetMethod (const ArkWeb_ResourceRequest * resourceRequest, char ** method ) 1735``` 1736**描述：** 1737 1738获取请求的method。 1739 1740**系统能力：** SystemCapability.Web.Webview.Core 1741 1742**起始版本：** 12 1743 1744**参数:** 1745 1746| 名称 | 描述 | 1747| -------- | -------- | 1748| resourceRequest | ArkWeb_ResourceRequest。 | 1749| method | HTTP请求方法。此函数将为method字符串分配内存，调用者必须使用OH_ArkWeb_ReleaseString释放字符串。 | 1750 1751 1752### OH_ArkWebResourceRequest_GetReferrer() 1753 1754``` 1755void OH_ArkWebResourceRequest_GetReferrer (const ArkWeb_ResourceRequest * resourceRequest, char ** referrer ) 1756``` 1757**描述：** 1758 1759获取请求的Referrer。 1760 1761**系统能力：** SystemCapability.Web.Webview.Core 1762 1763**起始版本：** 12 1764 1765**参数:** 1766 1767| 名称 | 描述 | 1768| -------- | -------- | 1769| resourceRequest | ArkWeb_ResourceRequest。 | 1770| referrer | 请求的Referrer。此函数将为referrer字符串分配内存，调用者必须使用 OH_ArkWeb_ReleaseString 释放该字符串。 | 1771 1772 1773### OH_ArkWebResourceRequest_GetRequestHeaders() 1774 1775``` 1776void OH_ArkWebResourceRequest_GetRequestHeaders (const ArkWeb_ResourceRequest * resourceRequest, ArkWeb_RequestHeaderList ** requestHeaderList ) 1777``` 1778**描述：** 1779 1780获取请求的请求头列表OH_ArkWeb_RequestHeaderList。 1781 1782**系统能力：** SystemCapability.Web.Webview.Core 1783 1784**起始版本：** 12 1785 1786**参数:** 1787 1788| 名称 | 描述 | 1789| -------- | -------- | 1790| resourceRequest | ArkWeb_ResourceRequest。 | 1791| requestHeaderList | 请求的请求头列表。 | 1792 1793 1794### OH_ArkWebResourceRequest_GetResourceType() 1795 1796``` 1797int32_t OH_ArkWebResourceRequest_GetResourceType (const ArkWeb_ResourceRequest * resourceRequest) 1798``` 1799**描述：** 1800 1801获取请求的资源类型。 1802 1803**系统能力：** SystemCapability.Web.Webview.Core 1804 1805**起始版本：** 12 1806 1807**参数:** 1808 1809| 名称 | 描述 | 1810| -------- | -------- | 1811| resourceRequest | ArkWeb_ResourceRequest。 | 1812 1813**返回：** 1814 1815请求的资源类型。如果resourceRequest无效，则为-1。 1816 1817 1818### OH_ArkWebResourceRequest_GetUrl() 1819 1820``` 1821void OH_ArkWebResourceRequest_GetUrl (const ArkWeb_ResourceRequest * resourceRequest, char ** url ) 1822``` 1823**描述：** 1824 1825获取请求的url。 1826 1827**系统能力：** SystemCapability.Web.Webview.Core 1828 1829**起始版本：** 12 1830 1831**参数:** 1832 1833| 名称 | 描述 | 1834| -------- | -------- | 1835| resourceRequest | ArkWeb_ResourceRequest。 | 1836| url | 请求的URL。此函数将为URL字符串分配内存，调用者必须通过OH_ArkWeb_ReleaseString释放该字符串。 | 1837 1838 1839### OH_ArkWebResourceRequest_GetUserData() 1840 1841``` 1842void* OH_ArkWebResourceRequest_GetUserData (const ArkWeb_ResourceRequest * resourceRequest) 1843``` 1844**描述：** 1845 1846从ArkWeb_ResourceRequest获取用户数据。 1847 1848**系统能力：** SystemCapability.Web.Webview.Core 1849 1850**起始版本：** 12 1851 1852**参数:** 1853 1854| 名称 | 描述 | 1855| -------- | -------- | 1856| resourceRequest | ArkWeb_ResourceRequest。 | 1857 1858**返回：** 1859 1860设置的用户数据。 1861 1862 1863### OH_ArkWebResourceRequest_HasGesture() 1864 1865``` 1866bool OH_ArkWebResourceRequest_HasGesture (const ArkWeb_ResourceRequest * resourceRequest) 1867``` 1868**描述：** 1869 1870判断这是否是一个由用户手势触发的请求。 1871 1872**系统能力：** SystemCapability.Web.Webview.Core 1873 1874**起始版本：** 12 1875 1876**参数:** 1877 1878| 名称 | 描述 | 1879| -------- | -------- | 1880| resourceRequest | ArkWeb_ResourceRequest。 | 1881 1882**返回：** 1883 1884如果这是由用户手势触发的，则返回true；否则返回false。 1885 1886 1887### OH_ArkWebResourceRequest_IsMainFrame() 1888 1889``` 1890bool OH_ArkWebResourceRequest_IsMainFrame (const ArkWeb_ResourceRequest * resourceRequest) 1891``` 1892**描述：** 1893 1894判断这是否是主框架文档资源的请求。 1895 1896**系统能力：** SystemCapability.Web.Webview.Core 1897 1898**起始版本：** 12 1899 1900**参数:** 1901 1902| 名称 | 描述 | 1903| -------- | -------- | 1904| resourceRequest | ArkWeb_ResourceRequest。 | 1905 1906**返回：** 1907 1908如果这是来自主框架，则返回true；否则返回false。 1909 1910 1911### OH_ArkWebResourceRequest_IsRedirect() 1912 1913``` 1914bool OH_ArkWebResourceRequest_IsRedirect (const ArkWeb_ResourceRequest * resourceRequest) 1915``` 1916**描述：** 1917 1918判断这是否是一个重定向请求。 1919 1920**系统能力：** SystemCapability.Web.Webview.Core 1921 1922**起始版本：** 12 1923 1924**参数:** 1925 1926| 名称 | 描述 | 1927| -------- | -------- | 1928| resourceRequest | ArkWeb_ResourceRequest。 | 1929 1930**返回：** 1931 1932如果这是一个重定向，则返回true；否则返回false。 1933 1934 1935### OH_ArkWebResourceRequest_SetUserData() 1936 1937``` 1938int32_t OH_ArkWebResourceRequest_SetUserData (ArkWeb_ResourceRequest * resourceRequest, void * userData ) 1939``` 1940**描述：** 1941 1942将一个用户数据设置到ArkWeb_ResourceRequest对象中。 1943 1944**系统能力：** SystemCapability.Web.Webview.Core 1945 1946**起始版本：** 12 1947 1948**参数:** 1949 1950| 名称 | 描述 | 1951| -------- | -------- | 1952| resourceRequest | ArkWeb_ResourceRequest。 | 1953| userData | 将要设置的用户数据。 | 1954 1955**返回：** 1956 1957如果返回0，表示成功；返回17100101，表示参数无效。 1958 1959 1960### OH_ArkWebResponse_GetCharset() 1961 1962``` 1963void OH_ArkWebResponse_GetCharset (const ArkWeb_Response * response, char ** charset ) 1964``` 1965**描述：** 1966 1967获取ArkWeb_Response的字符集。 1968 1969**系统能力：** SystemCapability.Web.Webview.Core 1970 1971**起始版本：** 12 1972 1973**参数:** 1974 1975| 名称 | 描述 | 1976| -------- | -------- | 1977| response | ArkWeb_Response。 | 1978| charset | 返回ArkWeb_Response的字符集。此函数将为charset字符串分配内存，调用方必须通过OH_ArkWeb_ReleaseString释放字符串。 | 1979 1980 1981### OH_ArkWebResponse_GetError() 1982 1983``` 1984ArkWeb_NetError OH_ArkWebResponse_GetError (const ArkWeb_Response * response) 1985``` 1986**描述：** 1987 1988获取ArkWeb_Response的错误码。 1989 1990**系统能力：** SystemCapability.Web.Webview.Core 1991 1992**起始版本：** 12 1993 1994**参数:** 1995 1996| 名称 | 描述 | 1997| -------- | -------- | 1998| response | ArkWeb_Response。 | 1999 2000**返回：** 2001 2002ArkWeb_Response的错误码。 2003 2004 2005### OH_ArkWebResponse_GetHeaderByName() 2006 2007``` 2008void OH_ArkWebResponse_GetHeaderByName (const ArkWeb_Response * response, const char * name, char ** value ) 2009``` 2010**描述：** 2011 2012从ArkWeb_Response中获取header。 2013 2014**系统能力：** SystemCapability.Web.Webview.Core 2015 2016**起始版本：** 12 2017 2018**参数:** 2019 2020| 名称 | 描述 | 2021| -------- | -------- | 2022| response | ArkWeb_Response。 | 2023| name | header的名称。 | 2024| value | 返回header的值。此函数将为value字符串分配内存，调用方必须通过OH_ArkWeb_ReleaseString释放该字符串。 | 2025 2026 2027### OH_ArkWebResponse_GetMimeType() 2028 2029``` 2030void OH_ArkWebResponse_GetMimeType (const ArkWeb_Response * response, char ** mimeType ) 2031``` 2032**描述：** 2033 2034获取ArkWeb_Response的媒体类型。 2035 2036**系统能力：** SystemCapability.Web.Webview.Core 2037 2038**起始版本：** 12 2039 2040**参数:** 2041 2042| 名称 | 描述 | 2043| -------- | -------- | 2044| response | ArkWeb_Response。 | 2045| mimeType | 返回ArkWeb_Response的媒体类型。此函数将为mimeType字符串分配内存，调用方必须通过OH_ArkWeb_ReleaseString释放该字符串。 | 2046 2047 2048### OH_ArkWebResponse_GetStatus() 2049 2050``` 2051int OH_ArkWebResponse_GetStatus (const ArkWeb_Response * response) 2052``` 2053**描述：** 2054 2055获取ArkWeb_Response的HTTP状态码。 2056 2057**系统能力：** SystemCapability.Web.Webview.Core 2058 2059**起始版本：** 12 2060 2061**参数:** 2062 2063| 名称 | 描述 | 2064| -------- | -------- | 2065| response | ArkWeb_Response。 | 2066 2067**返回：** 2068 2069ArkWeb_Response的HTTP状态码。如果ArkWeb_Response无效，则为-1。 2070 2071 2072### OH_ArkWebResponse_GetStatusText() 2073 2074``` 2075void OH_ArkWebResponse_GetStatusText (const ArkWeb_Response * response, char ** statusText ) 2076``` 2077**描述：** 2078 2079获取ArkWeb_Response的状态文本。 2080 2081**系统能力：** SystemCapability.Web.Webview.Core 2082 2083**起始版本：** 12 2084 2085**参数:** 2086 2087| 名称 | 描述 | 2088| -------- | -------- | 2089| response | ArkWeb_Response。 | 2090| statusText | 返回ArkWeb_Response的状态文本。此函数将为statusText字符串分配内存，调用方必须通过OH_ArkWeb_ReleaseString释放该字符串。 | 2091 2092 2093### OH_ArkWebResponse_GetUrl() 2094 2095``` 2096void OH_ArkWebResponse_GetUrl (const ArkWeb_Response * response, char ** url ) 2097``` 2098**描述：** 2099 2100获取经过重定向或由于HSTS而更改后的解析URL。 2101 2102**系统能力：** SystemCapability.Web.Webview.Core 2103 2104**起始版本：** 12 2105 2106**参数:** 2107 2108| 名称 | 描述 | 2109| -------- | -------- | 2110| response | ArkWeb_Response。 | 2111| url | 解析后的URL。 | 2112 2113 2114### OH_ArkWebResponse_SetCharset() 2115 2116``` 2117int32_t OH_ArkWebResponse_SetCharset (ArkWeb_Response * response, const char * charset ) 2118``` 2119**描述：** 2120 2121为ArkWeb_Response设置字符集。 2122 2123**系统能力：** SystemCapability.Web.Webview.Core 2124 2125**起始版本：** 12 2126 2127**参数:** 2128 2129| 名称 | 描述 | 2130| -------- | -------- | 2131| response | ArkWeb_Response。 | 2132| charset | 请求的字符集。 | 2133 2134**返回：** 2135 2136如果返回0，表示成功；返回17100101，表示参数无效。 2137 2138 2139### OH_ArkWebResponse_SetError() 2140 2141``` 2142int32_t OH_ArkWebResponse_SetError (ArkWeb_Response * response, ArkWeb_NetError errorCode ) 2143``` 2144**描述：** 2145 2146给ArkWeb_Response对象设置一个错误码。 2147 2148**系统能力：** SystemCapability.Web.Webview.Core 2149 2150**起始版本：** 12 2151 2152**参数:** 2153 2154| 名称 | 描述 | 2155| -------- | -------- | 2156| response | ArkWeb_Response。 | 2157| errorCode | 失败请求的错误码。 | 2158 2159**返回：** 2160 2161如果返回0，表示成功；返回17100101，表示参数无效。 2162 2163 2164### OH_ArkWebResponse_SetHeaderByName() 2165 2166``` 2167int32_t OH_ArkWebResponse_SetHeaderByName (ArkWeb_Response * response, const char * name, const char * value, bool overwrite ) 2168``` 2169**描述：** 2170 2171为ArkWeb_Response设置一个header。 2172 2173**系统能力：** SystemCapability.Web.Webview.Core 2174 2175**起始版本：** 12 2176 2177**参数:** 2178 2179| 名称 | 描述 | 2180| -------- | -------- | 2181| response | ArkWeb_Response。 | 2182| name | header的名称。 | 2183| value | header的值。 | 2184| overwirte | 如果为true，将覆盖现有的header，否则不覆盖。 | 2185 2186**返回：** 2187 2188如果返回0，表示成功；返回17100101，表示参数无效。 2189 2190 2191### OH_ArkWebResponse_SetMimeType() 2192 2193``` 2194int32_t OH_ArkWebResponse_SetMimeType (ArkWeb_Response * response, const char * mimeType ) 2195``` 2196**描述：** 2197 2198为ArkWeb_Response设置媒体类型。 2199 2200**系统能力：** SystemCapability.Web.Webview.Core 2201 2202**起始版本：** 12 2203 2204**参数:** 2205 2206| 名称 | 描述 | 2207| -------- | -------- | 2208| response | ArkWeb_Response。 | 2209| mimeType | 请求的媒体类型。 | 2210 2211**返回：** 2212 2213如果返回0，表示成功；返回17100101，表示参数无效。 2214 2215 2216### OH_ArkWebResponse_SetStatus() 2217 2218``` 2219int32_t OH_ArkWebResponse_SetStatus (ArkWeb_Response * response, int status ) 2220``` 2221**描述：** 2222 2223为ArkWeb_Response对象设置一个HTTP状态码。 2224 2225**系统能力：** SystemCapability.Web.Webview.Core 2226 2227**起始版本：** 12 2228 2229**参数:** 2230 2231| 名称 | 描述 | 2232| -------- | -------- | 2233| response | ArkWeb_Response。 | 2234| status | 请求的HTTP状态码。 | 2235 2236**返回：** 2237 2238如果返回0，表示成功；返回17100101，表示参数无效。 2239 2240 2241### OH_ArkWebResponse_SetStatusText() 2242 2243``` 2244int32_t OH_ArkWebResponse_SetStatusText (ArkWeb_Response * response, const char * statusText ) 2245``` 2246**描述：** 2247 2248为ArkWeb_Response设置状态文本。 2249 2250**系统能力：** SystemCapability.Web.Webview.Core 2251 2252**起始版本：** 12 2253 2254**参数:** 2255 2256| 名称 | 描述 | 2257| -------- | -------- | 2258| response | ArkWeb_Response。 | 2259| statusText | 请求的状态文本。 | 2260 2261**返回：** 2262 2263如果返回0，表示成功；返回17100101，表示参数无效。 2264 2265 2266### OH_ArkWebResponse_SetUrl() 2267 2268``` 2269int32_t OH_ArkWebResponse_SetUrl (ArkWeb_Response * response, const char * url ) 2270``` 2271**描述：** 2272 2273设置经过重定向或由于HSTS而改变后的解析URL，设置后会触发跳转。 2274 2275**系统能力：** SystemCapability.Web.Webview.Core 2276 2277**起始版本：** 12 2278 2279**参数:** 2280 2281| 名称 | 描述 | 2282| -------- | -------- | 2283| response | ArkWeb_Response。 | 2284| url | 解析后的URL。 | 2285 2286**返回：** 2287 2288如果返回0，表示成功；返回17100101，表示参数无效。 2289 2290 2291### OH_ArkWebSchemeHandler_GetUserData() 2292 2293``` 2294void* OH_ArkWebSchemeHandler_GetUserData (const ArkWeb_SchemeHandler * schemeHandler) 2295``` 2296**描述：** 2297 2298从ArkWeb_SchemeHandler获取用户数据。 2299 2300**系统能力：** SystemCapability.Web.Webview.Core 2301 2302**起始版本：** 12 2303 2304**参数:** 2305 2306| 名称 | 描述 | 2307| -------- | -------- | 2308| schemeHandler | ArkWeb_SchemeHandler。 | 2309 2310**返回：** 2311 2312设置的用户数据。 2313 2314 2315### OH_ArkWebSchemeHandler_SetOnRequestStart() 2316 2317``` 2318int32_t OH_ArkWebSchemeHandler_SetOnRequestStart (ArkWeb_SchemeHandler * schemeHandler, ArkWeb_OnRequestStart onRequestStart ) 2319``` 2320**描述：** 2321 2322为SchemeHandler设置OnRequestStart回调。 2323 2324**系统能力：** SystemCapability.Web.Webview.Core 2325 2326**起始版本：** 12 2327 2328**参数:** 2329 2330| 名称 | 描述 | 2331| -------- | -------- | 2332| schemeHandler | 该scheme的SchemeHandler。 | 2333| onRequestStart | OnRequestStart回调函数。 | 2334 2335**返回：** 2336 2337如果返回0，表示成功；返回17100101，表示参数无效。 2338 2339 2340### OH_ArkWebSchemeHandler_SetOnRequestStop() 2341 2342``` 2343int32_t OH_ArkWebSchemeHandler_SetOnRequestStop (ArkWeb_SchemeHandler * schemeHandler, ArkWeb_OnRequestStop onRequestStop ) 2344``` 2345**描述：** 2346 2347为SchemeHandler设置OnRequestStop回调。 2348 2349**系统能力：** SystemCapability.Web.Webview.Core 2350 2351**起始版本：** 12 2352 2353**参数:** 2354 2355| 名称 | 描述 | 2356| -------- | -------- | 2357| schemeHandler | 该scheme的SchemeHandler。 | 2358| onRequestStop | OnRequestStop回调函数。 | 2359 2360**返回：** 2361 2362如果返回0，表示成功；返回17100101，表示参数无效。 2363 2364 2365### OH_ArkWebSchemeHandler_SetUserData() 2366 2367``` 2368int32_t OH_ArkWebSchemeHandler_SetUserData (ArkWeb_SchemeHandler * schemeHandler, void * userData ) 2369``` 2370**描述：** 2371 2372将一个用户数据设置到ArkWeb_SchemeHandler对象中。 2373 2374**系统能力：** SystemCapability.Web.Webview.Core 2375 2376**起始版本：** 12 2377 2378**参数:** 2379 2380| 名称 | 描述 | 2381| -------- | -------- | 2382| schemeHandler | ArkWeb_SchemeHandler。 | 2383| userData | 要设置的用户数据。 | 2384 2385**返回：** 2386 2387如果返回0，表示成功；返回17100101，表示参数无效。 2388 2389 2390### OH_ArkWebServiceWorker_ClearSchemeHandlers() 2391 2392``` 2393int32_t OH_ArkWebServiceWorker_ClearSchemeHandlers () 2394``` 2395**描述：** 2396 2397清除为ServiceWorker注册的SchemeHandler。 2398 2399**系统能力：** SystemCapability.Web.Webview.Core 2400 2401**起始版本：** 12 2402 2403**返回：** 2404 2405如果返回0，表示成功。 2406 2407 2408### OH_ArkWebServiceWorker_SetSchemeHandler() 2409 2410``` 2411bool OH_ArkWebServiceWorker_SetSchemeHandler (const char * scheme, ArkWeb_SchemeHandler * schemeHandler ) 2412``` 2413**描述：** 2414 2415为指定scheme设置一个ArkWeb_SchemeHandler以拦截ServiceWorker触发的该scheme类型的请求。 2416 2417应该在创建BrowserContext之后设置SchemeHandler。 2418 2419可以使用WebviewController.initializeWebEngine来初始化BrowserContext而无需创建ArkWeb。 2420 2421**系统能力：** SystemCapability.Web.Webview.Core 2422 2423**起始版本：** 12 2424 2425**参数:** 2426 2427| 名称 | 描述 | 2428| -------- | -------- | 2429| scheme | 需要被拦截的scheme。 | 2430| schemeHandler | 该scheme的拦截器ArkWeb_SchemeHandler。只有通过ServiceWorker触发的请求才会通过这个schemeHandler进行通知。 | 2431 2432**返回：** 2433 2434如果为指定scheme设置SchemeHandler成功，则返回true，否则返回false。 2435 2436 2437### OH_NativeArkWeb_GetDestroyCallback() 2438 2439``` 2440NativeArkWeb_OnDestroyCallback OH_NativeArkWeb_GetDestroyCallback (const char * webTag) 2441``` 2442**描述：** 2443 2444获取已注册的组件销毁时的回调函数。 2445 2446**系统能力：** SystemCapability.Web.Webview.Core 2447 2448**起始版本：** 11 2449 2450**参数:** 2451 2452| 名称 | 描述 | 2453| -------- | -------- | 2454| webTag | Web组件的名称。 | 2455 2456**返回：** 2457 2458return 已注册的组件销毁时的回调函数。 2459 2460 2461### OH_NativeArkWeb_GetJavaScriptProxyValidCallback() 2462 2463``` 2464NativeArkWeb_OnValidCallback OH_NativeArkWeb_GetJavaScriptProxyValidCallback (const char * webTag) 2465``` 2466**描述：** 2467 2468获取已注册的对象可注册时的回调函数。 2469 2470**系统能力：** SystemCapability.Web.Webview.Core 2471 2472**起始版本：** 11 2473 2474**参数:** 2475 2476| 名称 | 描述 | 2477| -------- | -------- | 2478| webTag | Web组件的名称。 | 2479 2480**返回：** 2481 2482return 已注册的对象可注册时的回调函数。 2483 2484 2485### OH_NativeArkWeb_RegisterJavaScriptProxy() 2486 2487``` 2488void OH_NativeArkWeb_RegisterJavaScriptProxy (const char * webTag, const char * objName, const char ** methodList, NativeArkWeb_OnJavaScriptProxyCallback * callback, int32_t size, bool needRefresh ) 2489``` 2490**描述：** 2491 2492注册对象及函数名称列表。 2493 2494**系统能力：** SystemCapability.Web.Webview.Core 2495 2496**起始版本：** 11 2497 2498**参数:** 2499 2500| 名称 | 描述 | 2501| -------- | -------- | 2502| webTag | Web组件的名称。 | 2503| objName | 注入对象的名称。 | 2504| methodList | 注入函数列表的名称。 | 2505| callback | 注入的回调函数。 | 2506| size | 注入的回调函数的个数。 | 2507| needRefresh | 是否需要刷新页面。 | 2508 2509 2510### OH_NativeArkWeb_RunJavaScript() 2511 2512``` 2513void OH_NativeArkWeb_RunJavaScript (const char * webTag, const char * jsCode, NativeArkWeb_OnJavaScriptCallback callback ) 2514``` 2515**描述：** 2516 2517在当前显示页面的环境下，加载并执行一段JavaScript代码。 2518 2519**系统能力：** SystemCapability.Web.Webview.Core 2520 2521**起始版本：** 11 2522 2523**参数:** 2524 2525| 名称 | 描述 | 2526| -------- | -------- | 2527| webTag | Web组件的名称。 | 2528| jsCode | 一段JavaScript的代码脚本。 | 2529| callback | 代码执行完后通知开发者结果的回调函数。 | 2530 2531 2532### OH_NativeArkWeb_SetDestroyCallback() 2533 2534``` 2535void OH_NativeArkWeb_SetDestroyCallback (const char * webTag, NativeArkWeb_OnDestroyCallback callback ) 2536``` 2537**描述：** 2538 2539设置组件销毁时的回调函数。 2540 2541**系统能力：** SystemCapability.Web.Webview.Core 2542 2543**起始版本：** 11 2544 2545**参数:** 2546 2547| 名称 | 描述 | 2548| -------- | -------- | 2549| webTag | Web组件的名称。 | 2550| callback | 组件销毁时的回调函数。 | 2551 2552 2553### OH_NativeArkWeb_SetJavaScriptProxyValidCallback() 2554 2555``` 2556void OH_NativeArkWeb_SetJavaScriptProxyValidCallback (const char * webTag, NativeArkWeb_OnValidCallback callback ) 2557``` 2558**描述：** 2559 2560设置对象可注册时的回调函数。 2561 2562**系统能力：** SystemCapability.Web.Webview.Core 2563 2564**起始版本：** 11 2565 2566**参数:** 2567 2568| 名称 | 描述 | 2569| -------- | -------- | 2570| webTag | Web组件的名称。 | 2571| callback | 对象可注册时的回调函数。 | 2572 2573 2574### OH_NativeArkWeb_UnregisterJavaScriptProxy() 2575 2576``` 2577void OH_NativeArkWeb_UnregisterJavaScriptProxy (const char * webTag, const char * objName ) 2578``` 2579**描述：** 2580 2581删除已注册的对象及其下的回调函数。 2582 2583**系统能力：** SystemCapability.Web.Webview.Core 2584 2585**起始版本：** 11 2586 2587**参数:** 2588 2589| 名称 | 描述 | 2590| -------- | -------- | 2591| webTag | Web组件的名称。 | 2592| objName | 注入对象的名称。 | 2593