The http-react's intro from atomic-state

atomic-state / http-react Goto Github PK

View Code? Open in Web Editor NEW

React hooks for data fetching

License: MIT License

TypeScript 99.77% JavaScript 0.23%

http-react's Introduction

HTTP React

Http React is a React hooks library for data fetching. It's built on top of the native Fetch API.

Overview

With one hook call, you get all the information about a request that you can use to build UIs that are consistent and performant:

import useFetch from 'http-react'

// This is the default fetcher.
const fetcher = (url, config) => fetch(url, config)

export default function App() {
  const { data, loading, error, responseTime } = useFetch('/api/user-info', {
    refresh: '30 sec',
    fetcher
  })

  if (loading) return <p>Loading</p>

  if (error) return <p>An error ocurred</p>

  return (
    <div>
      <h2>Welcome, {data.name}</h2>
      <small>Profile loaded in {responseTime} miliseconds</small>
    </div>
  )
}

It also works with Next.js' server functions:

// actions.ts
'use server'
import { actionData } from 'http-react'

export async function getData({ id }: { id: number }) {
  return actionData(
    { foo: 'bar' },
    // The second argument is only necessary if you
    // want to send something different from 200.
    {
      status: 200
    }
  )
}

// page.tsx
'use client'
import { useServerAction } from 'http-react'

import { getData } from '@/actions'

export default function Page() {
  // data has static typing inferred from the action result
  const { data, isPending, error } = useServerAction(getData, {
    params: {
      id: 1 // This will show an error if id is not a number
    }
  })

  return isPending ? (
    <p>Loading...</p>
  ) : error ? (
    <p>Something went wrong</p>
  ) : (
    <div>
      <h2>Welcome</h2>
      <p>{data.foo}</p>
    </div>
  )
}