Enums

NOTE

The initial APIs of this component are supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.

MessageLevel

Enumerates the information levels of the console messages.

NOTE

• On the HTML5 side, the information level of ConsoleMessage corresponding to console.log or console.info is MessageLevel.Info.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
Debug	1	Debug level.
Error	4	Error level.
Info	2	Information level.
Log	5	Log level.
Warn	3	Warning level.

ConsoleMessageSource²³⁺

Enumerates the log sources of the console messages.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
XML	0	Logs are generated by the XML/HTML parser of the web page, for example, HTML syntax errors, XML format exceptions, and parsing warnings caused by unclosed HTML tags.
JAVASCRIPT	1	Logs are generated when an exception occurs during JavaScript execution, such as a JavaScript syntax error or runtime exception.
NETWORK	2	Logs are generated when web page resources (such as JS, CSS, and images) fail to be loaded and error code 404 is returned.
CONSOLE_API	3	Logs are generated when web pages call W3C console APIs, such as console.warn and console.error.
STORAGE	4	Logs are generated when exceptions (such as storage quota exceeding and operation exceptions) occur on storage-related modules (LocalStorage, SessionStorage, IndexedDB and Cookie).
RENDERING	5	Logs are generated when exceptions (such as invalid CSS styles, layout exceptions, and rendering performance warnings) occur on the rendering engine (such as Blink).
SECURITY	6	Logs are generated when web page security policies are violated, HTTPS certificate errors occur, and mixed content (HTTP resources are loaded on HTTPS pages) occurs.
OTHER	7	Logs are generated by other sources, such as web extension plugins.
DEPRECATION	8	Logs are generated when an expired syntax, such as slider-vertical, is used.
WORKER	9	Logs are generated when service worker errors occur, for example, service worker navigation preload requests are interrupted before being completed.
VIOLATION	10	Logs are generated when a rule is violated, for example, the execution of a piece of JavaScript code takes more than 50 ms.
INTERVENTION	11	Logs are generated when the web page detects code behaviors that may compromise user experience, security, or performance. The web page proactively intervenes, blocks or modifies the behavior, and notifies you of the behavior through a message containing kIntervention. For example, the DispatchBeforeUnload event is triggered on a web page without user interaction.
RECOMMENDATION	12	Logs are generated when code behaviors that do not comply with web security best practices are detected and improvement suggestions are provided. For example, when the page uses APIs (such as innerHTML and eval()) that may have XSS risks and does not comply with the Trusted Types security specifications.

MixedMode

Enumerates the mixed content modes.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
All	0	Loose mode: HTTP and HTTPS hybrid content can be loaded. This means that all insecure content can be loaded.
Compatible	1	Compatible mode: HTTP and HTTPS hybrid content can be loaded in compatibility mode. This means that some insecure content may be loaded.
None	2	Strict mode: HTTP and HTTPS hybrid content cannot be loaded.

HitTestType^(deprecated)

Enumerates the test result types of the click event.

System capability: SystemCapability.Web.Webview.Core

NOTE

This enum is supported since API version 9 and deprecated since API version 21. You are advised to use WebHitTestType instead.

Name	Value	Description
EditText	0	Editable area.
Email	1	Email address.
HttpAnchor	2	Hyperlink whose src is http.
HttpAnchorImg	3	Image with a hyperlink, where src is http.
Img	4	HTML::img tag.
Map	5	Geographical address.
Phone	6	Phone number.
Unknown	7	Unknown content.

CacheMode

Enumerates the cache modes.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
Default9+	0	The cache that has not expired is preferentially used to load resources. If the cache is invalid or no cache is available, resources are obtained from the Internet.
None	1	The cache (including expired caches) is preferentially used to load resources. If no cache is available, resources are obtained from the Internet.
Online	2	The cache is not used to load the resources. All resources are forcibly obtained from the Internet.
Only	3	The local cache alone is used to load the resources.

OverScrollMode¹¹⁺

Enumerates whether to enable overscroll mode.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NEVER	0	The overscroll mode is disabled.
ALWAYS	1	The overscroll mode is enabled.

BlurOnKeyboardHideMode¹⁴⁺

Enumerates whether the Web component loses focus when the soft keyboard is hidden.

System capability: SystemCapability.Web.Webview.Core

Parameters

