@exodus/react-native-webview 11.26.1-exodus.5 → 11.26.1-exodus.7

package/src/WebViewShared.tsx

@@ -0,0 +1,257 @@
+import escapeStringRegexp from 'escape-string-regexp';
+import React, { useCallback, useMemo, useRef, useState } from 'react';
+import { Linking, View, ActivityIndicator, Text, Platform } from 'react-native';
+import {
+  OnShouldStartLoadWithRequest,
+  ShouldStartLoadRequestEvent,
+  WebViewError,
+  WebViewErrorEvent,
+  WebViewMessageEvent,
+  WebViewMessage,
+  WebViewNavigationEvent,
+  WebViewProgressEvent,
+  WebViewNativeEvent,
+} from './WebViewTypes';
+import styles from './WebView.styles';
+
+const defaultOriginWhitelist = ['https://*'] as const;
+
+const extractOrigin = (url: string): string => {
+  const result = /^[A-Za-z][A-Za-z0-9+\-.]+:(\/\/)?[^/]*/.exec(url);
+  return result === null ? '' : result[0];
+};
+
+const originWhitelistToRegex = (originWhitelist: string): string =>
+  `^${escapeStringRegexp(originWhitelist).replace(/\\\*/g, '.*')}$`;
+
+const _passesWhitelist = (
+  compiledWhitelist: readonly string[],
+  url: string,
+) => {
+  const origin = extractOrigin(url);
+  if (!origin) return false;
+  if (origin !== new URL(url).origin) return null;
+  return compiledWhitelist.some(x => new RegExp(x).test(origin));
+};
+
+const compileWhitelist = (
+  originWhitelist: readonly string[],
+): readonly string[] =>
+  ['about:blank', ...(originWhitelist || [])].map(originWhitelistToRegex);
+
+const createOnShouldStartLoadWithRequest = (
+  loadRequest: (
+    shouldStart: boolean,
+    url: string,
+    lockIdentifier: number,
+  ) => void,
+  originWhitelist: readonly string[],
+  onShouldStartLoadWithRequest?: OnShouldStartLoadWithRequest,
+) => {
+  return ({ nativeEvent }: ShouldStartLoadRequestEvent) => {
+    let shouldStart = true;
+    const { url, lockIdentifier } = nativeEvent;
+
+    if (!_passesWhitelist(compileWhitelist(originWhitelist), url)) {
+      Linking.canOpenURL(url).then((supported) => {
+        if (supported && /^https:\/\//.test(url)) {
+          return Linking.openURL(url);
+        }
+        console.warn(`Can't open url: ${url}`);
+        return undefined;
+      }).catch(e => {
+        console.warn('Error opening URL: ', e);
+      });
+      shouldStart = false;
+    } else if (onShouldStartLoadWithRequest) {
+      shouldStart = onShouldStartLoadWithRequest(nativeEvent);
+    }
+
+    loadRequest(shouldStart, url, lockIdentifier);
+  };
+};
+
+const defaultRenderLoading = () => (
+  <View style={styles.loadingOrErrorView}>
+    <ActivityIndicator />
+  </View>
+);
+const defaultRenderError = (
+  errorDomain: string | undefined,
+  errorCode: number,
+  errorDesc: string,
+) => (
+  <View style={styles.loadingOrErrorView}>
+    <Text style={styles.errorTextTitle}>Error loading page</Text>
+    <Text style={styles.errorText}>{`Domain: ${errorDomain}`}</Text>
+    <Text style={styles.errorText}>{`Error Code: ${errorCode}`}</Text>
+    <Text style={styles.errorText}>{`Description: ${errorDesc}`}</Text>
+  </View>
+);
+
+export {
+  defaultOriginWhitelist,
+  createOnShouldStartLoadWithRequest,
+  defaultRenderLoading,
+  defaultRenderError,
+};
+
+
+export const useWebWiewLogic = ({
+  startInLoadingState,
+  onLoadStart,
+  onLoad,
+  onLoadEnd,
+  onError,
+  onMessageProp,
+  originWhitelist,
+  onShouldStartLoadWithRequestProp,
+  onShouldStartLoadWithRequestCallback,
+  validateMeta,
+  validateData,
+}: {
+  startInLoadingState?: boolean
+  onLoadStart?: (event: WebViewNavigationEvent) => void;
+  onLoad?: (event: WebViewNavigationEvent) => void;
+  onLoadEnd?: (event: WebViewNavigationEvent | WebViewErrorEvent) => void;
+  onError?: (event: WebViewErrorEvent) => void;
+  onMessageProp?: (event: WebViewMessage) => void;
+  originWhitelist: readonly string[];
+  onShouldStartLoadWithRequestProp?: OnShouldStartLoadWithRequest;
+  onShouldStartLoadWithRequestCallback: (shouldStart: boolean, url: string, lockIdentifier?: number | undefined) => void;
+  validateMeta: (event: WebViewNativeEvent) => WebViewNativeEvent;
+  validateData: (data: object) => object;
+}) => {
+
+  const [viewState, setViewState] = useState<'IDLE' | 'LOADING' | 'ERROR'>(startInLoadingState ? "LOADING" : "IDLE");
+  const [lastErrorEvent, setLastErrorEvent] = useState<WebViewError | null>(null);
+  const startUrl = useRef<string | null>(null)
+
+  const passesWhitelist = (url: string) => {
+    if (!url || typeof url !== 'string') return false;
+    return _passesWhitelist(compileWhitelist(originWhitelist), url);
+  }
+
+  const passesWhitelistUse = useCallback(passesWhitelist, [originWhitelist])
+
+  const extractMeta = (nativeEvent: WebViewNativeEvent): WebViewNativeEvent => ({
+    url: String(nativeEvent.url),
+    loading: Boolean(nativeEvent.loading),
+    title: String(nativeEvent.title),
+    canGoBack: Boolean(nativeEvent.canGoBack),
+    canGoForward: Boolean(nativeEvent.canGoForward),
+    lockIdentifier: Number(nativeEvent.lockIdentifier),
+  });
+
+  const onLoadingStart = useCallback((event: WebViewNavigationEvent) => {
+    // Needed for android
+    startUrl.current = event.nativeEvent.url;
+    // !Needed for android
+
+    onLoadStart?.(event);
+  }, [onLoadStart]);
+
+  const onLoadingError = useCallback((event: WebViewErrorEvent) => {
+    event.persist();
+    if (onError) {
+      onError(event);
+    } else {
+      console.warn('Encountered an error loading page', event.nativeEvent);
+    }
+    onLoadEnd?.(event);
+    if (event.isDefaultPrevented()) { return };
+    setViewState('ERROR');
+    setLastErrorEvent(event.nativeEvent);
+  }, [onError, onLoadEnd]);
+
+  const onLoadingFinish = useCallback((event: WebViewNavigationEvent) => {
+    onLoad?.(event);
+    onLoadEnd?.(event);
+    const { nativeEvent: { url } } = event;
+    if (!passesWhitelistUse(url)) return;
+
+    // on Android, only if url === startUrl
+    if (Platform.OS !== "android" || url === startUrl.current) {
+      setViewState('IDLE');
+    }
+    // !on Android, only if url === startUrl
+    // REMOVED: updateNavigationState(event);
+  }, [onLoad, onLoadEnd, passesWhitelistUse]);
+
+  const onMessage = useCallback((event: WebViewMessageEvent) => {
+    const { nativeEvent } = event;
+    if (!passesWhitelistUse(nativeEvent.url)) return;
+
+    // TODO: can/should we perform any other validation?
+
+    const data = JSON.stringify(validateData(JSON.parse(nativeEvent.data)));
+    const meta = validateMeta(extractMeta(nativeEvent));
+
+    onMessageProp?.({ ...meta, data });
+  }, [onMessageProp, passesWhitelistUse, validateData, validateMeta]);
+
+  const onLoadingProgress = useCallback((event: WebViewProgressEvent) => {
+    const { nativeEvent: { progress } } = event;
+    if (!passesWhitelistUse(event.nativeEvent.url)) return;
+
+    // patch for Android only
+    if (Platform.OS === "android" && progress === 1) {
+      setViewState(prevViewState => prevViewState === 'LOADING' ? 'IDLE' : prevViewState);
+    }
+    // !patch for Android only
+    // REMOVED: onLoadProgress?.(event);
+  }, [passesWhitelistUse]);
+
+  const onShouldStartLoadWithRequest = useMemo(() =>  createOnShouldStartLoadWithRequest(
+      onShouldStartLoadWithRequestCallback,
+      originWhitelist,
+      onShouldStartLoadWithRequestProp,
+    )
+  , [originWhitelist, onShouldStartLoadWithRequestProp, onShouldStartLoadWithRequestCallback])
+
+  return {
+    onShouldStartLoadWithRequest,
+    onLoadingStart,
+    onLoadingProgress,
+    onLoadingError,
+    onLoadingFinish,
+    onMessage,
+    passesWhitelist,
+    viewState,
+    setViewState,
+    lastErrorEvent,
+  }
+};
+
+export const versionPasses = (version: string | undefined, minimum: string | undefined): boolean => {
+  if (!version || !minimum) return false
+  if (typeof version !== 'string' || typeof minimum !== 'string') return false
+
+  if (minimum.includes(', ')) {
+    // We have a set of possible versions
+    const variants = minimum.split(', ')
+    // Every entry but the last one should be with an upper bound
+    if (!variants.slice(0, -1).every(x => x.includes(' <'))) return false
+    return variants.some(x => versionPasses(version, x)) // Any match passes
+  }
+
+  if (minimum.includes(' <')) {
+    const [min, max, ...rest] = minimum.split(' <')
+    if (rest.length > 0) return false
+    // Last check is required for correctness/formatting validation
+    return versionPasses(version, min) && !versionPasses(version, max) && versionPasses(max, version)
+  }
+
+  const versionRegex = /^[0-9]+(\.[0-9]+)*$/
+  if (!versionRegex.test(version) || !versionRegex.test(minimum)) return false
+  const versionParts = version.split('.').map(Number)
+  const minimumParts = minimum.split('.').map(Number)
+  const len = Math.max(versionParts.length, minimumParts.length)
+  for (let i = 0; i < len; i += 1) {
+    const ver = versionParts[i] || 0
+    const min = minimumParts[i] || 0
+    if (ver > min) return true
+    if (ver < min) return false
+  }
+  return true // equals
+}