@react-native-ohos/react-native-webview 13.10.5-rc.1

package/src/WebView.harmony.tsx

@@ -0,0 +1,330 @@
+// Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved
+// Use of this source code is governed by a Apache-2.0 license that can be
+// found in the LICENSE file.
+
+import React, {
+  forwardRef,
+  useCallback,
+  useImperativeHandle,
+  useRef
+} from 'react';
+import { Image, View, ImageSourcePropType, HostComponent } from 'react-native';
+import invariant from 'invariant';
+
+import RNCWebView, { Commands, NativeProps } from './RNCWebViewNativeComponent';
+import RNCWebViewModule from './NativeRNCWebViewModule';
+
+import {
+  defaultOriginWhitelist,
+  defaultRenderError,
+  defaultRenderLoading,
+  useWebViewLogic,
+} from 'react-native-webview/src/WebViewShared';
+import {
+  IOSWebViewProps,
+  DecelerationRateConstant,
+  WebViewSourceUri,
+} from 'react-native-webview/src/WebViewTypes';
+
+import styles from 'react-native-webview/src/WebView.styles';
+const { resolveAssetSource } = Image;
+const processDecelerationRate = (
+  decelerationRate: DecelerationRateConstant | number | undefined
+) => {
+  let newDecelerationRate = decelerationRate;
+  if (newDecelerationRate === 'normal') {
+    newDecelerationRate = 0.998;
+  } else if (newDecelerationRate === 'fast') {
+    newDecelerationRate = 0.99;
+  }
+  return newDecelerationRate;
+};
+
+const useWarnIfChanges = <T extends unknown>(value: T, name: string) => {
+  const ref = useRef(value);
+  if (ref.current !== value) {
+    console.warn(
+      `Changes to property ${name} do nothing after the initial render.`
+    );
+    ref.current = value;
+  }
+};
+
+const WebViewComponent = forwardRef<{}, IOSWebViewProps & { scalesPageToFit: boolean, minimumFontSize: number, thirdPartyCookiesEnabled: boolean, geolocationEnabled: boolean }>(
+  (
+    {
+      fraudulentWebsiteWarningEnabled = true,
+      javaScriptEnabled = true,
+      cacheEnabled = true,
+      originWhitelist = defaultOriginWhitelist,
+      applicationNameForUserAgent,
+      ignoreSilentHardwareSwitch,
+      minimumFontSize,
+      useSharedProcessPool = true,
+      textInteractionEnabled = true,
+      injectedJavaScript,
+      injectedJavaScriptBeforeContentLoaded,
+      menuItems=[],
+      injectedJavaScriptForMainFrameOnly = true,
+      injectedJavaScriptBeforeContentLoadedForMainFrameOnly = true,
+      thirdPartyCookiesEnabled = false,
+      geolocationEnabled = false,
+      webviewDebuggingEnabled = false,
+      injectedJavaScriptObject,
+      startInLoadingState,
+      onNavigationStateChange,
+      onLoadStart,
+      onCustomMenuSelection,
+      onError,
+      onLoad,
+      onLoadEnd,
+      onLoadProgress,
+      onScroll,
+      onContentProcessDidTerminate: onContentProcessDidTerminateProp,
+      onFileDownload,
+      onHttpError: onHttpErrorProp,
+      onMessage: onMessageProp,
+      onOpenWindow: onOpenWindowProp,
+      renderLoading,
+      renderError,
+      style,
+      containerStyle,
+      source,
+      nativeConfig,
+      allowsInlineMediaPlayback,
+      allowsAirPlayForMediaPlayback,
+      mediaPlaybackRequiresUserAction=true,
+      dataDetectorTypes,
+      incognito,
+      decelerationRate: decelerationRateProp,
+      onShouldStartLoadWithRequest: onShouldStartLoadWithRequestProp,
+      onStartShouldSetResponder,
+      onMoveShouldSetResponderCapture,
+      pullToRefreshEnabled=false,
+      onResponderMove,
+      ...otherProps
+    },
+    ref
+  ) => {
+    const webViewRef = useRef<React.ComponentRef<
+      HostComponent<NativeProps>
+    > | null>(null);
+
+    const onShouldStartLoadWithRequestCallback = useCallback(
+      (shouldStart: boolean, _url: string, lockIdentifier = 0) => {
+        RNCWebViewModule.shouldStartLoadWithLockIdentifier(
+          shouldStart,
+          lockIdentifier
+        );
+      },
+      []
+    );
+
+    const {
+      onLoadingStart,
+      onShouldStartLoadWithRequest,
+      onMessage,
+      viewState,
+      setViewState,
+      lastErrorEvent,
+      onHttpError,
+      onLoadingError,
+      onLoadingFinish,
+      onLoadingProgress,
+      onOpenWindow,
+      onContentProcessDidTerminate,
+    } = useWebViewLogic({
+      onNavigationStateChange,
+      onLoad,
+      onError,
+      onHttpErrorProp,
+      onLoadEnd,
+      onLoadProgress,
+      // @ts-expect-error old arch only
+      onScroll,
+      onLoadStart,
+      onMessageProp,
+      onOpenWindowProp,
+      startInLoadingState,
+      originWhitelist,
+      ignoreSilentHardwareSwitch,
+      minimumFontSize,
+      onShouldStartLoadWithRequestProp,
+      onShouldStartLoadWithRequestCallback,
+      onContentProcessDidTerminateProp,
+    });
+
+    useImperativeHandle(
+      ref,
+      () => ({
+        goForward: () =>
+          webViewRef.current && Commands.goForward(webViewRef.current),
+        goBack: () => webViewRef.current && Commands.goBack(webViewRef.current),
+        reload: () => {
+          setViewState('LOADING');
+          if (webViewRef.current) {
+            Commands.reload(webViewRef.current);
+          }
+        },
+        stopLoading: () =>
+          webViewRef.current && Commands.stopLoading(webViewRef.current),
+        postMessage: (data: string) =>
+          webViewRef.current && Commands.postMessage(webViewRef.current, data),
+        injectJavaScript: (data: string) =>
+          webViewRef.current &&
+          Commands.injectJavaScript(webViewRef.current, data),
+        requestFocus: () =>
+          webViewRef.current && Commands.requestFocus(webViewRef.current),
+        clearCache: (includeDiskFiles: boolean) =>
+          webViewRef.current &&
+          Commands.clearCache(webViewRef.current, includeDiskFiles),
+        clearHistory: () => webViewRef.current && Commands.clearHistory(webViewRef.current),
+        loadUrl: (data: string) => webViewRef.current && Commands.loadUrl(webViewRef.current, data),
+      }),
+      [setViewState, webViewRef]
+    );
+
+    useWarnIfChanges(allowsInlineMediaPlayback, 'allowsInlineMediaPlayback');
+    useWarnIfChanges(
+      allowsAirPlayForMediaPlayback,
+      'allowsAirPlayForMediaPlayback'
+    );
+    useWarnIfChanges(incognito, 'incognito');
+    useWarnIfChanges(
+      mediaPlaybackRequiresUserAction,
+      'mediaPlaybackRequiresUserAction'
+    );
+    useWarnIfChanges(dataDetectorTypes, 'dataDetectorTypes');
+
+    let otherView = null;
+    if (viewState === 'LOADING') {
+      otherView = (renderLoading || defaultRenderLoading)();
+    } else if (viewState === 'ERROR') {
+      invariant(
+        lastErrorEvent != null,
+        'lastErrorEvent expected to be non-null'
+      );
+      otherView = (renderError || defaultRenderError)(
+        lastErrorEvent?.domain,
+        lastErrorEvent?.code ?? 0,
+        lastErrorEvent?.description ?? ''
+      );
+    } else if (viewState !== 'IDLE') {
+      console.error(`RNCWebView invalid state encountered: ${viewState}`);
+    }
+
+    const webViewStyles = [styles.container, styles.webView, style];
+    const webViewContainerStyle = [styles.container, containerStyle];
+
+    const decelerationRate = processDecelerationRate(decelerationRateProp);
+
+    const NativeWebView =
+      (nativeConfig?.component as typeof RNCWebView | undefined) || RNCWebView;
+
+    const sourceResolved = resolveAssetSource(source as ImageSourcePropType);
+    const newSource =
+      typeof sourceResolved === 'object'
+        ? Object.entries(sourceResolved as WebViewSourceUri).reduce(
+          (prev, [currKey, currValue]) => {
+            return {
+              ...prev,
+              [currKey]:
+                currKey === 'headers' &&
+                  currValue &&
+                  typeof currValue === 'object'
+                  ? Object.entries(currValue).map(([key, value]) => {
+                    return {
+                      name: key,
+                      value,
+                    };
+                  })
+                  : currValue,
+            };
+          },
+          {}
+        )
+        : sourceResolved;
+
+    const webView = (
+      <NativeWebView
+        key="webViewKey"
+        {...otherProps}
+        scrollEnabled={otherProps.scrollEnabled ?? true}
+        ignoreSilentHardwareSwitch={ignoreSilentHardwareSwitch}
+        minimumFontSize={minimumFontSize}
+        scalesPageToFit={otherProps.scalesPageToFit ?? true}
+        fraudulentWebsiteWarningEnabled={fraudulentWebsiteWarningEnabled}
+        javaScriptEnabled={javaScriptEnabled}
+        onCustomMenuSelection={onCustomMenuSelection}
+        applicationNameForUserAgent={applicationNameForUserAgent}
+        cacheEnabled={cacheEnabled}
+        useSharedProcessPool={useSharedProcessPool}
+        textInteractionEnabled={textInteractionEnabled}
+        geolocationEnabled={geolocationEnabled}
+        decelerationRate={decelerationRate}
+        messagingEnabled={typeof onMessageProp === 'function'}
+        messagingModuleName="" // android ONLY
+        onLoadingError={onLoadingError}
+        onLoadingFinish={onLoadingFinish}
+        onLoadingProgress={onLoadingProgress}
+        onScroll={onScroll}
+        onFileDownload={onFileDownload}
+        onLoadingStart={onLoadingStart}
+        onHttpError={onHttpError}
+        onMessage={onMessage}
+        onOpenWindow={onOpenWindowProp && onOpenWindow}
+        hasOnOpenWindowEvent={onOpenWindowProp !== undefined}
+        onShouldStartLoadWithRequest={onShouldStartLoadWithRequest}
+        onContentProcessDidTerminate={onContentProcessDidTerminate}
+        thirdPartyCookiesEnabled={thirdPartyCookiesEnabled}
+        pullToRefreshEnabled={pullToRefreshEnabled}
+        injectedJavaScript={injectedJavaScript}
+        injectedJavaScriptBeforeContentLoaded={
+          injectedJavaScriptBeforeContentLoaded
+        }
+        injectedJavaScriptForMainFrameOnly={injectedJavaScriptForMainFrameOnly}
+        injectedJavaScriptBeforeContentLoadedForMainFrameOnly={
+          injectedJavaScriptBeforeContentLoadedForMainFrameOnly
+        }
+        injectedJavaScriptObject={JSON.stringify(injectedJavaScriptObject)}
+        dataDetectorTypes={
+          !dataDetectorTypes || Array.isArray(dataDetectorTypes)
+            ? dataDetectorTypes
+            : [dataDetectorTypes]
+        }
+        allowsAirPlayForMediaPlayback={allowsAirPlayForMediaPlayback}
+        allowsInlineMediaPlayback={allowsInlineMediaPlayback}
+        incognito={incognito}
+        mediaPlaybackRequiresUserAction={mediaPlaybackRequiresUserAction}
+        menuItems={menuItems}
+        newSource={newSource}
+        style={webViewStyles}
+        webviewDebuggingEnabled={webviewDebuggingEnabled}
+        hasOnFileDownload={!!onFileDownload}
+        ref={webViewRef}
+        // @ts-expect-error old arch only
+        source={sourceResolved}
+        {...nativeConfig?.props}
+      />
+    );
+
+    return (
+      <View
+        style={webViewContainerStyle}
+        onStartShouldSetResponder={(e) => onStartShouldSetResponder ? onStartShouldSetResponder(e) : false}
+        onMoveShouldSetResponderCapture={(e) => onMoveShouldSetResponderCapture ? onMoveShouldSetResponderCapture(e) : false}
+        onResponderMove={(e) => onResponderMove ? onResponderMove(e) : null}
+      >
+        {webView}
+        {otherView}
+      </View>
+    );
+  }
+);
+
+// no native implementation for iOS, depends only on permissions
+const isFileUploadSupported: () => Promise<boolean> = async () => true;
+
+const WebView = Object.assign(WebViewComponent, { isFileUploadSupported });
+
+export default WebView;

package/src/WebView.tsx

@@ -0,0 +1,4 @@
+import {WebView} from 'react-native-webview';
+
+export { WebView };
+export default WebView;

package/src/codegenUtils.ts

@@ -0,0 +1,9 @@
+// Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved
+// Use of this source code is governed by a Apache-2.0 license that can be
+// found in the LICENSE file.
+
+export type UnsafeMixed<T> = T;
+
+// Fabric doesn't support optional props, so we need to use UnsafeMixed
+// https://github.com/rnmapbox/maps/pull/3082#discussion_r1339858750
+export type OptionalProp<T> = UnsafeMixed<T>;

package/src/index.ts

@@ -0,0 +1,4 @@
+import WebView from './WebView';
+
+export { WebView };
+export default WebView;