/** * Copyright (c) Meta Platforms, Inc. and affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. * * @flow * @format */ import * as React from 'react'; import StyleSheet from '../StyleSheet/StyleSheet'; import ImageInjection from './ImageInjection'; import ImageAnalyticsTagContext from './ImageAnalyticsTagContext'; import flattenStyle from '../StyleSheet/flattenStyle'; import resolveAssetSource from './resolveAssetSource'; import type {ImageProps as ImagePropsType} from './ImageProps'; import type {ImageStyleProp} from '../StyleSheet/StyleSheet'; import NativeImageLoaderIOS from './NativeImageLoaderIOS'; import ImageViewNativeComponent from './ImageViewNativeComponent'; import type {RootTag} from 'react-native/Libraries/Types/RootTagTypes'; function getSize( uri: string, success: (width: number, height: number) => void, failure?: (error: any) => void, ) { NativeImageLoaderIOS.getSize(uri) .then(([width, height]) => success(width, height)) .catch( failure || function () { console.warn('Failed to get size for image ' + uri); }, ); } function getSizeWithHeaders( uri: string, headers: {[string]: string, ...}, success: (width: number, height: number) => void, failure?: (error: any) => void, ): any { return NativeImageLoaderIOS.getSizeWithHeaders(uri, headers) .then(function (sizes) { success(sizes.width, sizes.height); }) .catch( failure || function () { console.warn('Failed to get size for image: ' + uri); }, ); } function prefetchWithMetadata( url: string, queryRootName: string, rootTag?: ?RootTag, ): any { if (NativeImageLoaderIOS.prefetchImageWithMetadata) { // number params like rootTag cannot be nullable before TurboModules is available return NativeImageLoaderIOS.prefetchImageWithMetadata( url, queryRootName, // NOTE: RootTag type // $FlowFixMe[incompatible-call] RootTag: number is incompatible with RootTag rootTag ? rootTag : 0, ); } else { return NativeImageLoaderIOS.prefetchImage(url); } } function prefetch(url: string): any { return NativeImageLoaderIOS.prefetchImage(url); } async function queryCache( urls: Array, ): Promise<{[string]: 'memory' | 'disk' | 'disk/memory', ...}> { return await NativeImageLoaderIOS.queryCache(urls); } export type ImageComponentStatics = $ReadOnly<{| getSize: typeof getSize, getSizeWithHeaders: typeof getSizeWithHeaders, prefetch: typeof prefetch, prefetchWithMetadata: typeof prefetchWithMetadata, queryCache: typeof queryCache, resolveAssetSource: typeof resolveAssetSource, |}>; /** * A React component for displaying different types of images, * including network images, static resources, temporary local images, and * images from local disk, such as the camera roll. * * See https://reactnative.dev/docs/image */ const BaseImage = (props: ImagePropsType, forwardedRef) => { const source = resolveAssetSource(props.source) || { uri: undefined, width: undefined, height: undefined, }; let sources; let style: ImageStyleProp; if (Array.isArray(source)) { style = flattenStyle([styles.base, props.style]) || {}; sources = source; } else { const {width, height, uri} = source; style = flattenStyle([{width, height}, styles.base, props.style]) || {}; sources = [source]; if (uri === '') { console.warn('source.uri should not be an empty string'); } } const resizeMode = props.resizeMode || style.resizeMode || 'cover'; const tintColor = style.tintColor; if (props.src != null) { console.warn( 'The component requires a `source` property rather than `src`.', ); } if (props.children != null) { throw new Error( 'The component cannot contain children. If you want to render content on top of the image, consider using the component or absolute positioning.', ); } return ( {analyticTag => { return ( ); }} ); }; const ImageForwardRef = React.forwardRef< ImagePropsType, React.ElementRef, >(BaseImage); let Image = ImageForwardRef; if (ImageInjection.unstable_createImageComponent != null) { Image = ImageInjection.unstable_createImageComponent(Image); } Image.displayName = 'Image'; /** * Retrieve the width and height (in pixels) of an image prior to displaying it. * * See https://reactnative.dev/docs/image#getsize */ /* $FlowFixMe[prop-missing] (>=0.89.0 site=react_native_ios_fb) This comment * suppresses an error found when Flow v0.89 was deployed. To see the error, * delete this comment and run Flow. */ Image.getSize = getSize; /** * Retrieve the width and height (in pixels) of an image prior to displaying it * with the ability to provide the headers for the request. * * See https://reactnative.dev/docs/image#getsizewithheaders */ /* $FlowFixMe[prop-missing] (>=0.89.0 site=react_native_ios_fb) This comment * suppresses an error found when Flow v0.89 was deployed. To see the error, * delete this comment and run Flow. */ Image.getSizeWithHeaders = getSizeWithHeaders; /** * Prefetches a remote image for later use by downloading it to the disk * cache. * * See https://reactnative.dev/docs/image#prefetch */ /* $FlowFixMe[prop-missing] (>=0.89.0 site=react_native_ios_fb) This comment * suppresses an error found when Flow v0.89 was deployed. To see the error, * delete this comment and run Flow. */ Image.prefetch = prefetch; /** * Prefetches a remote image for later use by downloading it to the disk * cache, and adds metadata for queryRootName and rootTag. * * See https://reactnative.dev/docs/image#prefetch */ /* $FlowFixMe[prop-missing] (>=0.89.0 site=react_native_ios_fb) This comment * suppresses an error found when Flow v0.89 was deployed. To see the error, * delete this comment and run Flow. */ Image.prefetchWithMetadata = prefetchWithMetadata; /** * Performs cache interrogation. * * See https://reactnative.dev/docs/image#querycache */ /* $FlowFixMe[prop-missing] (>=0.89.0 site=react_native_ios_fb) This comment * suppresses an error found when Flow v0.89 was deployed. To see the error, * delete this comment and run Flow. */ Image.queryCache = queryCache; /** * Resolves an asset reference into an object. * * See https://reactnative.dev/docs/image#resolveassetsource */ /* $FlowFixMe[prop-missing] (>=0.89.0 site=react_native_ios_fb) This comment * suppresses an error found when Flow v0.89 was deployed. To see the error, * delete this comment and run Flow. */ Image.resolveAssetSource = resolveAssetSource; const styles = StyleSheet.create({ base: { overflow: 'hidden', }, }); module.exports = ((Image: any): React.AbstractComponent< ImagePropsType, React.ElementRef, > & ImageComponentStatics);