expo-router
Version:
Expo Router is a file-based router for React Native and web applications.
176 lines • 6 kB
JavaScript
;
'use client';
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.useRouteInfo = void 0;
exports.useRootNavigationState = useRootNavigationState;
exports.useRootNavigation = useRootNavigation;
exports.useNavigationContainerRef = useNavigationContainerRef;
exports.useRouter = useRouter;
exports.useUnstableGlobalHref = useUnstableGlobalHref;
exports.useSegments = useSegments;
exports.usePathname = usePathname;
exports.useGlobalSearchParams = useGlobalSearchParams;
exports.useLocalSearchParams = useLocalSearchParams;
exports.useSearchParams = useSearchParams;
const native_1 = require("@react-navigation/native");
const react_1 = __importDefault(require("react"));
const Route_1 = require("./Route");
const constants_1 = require("./constants");
const router_store_1 = require("./global-state/router-store");
Object.defineProperty(exports, "useRouteInfo", { enumerable: true, get: function () { return router_store_1.useRouteInfo; } });
const imperative_api_1 = require("./imperative-api");
/**
* Returns the [navigation state](https://reactnavigation.org/docs/navigation-state/)
* of the navigator which contains the current screen.
*
* @example
* ```tsx
* import { useRootNavigationState } from 'expo-router';
*
* export default function Route() {
* const { routes } = useRootNavigationState();
*
* return <Text>{routes[0].name}</Text>;
* }
* ```
*/
function useRootNavigationState() {
return (0, native_1.useNavigation)()
.getParent(constants_1.INTERNAL_SLOT_NAME)
.getState();
}
/**
* @deprecated Use [`useNavigationContainerRef`](#usenavigationcontainerref) instead,
* which returns a React `ref`.
*/
function useRootNavigation() {
return router_store_1.store.navigationRef.current;
}
/**
* @return The root `<NavigationContainer />` ref for the app. The `ref.current` may be `null`
* if the `<NavigationContainer />` hasn't mounted yet.
*/
function useNavigationContainerRef() {
return router_store_1.store.navigationRef;
}
/**
*
* Returns the [Router](#router) object for imperative navigation.
*
* @example
*```tsx
* import { useRouter } from 'expo-router';
* import { Text } from 'react-native';
*
* export default function Route() {
* const router = useRouter();
*
* return (
* <Text onPress={() => router.push('/home')}>Go Home</Text>
* );
*}
* ```
*/
function useRouter() {
return imperative_api_1.router;
}
/**
* @private
* @returns The current global pathname with query params attached. This may change in the future to include the hostname
* from a predefined universal link. For example, `/foobar?hey=world` becomes `https://acme.dev/foobar?hey=world`.
*/
function useUnstableGlobalHref() {
return (0, router_store_1.useRouteInfo)().unstable_globalHref;
}
function useSegments() {
return (0, router_store_1.useRouteInfo)().segments;
}
/**
* Returns the currently selected route location without search parameters. For example, `/acme?foo=bar` returns `/acme`.
* Segments will be normalized. For example, `/[id]?id=normal` becomes `/normal`.
*
* @example
* ```tsx app/profile/[user].tsx
* import { Text } from 'react-native';
* import { usePathname } from 'expo-router';
*
* export default function Route() {
* // pathname = "/profile/baconbrix"
* const pathname = usePathname();
*
* return <Text>User: {user}</Text>;
* }
* ```
*/
function usePathname() {
return (0, router_store_1.useRouteInfo)().pathname;
}
function useGlobalSearchParams() {
return (0, router_store_1.useRouteInfo)().params;
}
function useLocalSearchParams() {
const params = react_1.default.use(Route_1.LocalRouteParamsContext) ?? {};
return Object.fromEntries(Object.entries(params).map(([key, value]) => {
// React Navigation doesn't remove "undefined" values from the params object, and you cannot remove them via
// navigation.setParams as it shallow merges. Hence, we hide them here
if (value === undefined) {
return [key, undefined];
}
if (Array.isArray(value)) {
return [
key,
value.map((v) => {
try {
return decodeURIComponent(v);
}
catch {
return v;
}
}),
];
}
else {
try {
return [key, decodeURIComponent(value)];
}
catch {
return [key, value];
}
}
}));
}
function useSearchParams({ global = false } = {}) {
const globalRef = react_1.default.useRef(global);
if (process.env.NODE_ENV !== 'production') {
if (global !== globalRef.current) {
console.warn(`Detected change in 'global' option of useSearchParams. This value cannot change between renders`);
}
}
// eslint-disable-next-line react-hooks/rules-of-hooks
const params = global ? useGlobalSearchParams() : useLocalSearchParams();
const entries = Object.entries(params).flatMap(([key, value]) => {
if (global) {
if (key === 'params')
return [];
if (key === 'screen')
return [];
}
return Array.isArray(value) ? value.map((v) => [key, v]) : [[key, value]];
});
return new ReadOnlyURLSearchParams(entries);
}
class ReadOnlyURLSearchParams extends URLSearchParams {
set() {
throw new Error('The URLSearchParams object return from useSearchParams is read-only');
}
append() {
throw new Error('The URLSearchParams object return from useSearchParams is read-only');
}
delete() {
throw new Error('The URLSearchParams object return from useSearchParams is read-only');
}
}
//# sourceMappingURL=hooks.js.map