react-native-fast-image 8.8.0 → 8.8.1

package/README.md

@@ -243,11 +243,17 @@ FastImage.preload([
 ])
 ```
 
-It resolves when all the images have loaded or failed, with a result for each source, in order: `{ uri, ok, width, height, error }`. `width` and `height` are the image's size (as in `onLoad`), which is also a way to find an image's size without showing it. A few sources load at a time (3, or `SDWebImagePrefetcher`'s `maxConcurrentPrefetchCount` on iOS), so a long list doesn't hold up the images the app is showing, and at low priority unless the source sets `priority`. It never rejects:
+It resolves when all the images have loaded or failed, with a result for each source, in order: `{ uri, ok: true, width, height }` if it loaded, or `{ uri, ok: false, error }` if it didn't (checking `ok` narrows the type in TypeScript). `width` and `height` are the image's size (as in `onLoad`), which is also a way to find an image's size without showing it. A few sources load at a time (3, or `SDWebImagePrefetcher`'s `maxConcurrentPrefetchCount` on iOS), so a long list doesn't hold up the images the app is showing, and at low priority unless the source sets `priority`. It never rejects:
 
 ```js
 const results = await FastImage.preload(sources)
-const failed = results.filter((result) => !result.ok)
+for (const result of results) {
+    if (result.ok) {
+        console.log(result.uri, result.width, result.height)
+    } else {
+        console.warn(result.uri, result.error)
+    }
+}
 ```
 
 ### `FastImage.clearMemoryCache: () => Promise<void>`

package/dist/index.cjs.js

@@ -125,18 +125,29 @@ const FastImageComponent = (0, react.forwardRef)((props, ref) => /* @__PURE__ */
 	...props
 }));
 FastImageComponent.displayName = "FastImage";
+const noResult = {
+	ok: false,
+	error: "No result"
+};
 const FastImage = FastImageComponent;
 FastImage.resizeMode = resizeMode;
 FastImage.cacheControl = cacheControl;
 FastImage.priority = priority;
 FastImage.preload = (sources) => Promise.resolve(react_native.NativeModules.FastImageView.preload(sources.map((s) => s || {}))).then((results) => sources.map((source, i) => {
 	var _results$i;
-	return {
-		uri: source ? source.uri : void 0,
-		...(_results$i = results === null || results === void 0 ? void 0 : results[i]) !== null && _results$i !== void 0 ? _results$i : {
-			ok: false,
-			error: "No result"
-		}
+	const uri = source ? source.uri : void 0;
+	const result = (_results$i = results === null || results === void 0 ? void 0 : results[i]) !== null && _results$i !== void 0 ? _results$i : noResult;
+	if (!result.ok) return {
+		...result,
+		uri
+	};
+	return typeof uri === "string" ? {
+		...result,
+		uri
+	} : {
+		ok: false,
+		error: "Invalid source: no uri",
+		uri
 	};
 }));
 FastImage.clearMemoryCache = () => react_native.NativeModules.FastImageView.clearMemoryCache();

package/dist/index.cjs.js.flow

@@ -43,14 +43,21 @@ export type ResizeModes = $Values<ResizeMode>
 export type Priorities = $Values<Priority>
 export type CacheControls = $Values<CacheControl>
 
-export type PreloadResult = {|
+export type PreloadSuccess = {|
+    uri: string,
+    ok: true,
+    width: number,
+    height: number,
+|}
+
+export type PreloadFailure = {|
     uri?: string,
-    ok: boolean,
-    width?: number,
-    height?: number,
-    error?: string,
+    ok: false,
+    error: string,
 |}
 
+export type PreloadResult = PreloadSuccess | PreloadFailure
+
 export type PreloadFn = (
     sources: Array<FastImageSource>,
 ) => Promise<Array<PreloadResult>>

package/dist/index.d.ts

@@ -102,13 +102,18 @@ export interface FastImageProps extends AccessibilityProps, ViewProps {
      */
     children?: React.ReactNode;
 }
-export interface PreloadResult {
+export interface PreloadSuccess {
+    uri: string;
+    ok: true;
+    width: number;
+    height: number;
+}
+export interface PreloadFailure {
     uri?: string;
-    ok: boolean;
-    width?: number;
-    height?: number;
-    error?: string;
+    ok: false;
+    error: string;
 }
+export type PreloadResult = PreloadSuccess | PreloadFailure;
 export interface FastImageStaticProperties {
     resizeMode: typeof resizeMode;
     priority: typeof priority;

package/dist/index.js

@@ -102,18 +102,29 @@ const FastImageComponent = forwardRef((props, ref) => /* @__PURE__ */ React.crea
 	...props
 }));
 FastImageComponent.displayName = "FastImage";
+const noResult = {
+	ok: false,
+	error: "No result"
+};
 const FastImage = FastImageComponent;
 FastImage.resizeMode = resizeMode;
 FastImage.cacheControl = cacheControl;
 FastImage.priority = priority;
 FastImage.preload = (sources) => Promise.resolve(NativeModules.FastImageView.preload(sources.map((s) => s || {}))).then((results) => sources.map((source, i) => {
 	var _results$i;
-	return {
-		uri: source ? source.uri : void 0,
-		...(_results$i = results === null || results === void 0 ? void 0 : results[i]) !== null && _results$i !== void 0 ? _results$i : {
-			ok: false,
-			error: "No result"
-		}
+	const uri = source ? source.uri : void 0;
+	const result = (_results$i = results === null || results === void 0 ? void 0 : results[i]) !== null && _results$i !== void 0 ? _results$i : noResult;
+	if (!result.ok) return {
+		...result,
+		uri
+	};
+	return typeof uri === "string" ? {
+		...result,
+		uri
+	} : {
+		ok: false,
+		error: "Invalid source: no uri",
+		uri
 	};
 }));
 FastImage.clearMemoryCache = () => NativeModules.FastImageView.clearMemoryCache();

package/dist/index.js.flow

@@ -43,14 +43,21 @@ export type ResizeModes = $Values<ResizeMode>
 export type Priorities = $Values<Priority>
 export type CacheControls = $Values<CacheControl>
 
-export type PreloadResult = {|
+export type PreloadSuccess = {|
+    uri: string,
+    ok: true,
+    width: number,
+    height: number,
+|}
+
+export type PreloadFailure = {|
     uri?: string,
-    ok: boolean,
-    width?: number,
-    height?: number,
-    error?: string,
+    ok: false,
+    error: string,
 |}
 
+export type PreloadResult = PreloadSuccess | PreloadFailure
+
 export type PreloadFn = (
     sources: Array<FastImageSource>,
 ) => Promise<Array<PreloadResult>>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-fast-image",
-    "version": "8.8.0",
+    "version": "8.8.1",
     "description": "🚩 FastImage, performant React Native image component.",
     "keywords": [
         "cache",