Name	Value	Description
SILENT	0	The Web component does not lose focus when the soft keyboard is hidden.
BLUR	1	The Web component loses focus when the soft keyboard is hidden, and the focus moves from the text box to the web body.

WebDarkMode⁹⁺

Enumerates whether to enable web dark mode.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
Off	0	The web dark mode is disabled.
On	1	The web dark mode is enabled.
Auto	2	The web dark mode setting follows the system setting.

WebCaptureMode¹⁰⁺

Enumerates the web screen capture modes.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
HOME_SCREEN	0	Home screen capture mode.

ThreatType¹¹⁺

Enumerates the website threat types.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
THREAT_ILLEGAL	0	Illegal website.
THREAT_FRAUD	1	Fraudulent website.
THREAT_RISK	2	Website that poses security risks.
THREAT_WARNING	3	Website suspected to contain unsafe content.
THREAT_NONE21+	4	Website that passes the security check and no risk is found.
THREAT_UNPROCESSED21+	5	Website that does not perform security check.

RenderExitReason⁹⁺

Enumerates the reasons why the rendering process exits.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
ProcessAbnormalTermination	0	The rendering process terminates abnormally. Possible causes include: rendering process startup timeout, system reclaiming older rendering processes upon reaching the process limit, or simultaneous closure of multiple tabs.
ProcessWasKilled	1	The rendering process receives a SIGKILL message or is manually terminated.
ProcessCrashed	2	The rendering process crashes due to segmentation or other errors.
ProcessOom	3	The program memory is insufficient.
ProcessExitUnknown	4	Other reasons, such as failure to spawn the rendering process.

SslError⁹⁺

Enumerates the error codes returned by onSslErrorEventReceive API.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
Invalid	0	Minor error.
HostMismatch	1	The host name does not match.
DateInvalid	2	The certificate has an invalid date.
Untrusted	3	The certificate issuer is not trusted.

FileSelectorMode⁹⁺

Enumerates the modes of the file selector.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
FileOpenMode	0	Open and upload a file.
FileOpenMultipleMode	1	Open and upload multiple files.
FileOpenFolderMode	2	Open and upload a folder.
FileSaveMode	3	Save a file.

WebLayoutMode¹¹⁺

Enumerates the web layout modes.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NONE	0	The web layout follows the system.
FIT_CONTENT	1	The web layout adapts to the page size.

RenderProcessNotRespondingReason¹²⁺

Enumerates the reasons why the rendering process does not respond.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
INPUT_TIMEOUT	0	The input event response sent to the rendering process times out.
NAVIGATION_COMMIT_TIMEOUT	1	The navigation for loading a new web page times out.

ProtectedResourceType⁹⁺

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description	Available Permission
MidiSysex	TYPE_MIDI_SYSEX	MIDI SYSEX resource. Currently, only permission events can be reported. MIDI devices are not yet supported.	Currently, the permission related to the Musical Instrument Digital Interface (MIDI) device cannot be requested.
VIDEO_CAPTURE10+	TYPE_VIDEO_CAPTURE	Video capture resource, such as a camera.	Camera permission: ohos.permission.CAMERA.
AUDIO_CAPTURE10+	TYPE_AUDIO_CAPTURE	Audio capture resource, such as a microphone.	Microphone permission: ohos.permission.MICROPHONE.
SENSOR12+	TYPE_SENSOR	Sensor resource, such as an acceleration sensor.	Acceleration sensor permission: ohos.permission.ACCELEROMETER, Gyroscope sensor permission: ohos.permission.GYROSCOPE.

ContextMenuSourceType⁹⁺

Enumerates the event source types that trigger the context menu.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
None	0	Other event sources.
Mouse	1	Mouse event.
LongPress	2	Long press event.

ContextMenuMediaType⁹⁺

Enumerates the media types that trigger the context menu.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
None	0	Other non-image media types.
Image	1	Image.

ContextMenuDataMediaType²²⁺

Enumerates the media types that trigger the context menu (enhanced type obtaining capability).

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NONE	0	Default value, indicating that the current context menu is not associated with any media type (for example, right-click text or blank area).
IMAGE	1	Image.
VIDEO	2	Video.
AUDIO	3	Audio.
CANVAS	4	Canvas.

ContextMenuInputFieldType⁹⁺

Enumerates the input field types.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
None	0	Non-input field.
PlainText	1	Plain text field, such as the text, search, or email field.
Password	2	Password field.
Number	3	Number field.
Telephone	4	Phone number field.
Other	5	Field of any other type.

