harmony 鸿蒙Webview Error Codes

2025-06-12
浏览 (4)

Webview Error Codes

NOTE

This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.

17100001 WebviewController Not Associated with a Web Component

Error Message

Init error. The WebviewController must be associated with a Web component.

Description

This error code is reported when the WebviewController object is not associated with any Web component.

Solution

Use onControllerAttached() to check whether the WebViewController object is associated with the Web component.

17100002 Invalid URL

Error Message

URL error.Possible causes: 1. No valid cookie found for the specified URL. 2. The webpage corresponding to the URL is invalid, or the URL length exceeds 2048.

Description

This error code is reported when the URL format is incorrect.

Solution

Check whether the URL is correct and contains a maximum of 2048 characters.

17100003 Incorrect Resource Path

Error Message

Invalid resource path or file type.

Description

This error code is reported when the path to the resource file is incorrect.

Possible Causes

The resource file does not exist or cannot be accessed.

Solution

Make sure the path to the resource file is correct.

17100004 Function Not Enabled

Error Message

Function not enabled.

Description

This error code is reported when the related function is not enabled.

Solution

Make sure the related function is enabled.

17100005 Invalid Cookie Value

Error Message

The provided cookie value is invalid. It must follow the format specified in RFC 6265.

Description

This error code is reported when the cookie value type is invalid.

Possible Causes

The cookie value type is not supported.

Solution

Verify the cookie value type.

17100006 Message Port Callback Cannot Be Registered

Error Message

Failed to register a message event for the port.

Description

This error code is reported when a callback fails to be registered for the message port.

Possible Causes

The port is closed.

Solution

Make sure the port is open.

17100007 Invalid Forward or Backward Operation

Error Message

Invalid backward or forward operation.

Description

This error code is reported when the specified forward or backward cannot be performed.

Possible Causes

The browsing history is cleared.
There is no browsing operation corresponding to the forward or backward operation.

Solution

Check whether clearHistory has been performed.
Check whether the number of pages specified by the forward or backward operation is available.

17100008 javaScriptProxy Does Not Exist

Error Message

Failed to delete JavaScriptProxy because it does not exist.

Description

This error code is reported when the javaScriptProxy object to delete does not exist.

Possible Causes

The target javaScriptProxy object is not yet registered.

Solution

Make sure the javaScriptProxy object is registered.

17100009 Zoom Operation Failure

Error Message

The zoom operation failed.

Description

This error code is reported when the page cannot be zoomed in or out.

Possible Causes

The zoom ratio has reached its maximum or minimum.

Solution

Check whether the zoom ratio has reached its maximum or minimum.

17100010 Failure to Send Messages Through a Port

Error Message

Failed to post messages through the port.

Description

This error code is reported when the current port cannot be used to send messages.

Possible Causes

The local or remote port is closed.

Solution

Make sure the local port is open.
Make sure an onMessageEvent callback is registered for the remote port.

17100011 Invalid Origin

Error Message

Invalid origin.

Description

This error code is reported when the input parameter origin is invalid.

Possible Causes

The origin parameter is empty.
The origin value is invalid.

Solution

Make sure the origin value is valid.

17100012 No Web Storage Origin

Error Message

Invalid web storage origin.

Description

This error code is reported when no web storage origin is available.

Possible Causes

The related JS database API is not used.

Solution

Check whether the JS database API is used.
If the JS database API is used, find out the failure cause, for example, check whether databaseAccess is enabled.

17100013 Invalid Number of Sockets During Preconnection

Error Message

The number of sockets to be preconnected is invalid.

Description

This error code is reported when the number of sockets to be preconnected is invalid.

Possible Causes

The number of sockets is less than or equal to 0 or greater than 6.

Solution

Make sure the specified number of sockets is greater than 0 and less than or equal to 6.

17100014 Type and Value Mismatch

Error Message

The type and value of the message do not match.

Description

This error code is reported when the type and value of the message do not match.

Possible Causes

The value of the obtained message does not match the type of the message.

Solution

Call the API based on the message type to obtain the message value. For example, if the type is BOOLEAN, call the GetBoolean API to obtain the Boolean value.

17100015 Memory Allocation Failure

Error Message

Memory allocation failed.

Description

This error code is reported when memory allocation failed due to insufficient memory.

Possible Causes

The data to send is too large.

Solution

Check the length of the data to be sent.

17100016 Download Task Not Paused

Error Message

The download task is not paused.

Description

This error code is reported when an attempt is made to resume a download task that is not paused.

Possible Causes

WebDownloadItem.resume is called when the download task is not paused.

Solution

N/A

17100017 Invalid WebviewController

Error Message

No valid WebviewController is associated.

Description

This error code is reported when the current WebviewController object is invalid.

Possible Causes

The WebviewController object is not associated with a valid Web component.

Solution

Use a WebviewController object that is associated with a valid Web component.

17100018 No WebDownloadDelegate Available

Error Message

No WebDownloadDelegate has been set yet.

Description

This error code is reported when no WebDownloadDelegate is available to receive the download state.

Possible Causes

WebDownloadManager.resumeDownload is called when WebDownloadDelegate has not been set.

Solution

Use WebDownloadManager.setDownloadDelegate to set a WebDownloadDelegate class.

17100019 Download Not Started Yet

Error Message

The download task is not started yet.

Description

This error code is reported when an attempt is made to pause or resume a download task that has not been started.

Possible Causes

pause or resume is called when the download task that has not been started.

Solution

Call start(‘xxx’) in WebDownloadDelegate.onBeforeDownload and specify the download path.

17100020 Failed to Register Custom Schemes

Error Message

Failed to register custom schemes.

Description

This error code is reported when a custom scheme failed to be registered.

Possible Causes

The custom scheme is set after the ArkWeb engine is initialized.

Solution

17100021 WebResourceHandler Is Invalid

Error Message

The resource handler is invalid.

Description

This error code is reported when the WebResourceHandler object is invalid.

Possible Causes

The corresponding request is not intercepted in WebSchemeHandler.
The request is intercepted before the response body is constructed, and the request is ended due to some reasons.
The WebResourceHandler object has called didFinish and didFail.

Solution

Do not call the WebResourceHandler API in the preceding situations.