👀 Check out the changes in Suspensive v2. read more →
Documentation
@suspensive/react
wrap

wrap

wrap was created to wrap components with Suspense, ErrorBoundary, ErrorBoundaryGroup, etc. provided by @suspensive/react.

import { wrap, ErrorBoundaryGroup } from '@suspensive/react'
import { useSuspenseQuery } from '@suspensive/react-query'
 
export const Page = wrap
  .ErrorBoundaryGroup({ blockOutside: true })
  .ErrorBoundary({ fallback: ({ error }) => <PageErrorFallback message={error.message} /> })
  .Suspense({ fallback: <PageSkeleton /> })
  .on(
    // will make <Page/> component wrapped in <ErrorBoundaryGroup/>, <ErrorBoundary/> and <Suspense/>.
    () => {
      const { data: postList } = useSuspenseQuery({
        queryKey: ['posts'],
        queryFn: () => fetch(`https://example.com/posts`).then((res) => res.json()),
      })
 
      return (
        <>
          <ErrorBoundaryGroup.Consumer>
            {(group) => <button onClick={group.reset}>Reset all posts</button>}
          </ErrorBoundaryGroup.Consumer>
          {postList.map((post) => (
            <PostItem id={post.id} />
          ))}
        </>
      )
    }
  )
 
const PostItem =
  wrap.ErrorBoundary({ fallback: ({ error }) => <>{error.message}</> }).Suspense({ fallback: <PostSkeleton /> }).on <
  { id: string } >
  // will make <Post/> component have PostProps wrapped in <ErrorBoundary/> and <Suspense/>.
  ((props) => {
    const { data: post } = useSuspenseQuery({
      queryKey: ['posts', props.id],
      queryFn: () => fetch(`https://example.com/posts/${props.id}`).then((res) => res.json()),
    })
 
    return <>{post.title}</>
  })
import { wrap, ErrorBoundaryGroup } from '@suspensive/react'
import { useSuspenseQuery } from '@suspensive/react-query'
import React, { createElement } from 'react'

import { getPost, getPosts } from './api'

export const Example = wrap
  .ErrorBoundaryGroup({ blockOutside: true })
  .ErrorBoundary({ fallback: ({ error }) => <div>{error.message}</div> })
  .Suspense({ fallback: <div>Loading...</div> })
  .on(() => {
    const { data: postList } = useSuspenseQuery({
      queryKey: ['posts'],
      queryFn: getPosts,
    })

    return (
      <>
        <ErrorBoundaryGroup.Consumer>
          {(group) => <button onClick={group.reset}>Reset all posts</button>}
        </ErrorBoundaryGroup.Consumer>

        {postList.map((post) => (
          <PostItem key={post.id} id={post.id} />
        ))}
      </>
    )
  })

const PostItem = wrap
  .ErrorBoundary({
    fallback: ({ error }) => (
      <div style={{ border: '1px solid black', padding: 10, margin: 10, color: 'red' }}>
        {error.message}
      </div>
    ),
  })
  .Suspense({ fallback: <div>Loading...</div> })
  .on<{ id: number }>((props) => {
    const { data: post } = useSuspenseQuery({
      queryKey: ['posts', props.id],
      queryFn: () => getPost(props.id),
    })
    const [throwError, setThrowError] = React.useState(false)

    return (
      <div style={{ border: '1px solid black', padding: 10, margin: 10 }}>
        <p>{post.title}</p>
        <button onClick={() => setThrowError(true)}>Throw error</button>
        {createElement(() => {
          if (throwError) {
            throw new Error('Error!')
          }

          return null
        })}
      </div>
    )
  })