NativeEmbedStatus¹¹⁺

Enumerates the lifecycles of the same-layer tag. When a same-layer tag exists on the loaded page, CREATE is triggered. When a same-layer tag is moved or is enlarged, UPDATE is triggered. When the page exits, DESTROY is triggered.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
CREATE	0	The same-layer tag is created.
UPDATE	1	The same-layer tag is updated.
DESTROY	2	The same-layer tag is destroyed.
ENTER_BFCACHE12+	3	The same-layer tag enters BFCache.
LEAVE_BFCACHE12+	4	The same-layer tag leaves BFCache.

NativeEmbedParamStatus²¹⁺

Enumerates the status change types of the param element embedded in the same-layer rendering tag object. ADD is triggered when the param element is added, UPDATE is triggered when it is modified, and DELETE is triggered when it is deleted.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
ADD	0	Triggered when a param element is added.
UPDATE	1	Triggered when a param element is modified.
DELETE	2	Triggered when a param element is deleted.

ContextMenuEditStateFlags⁹⁺

Enumerates the context menu edit state flags. This enum can be used in bitwise OR mode. For example, to support CAN_CUT, CAN_COPY, and CAN_SELECT_ALL at the same time, use CAN_CUT | CAN_COPY | CAN_SELECT_ALL or 11.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NONE	0	Editing is not allowed.
CAN_CUT	1 << 0	Cutting is supported.
CAN_COPY	1 << 1	Copying is supported.
CAN_PASTE	1 << 2	Pasting is supported.
CAN_SELECT_ALL	1 << 3	Selecting all is supported.

WebNavigationType¹¹⁺

Enumerates the navigation types.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
UNKNOWN	0	Unknown type.
MAIN_FRAME_NEW_ENTRY	1	Navigation to a new history entry from the main document.
MAIN_FRAME_EXISTING_ENTRY	2	Navigation to an existing history entry from the main document.
NAVIGATION_TYPE_NEW_SUBFRAME	4	User-triggered navigation from a subdocument.
NAVIGATION_TYPE_AUTO_SUBFRAME	5	Non-user-triggered navigation from a subdocument.

RenderMode¹²⁺

Enumerates the rendering modes of the Web component. By default, the asynchronous rendering mode is used.

The asynchronous rendering mode is recommended because it has better performance and lower power consumption.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
ASYNC_RENDER	0	The Web component as a graphic surface node is rendered asynchronously and displayed independently. The maximum width of the Web component is 7,680 px (physical pixel).
SYNC_RENDER	1	The Web component as a graphic canvas node is rendered synchronously and displayed together with the system component. The maximum width of the Web component is 500,000 px (physical pixel).

ViewportFit¹²⁺

Enumerates the viewport types available for viewport-fit in the web page <meta> tag.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
AUTO	0	The entire web page is visible. Default value.
CONTAINS	1	The initial layout viewport and the visual viewport fit within the largest rectangle that adapts to the device's display screen.
COVER	2	The initial layout viewport and the visual viewport are confined within the bounding rectangle of the device's physical screen.

WebKeyboardAvoidMode¹²⁺

Enumerates the soft keyboard avoidance modes.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
RESIZE_VISUAL	0	For soft keyboard avoidance, the visual viewport is resized, but not the layout viewport.
RESIZE_CONTENT	1	For soft keyboard avoidance, both the visual viewport and layout viewport are resized. Default value.
OVERLAYS_CONTENT	2	No viewport is resized, and soft keyboard avoidance is not triggered.
RETURN_TO_UICONTEXT22+	3	The soft keyboard avoidance behavior of the Web component follows the KeyboardAvoidMode set by UIcontext. The Web component does not process the avoidance behavior of the component.

WebElementType¹³⁺

Enumerates the web element types.

System capability: SystemCapability.Web.Webview.Core

Parameters

Name	Value	Description
IMAGE	1	Image.
LINK20+	2	Hyperlink.
TEXT21+	3	Text or editable area.

WebResponseType¹³⁺

Enumerates the response types of the menu.

System capability: SystemCapability.Web.Webview.Core

Parameters

Name	Value	Description
LONG_PRESS	1	The menu is displayed when the component is long-pressed.
RIGHT_CLICK21+	2	The menu is displayed when the component is right-clicked.

AudioSessionType²⁰⁺

