Skip to main content
Version: 6.1

Images and other Media

After setting up Rest Hooks for structured data fetching, you might want to incorporate some media fetches as well to take advantage of suspense and concurrent mode support.

Storing buffers

Resource and Entity should not be used in this case, since they both represent string -> value map structures. Instead, we'll define our own simple Endpoint.

import { Endpoint } from 'rest-hooks';

export const getPhoto = new Endpoint(async ({ userId }: { userId: string }) => {
const response = await fetch(`/users/${userId}/photo`);
const photoArrayBuffer = await response.arrayBuffer();

return photoArrayBuffer;
});
// photo is typed as ArrayBuffer
const photo = useResource(getPhoto, { userId });

Just Images

In many cases, it would be useful to suspend loading of expensive items like images using suspense. This becomes especially powerful with the fetch as you render pattern in concurrent mode.

@rest-hooks/img provides use with <Img /> component that suspends, as well as getImage endpoint to prefetch.

Installation

npm install --save @rest-hooks/img

Usage

Profile.tsx
import React, { ImgHTMLAttributes } from 'react';
import { useResource } from 'rest-hooks';
import { Img } from '@rest-hooks/img';

export default function Profile({ username }: { username: string }) {
const user = useResource(UseResource.detail(), { username });
return (
<div>
<Img
src={user.img}
alt="React Logo"
style={{ height: '32px', width: '32px' }}
/>
<h2>{user.fullName}</h2>
</div>
);
}

Prefetching

Note this will cascade the requests, waiting for user to resolve before the image request can start. If the image url is deterministic based on the same parameters, we can start that request at the same time as the user request:

Profile.tsx
import React, { ImgHTMLAttributes } from 'react';
import { useResource, useRetrieve } from 'rest-hooks';
import { Img, getImage } from '@rest-hooks/img';

export default function Profile({ username }: { username: string }) {
const imageSrc = `/profile_images/${username}}`;
useRetrieve(getImage, { src: imageSrc });
const user = useResource(UseResource.detail(), { username });
return (
<div>
<Img
src={imageSrc}
alt="React Logo"
style={{ height: '32px', width: '32px' }}
/>
<h2>{user.fullName}</h2>
</div>
);
}

When using the fetch as you render pattern in concurrent mode, Controller.fetch() with the getImage Endpoint to preload the image.