Expo

React hook that listens to events emitted by the given object. The returned value is an event parameter that gets updated whenever a new event is dispatched.

import { useEvent } from 'expo';
import { VideoPlayer } from 'expo-video';

export function PlayerStatus({ videoPlayer }: { videoPlayer: VideoPlayer }) {
  const { status } = useEvent(videoPlayer, 'statusChange', { status: videoPlayer.status });

  return <Text>{`Player status: ${status}`}</Text>;
}

React hook that listens to events emitted by the given object and calls the listener function whenever a new event is dispatched. The event listener is automatically added during the first render and removed when the component unmounts.

import { useEventListener } from 'expo';
import { useVideoPlayer, VideoView } from 'expo-video';

export function VideoPlayerView() {
  const player = useVideoPlayer(videoSource);

  useEventListener(player, 'playingChange', ({ isPlaying }) => {
    console.log('Player is playing:', isPlaying);
  });

  return <VideoView player={player} />;
}

Returns a shared object, which is automatically cleaned up when the component is unmounted.

Returns a shared object, delegating dependency changes to lifecycle callbacks.

A general error class that should be used for all errors in Expo modules. Guarantees a code field that can be used to differentiate between different types of errors without further subclassing Error.

A class for errors to be thrown when a property is accessed which is unavailable, unsupported, or not currently implemented on the running platform.

A class that provides a consistent API for emitting and listening to events. It shares many concepts with other emitter APIs, such as Node's EventEmitter and fbemitter. When the event is emitted, all of the functions attached to that specific event are called synchronously. Any values returned by the called listeners are ignored and discarded. Its implementation is written in C++ and common for all the platforms.

A class for all native modules. Extends the EventEmitter class.

Base class for all shared objects that extends the EventEmitter class. The implementation is written in C++, installed through JSI and common for mobile platforms.

A SharedObject that holds a reference to any native object. Allows passing references to native instances among different independent libraries.

For instance, ImageRef from expo-image references a Drawable on Android and an UIImage on iOS. Since both types are common on these platforms, different native modules can use them without depending on each other. In particular, this enables the expo-image-manipulator to pass the resulted image directly to the image view from expo-image without any additional writes and reads from the file system.

Create a new permission hook with the permission methods built-in. This can be used to quickly create specific permission hooks in every module.

Create a React ref object that is friendly for snapshots. It will be represented as [React.ref] in snapshots.

Installs Expo Modules on the UI worklet runtime so worklet callbacks and serializable SharedObjects work there.

Returns a boolean value whether the app is running in Expo Go.

Sets the initial React component to render natively in the app's root React Native view on Android, iOS, tvOS and the web.

This method does the following:

• Invokes React Native's AppRegistry.registerComponent.
• Invokes React Native web's AppRegistry.runApplication on web to render to the root index.html file.
• Polyfills the process.nextTick function globally.

This method also adds the following dev-only features that are removed in production bundles.

• Adds the Fast Refresh and bundle splitting indicator to the app.
• Asserts if the expo-updates package is misconfigured.
• Asserts if react-native is not aliased to react-native-web when running in the browser.

See: For information on how to setup registerRootComponent in an existing (bare) React Native app, see Common questions below.

Registers a web module.

Reloads the app. This method works for both release and debug builds.

Unlike Updates.reloadAsync(), this function does not use a new update even if one is available. It only reloads the app using the same JavaScript bundle that is currently running.

Imports the native module registered with given name. In the first place it tries to load the module installed through the JSI host object and then falls back to the bridge proxy module. Notice that the modules loaded from the proxy may not support some features like synchronous functions.

A drop-in replacement for requireNativeComponent.

Imports the native module registered with the given name. The same as requireNativeModule, but returns null when the module cannot be found instead of throwing an error.

React hook that listens to events emitted by the given object and calls the listener function whenever a new event is dispatched. The event listener is automatically added during the first render and removed when the component unmounts.

import { useEventListener } from 'expo';
import { useVideoPlayer, VideoView } from 'expo-video';

export function VideoPlayerView() {
  const player = useVideoPlayer(videoSource);

  useEventListener(player, 'playingChange', ({ isPlaying }) => {
    console.log('Player is playing:', isPlaying);
  });

  return <VideoView player={player} />;
}

A subscription object that allows to conveniently remove an event listener from the emitter.