Enumerates the web audio types in the application.

System capability: SystemCapability.Web.Webview.Core

Parameters

Name	Value	Description
AMBIENT	3	Web game sounds and system music can be played at the same time. This value is applicable to web game scenarios. Its corresponding system audio stream type is STREAM_USAGE_GAME.

GestureFocusMode²⁰⁺

Enumerates the focus modes.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
DEFAULT	0	The Web component applies for the focus when it is touched, long-pressed, swiped, or zoomed.
GESTURE_TAP_AND_LONG_PRESS	1	The Web component applies for the focus only when it is touched and long-pressed. The swipe and zoom gestures do not apply for the focus.

WebRotateEffect²²⁺

Enumerates the modes in which the component's content is rendered to fit the new size during its width and height animation process when the component is rotated.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
TOPLEFT_EFFECT	0	The component's content stays at the final size and always aligned with the upper left corner of the component. This value is used by default.
RESIZE_COVER_EFFECT	1	While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. It is always aligned with the center of the component, so that its middle part is displayed.

WebBypassVsyncCondition²⁰⁺

Enumerates whether to allow the rendering process to bypass the vsync scheduling.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NONE	0	The rendering process does not bypass the vsync scheduling. Default value.
SCROLLBY_FROM_ZERO_OFFSET	1	When scrollBy is used (only the scrolling offset is supported) and the scrolling offset of the web page is 0, the rendering process bypasses the vsync scheduling.

PdfLoadResult²⁰⁺

Enumerates the PDF page loading results.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
LOAD_SUCCESS	0	The PDF file is successfully loaded.
PARSE_ERROR_FILE	1	The PDF file fails to be loaded.
PARSE_ERROR_FORMAT	2	The PDF file format is not supported.
PARSE_ERROR_PASSWORD	3	The PDF file password is incorrect.
PARSE_ERROR_HANDLER	4	The PDF file fails to be processed.

DetectedBlankScreenReason²²⁺

Enumerates the reasons for the blank screen.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NO_CONTENTFUL_NODES	0	No contentful node is detected. This may be triggered when the detection policy is DETECTION_CONTENTFUL_NODES_SEVENTEEN.
SUB_THRESHOLD_CONTENTFUL_NODES	1	The number of contentful nodes detected is less than or equal to the threshold. This may be triggered when the detection policy is DETECTION_CONTENTFUL_NODES_SEVENTEEN and contentfulNodesCountThreshold is set.

BlankScreenDetectionMethod²²⁺

Enumerates the methods for the blank screen detection.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
DETECTION_CONTENTFUL_NODES_SEVENTEEN	0	The page is detected using the 17-point detection method. When a rendered and contentful node is detected by a detection point, it is considered that the detection point is hit. A contentful node refers to an image, video, or text node. If no contentful node is detected or the number of contentful nodes is less than the threshold, a blank or near-blank screen is displayed. The 17 detection points are as follows: Center point (1): The center point is at the geometric center of the page. Internal grid intersection points (16): A 5 × 5 uniform grid is defined in the page area. The 16 points are the intersection points of four vertical equal division lines and four horizontal equal division lines in the page.

CredentialType²²⁺

Enumerates the credential types.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
CREDENTIAL_USER	2	User credential.
CREDENTIAL_APP	3	Application credential.
CREDENTIAL_UKEY	4	UKey credential.

PinVerifyResult²²⁺

Enumerates the PIN verification results.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
PIN_VERIFICATION_SUCCESS	0	Verification successful.
PIN_VERIFICATION_FAILED	1	Verification failed.

CameraCaptureState²³⁺

Enumerates the camera capture states.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NONE	0	The camera is not working.
PAUSED	1	The camera is paused.
ACTIVE	2	The camera is active.

MicrophoneCaptureState²³⁺

Enumerates the microphone capture states.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NONE	0	The microphone is not working.
PAUSED	1	The microphone is paused.
ACTIVE	2	The microphone is active.

NavigationPolicy²³⁺

Enumerates the modes of opening a new window in the WebView.

System capability: SystemCapability.Web.Webview.Core

Name	Value	Description
NEW_POPUP	0	Open in a new pop-up window.
NEW_WINDOW	1	Open in a new window.
NEW_BACKGROUND_TAB	2	Open in a new tab in background.
NEW_FOREGROUND_TAB	3	Open in a new tab in foreground.