react-native-reanimated/src/platformFunctions/scrollTo.ts

More powerful alternative to Animated library for React Native.

'use strict';
import { IS_JEST, logger, SHOULD_BE_USE_WEB } from '../common';
import type { InstanceOrElement } from '../commonTypes';
import type { AnimatedRef } from '../hook/commonTypes';
import { dispatchCommand } from './dispatchCommand';

type ScrollTo = <TRef extends InstanceOrElement>(
  animatedRef: AnimatedRef<TRef>,
  x: number,
  y: number,
  animated: boolean
) => void;

/**
 * Lets you synchronously scroll to a given position of a `ScrollView`.
 *
 * @param animatedRef - An [animated
 *   ref](https://docs.swmansion.com/react-native-reanimated/docs/core/useAnimatedRef)
 *   attached to an `Animated.ScrollView` component.
 * @param x - The x position you want to scroll to.
 * @param y - The y position you want to scroll to.
 * @param animated - Whether the scrolling should be smooth or instant.
 * @see https://docs.swmansion.com/react-native-reanimated/docs/scroll/scrollTo
 */
export let scrollTo: ScrollTo;

function scrollToNative<TRef extends InstanceOrElement>(
  animatedRef: AnimatedRef<TRef>,
  x: number,
  y: number,
  animated: boolean
) {
  'worklet';
  dispatchCommand(animatedRef, 'scrollTo', [x, y, animated]);
}

function scrollToJest() {
  logger.warn('scrollTo() is not supported with Jest.');
}

function scrollToDefault() {
  logger.warn('scrollTo() is not supported on this configuration.');
}

if (!SHOULD_BE_USE_WEB) {
  // Those assertions are actually correct since on Native platforms `AnimatedRef` is
  // mapped as a different function in `serializableMappingCache` and
  // TypeScript is not able to infer that.
  scrollTo = scrollToNative as unknown as ScrollTo;
} else if (IS_JEST) {
  scrollTo = scrollToJest;
} else {
  scrollTo = scrollToDefault;
}