xref: /expo/packages/expo-router/src/fork/useLinking.native.ts (revision 26ad19fc)

// Forked from react-navigation with a custom `extractPathFromURL` that automatically
// allows any prefix and parses Expo Go URLs.
// For simplicity the following are disabled: enabled, prefixes, independent
// https://github.com/react-navigation/react-navigation/blob/main/packages/native/src/useLinking.native.tsx
import {
  getActionFromState as getActionFromStateDefault,
  getStateFromPath as getStateFromPathDefault,
  NavigationContainerRef,
  ParamListBase,
} from '@react-navigation/core';
import type { LinkingOptions } from '@react-navigation/native';
import * as React from 'react';
import { Linking, Platform } from 'react-native';

import { extractExpoPathFromURL } from './extractPathFromURL';

type ResultState = ReturnType<typeof getStateFromPathDefault>;

type Options = LinkingOptions<ParamListBase>;

const linkingHandlers: symbol[] = [];

export default function useLinking(
  ref: React.RefObject<NavigationContainerRef<ParamListBase>>,
  {
    // enabled = true,
    // prefixes,
    filter,
    config,
    getInitialURL = () =>
      Promise.race([
        Linking.getInitialURL(),
        new Promise<undefined>((resolve) =>
          // Timeout in 150ms if `getInitialState` doesn't resolve
          // Workaround for https://github.com/facebook/react-native/issues/25675
          setTimeout(resolve, 150)
        ),
      ]),
    subscribe = (listener) => {
      const callback = ({ url }: { url: string }) => listener(url);

      const subscription = Linking.addEventListener('url', callback) as
        | { remove(): void }
        | undefined;

      return () => {
        subscription?.remove();
      };
    },
    getStateFromPath = getStateFromPathDefault,
    getActionFromState = getActionFromStateDefault,
  }: Options
) {
  //   const independent = useNavigationIndependentTree();

  React.useEffect(
    () => {
      if (process.env.NODE_ENV === 'production') {
        return undefined;
      }

      // if (independent) {
      //   return undefined;
      // }

      if (
        // enabled !== false &&
        linkingHandlers.length
      ) {
        console.error(
          [
            'Looks like you have configured linking in multiple places. This is likely an error since deep links should only be handled in one place to avoid conflicts. Make sure that:',
            "- You don't have multiple NavigationContainers in the app each with 'linking' enabled",
            '- Only a single instance of the root component is rendered',
            Platform.OS === 'android'
              ? "- You have set 'android:launchMode=singleTask' in the '<activity />' section of the 'AndroidManifest.xml' file to avoid launching multiple instances"
              : '',
          ]
            .join('\n')
            .trim()
        );
      }

      const handler = Symbol();

      // if (enabled !== false) {
      linkingHandlers.push(handler);
      // }

      return () => {
        const index = linkingHandlers.indexOf(handler);

        if (index > -1) {
          linkingHandlers.splice(index, 1);
        }
      };
    },
    [
      // enabled,
      // independent
    ]
  );

  // We store these options in ref to avoid re-creating getInitialState and re-subscribing listeners
  // This lets user avoid wrapping the items in `React.useCallback` or `React.useMemo`
  // Not re-creating `getInitialState` is important coz it makes it easier for the user to use in an effect
  //   const enabledRef = React.useRef(enabled);
  //   const prefixesRef = React.useRef(prefixes);
  const filterRef = React.useRef(filter);
  const configRef = React.useRef(config);
  const getInitialURLRef = React.useRef(getInitialURL);
  const getStateFromPathRef = React.useRef(getStateFromPath);
  const getActionFromStateRef = React.useRef(getActionFromState);

  React.useEffect(() => {
    // enabledRef.current = enabled;
    // prefixesRef.current = prefixes;
    filterRef.current = filter;
    configRef.current = config;
    getInitialURLRef.current = getInitialURL;
    getStateFromPathRef.current = getStateFromPath;
    getActionFromStateRef.current = getActionFromState;
  });

  const getStateFromURL = React.useCallback((url: string | null | undefined) => {
    if (!url || (filterRef.current && !filterRef.current(url))) {
      return undefined;
    }

    // NOTE(EvanBacon): This is the important part.
    const path = extractExpoPathFromURL(url);

    return path !== undefined ? getStateFromPathRef.current(path, configRef.current) : undefined;
  }, []);

  const getInitialState = React.useCallback(() => {
    // let state: ResultState | undefined;
    // if (enabledRef.current) {
    const url = getInitialURLRef.current();

    if (url != null && typeof url !== 'string') {
      return url.then((url) => {
        const state = getStateFromURL(url);

        return state;
      });
    }

    const state = getStateFromURL(url);
    // }

    const thenable = {
      then(onfulfilled?: (state: ResultState | undefined) => void) {
        onfulfilled?.(state);
        return thenable;
      },
      catch() {
        return thenable;
      },
    };

    return thenable as PromiseLike<ResultState | undefined>;
  }, [getStateFromURL]);

  React.useEffect(() => {
    const listener = (url: string) => {
      //   if (!enabled) {
      //     return;
      //   }

      const navigation = ref.current;
      const state = navigation ? getStateFromURL(url) : undefined;

      if (navigation && state) {
        // Make sure that the routes in the state exist in the root navigator
        // Otherwise there's an error in the linking configuration
        const rootState = navigation.getRootState();

        if (state.routes.some((r) => !rootState?.routeNames.includes(r.name))) {
          console.warn(
            "The navigation state parsed from the URL contains routes not present in the root navigator. This usually means that the linking configuration doesn't match the navigation structure. See https://reactnavigation.org/docs/configuring-links for more details on how to specify a linking configuration."
          );
          return;
        }

        const action = getActionFromStateRef.current(state, configRef.current);

        if (action !== undefined) {
          try {
            navigation.dispatch(action);
          } catch (e) {
            // Ignore any errors from deep linking.
            // This could happen in case of malformed links, navigation object not being initialized etc.
            console.warn(
              `An error occurred when trying to handle the link '${url}': ${
                typeof e === 'object' && e != null && 'message' in e ? e.message : e
              }`
            );
          }
        } else {
          navigation.resetRoot(state);
        }
      }
    };

    return subscribe(listener);
  }, [
    // enabled,
    getStateFromURL,
    ref,
    subscribe,
  ]);

  return {
    getInitialState,
  };
}