Choose a version:

useOptimisticCart

The useOptimisticCart takes an existing cart object, processes all pending cart actions, and locally mutates the cart with optimistic state. An optimistic cart makes cart actions immediately render in the browser while actions sync to the server. This increases the perceived performance of the application.

Anchor to useOptimisticCart
useOptimisticCart(
cart
)

Anchor to useOptimisticCart-parametersParameters

Anchor to cart cart DefaultCart required: The cart object from context.cart.get() returned by a server loader.

Anchor to useOptimisticCart-returnsReturns

A new cart object augmented with optimistic state. Each cart line item that is optimistically added includes an isOptimistic property. Also if the cart has any optimistic state, a root property isOptimistic will be set to true.

OptimisticCart

T & {
  isOptimistic?: boolean;
  lines: {nodes: Array<CartLine & {isOptimistic?: boolean}>};
}

CartReturn

Cart & {
  errors?: StorefrontApiErrors;
}

Cart

Cart

StorefrontApiErrors

JsonGraphQLError[] | undefined

Examples

import {defer} from '@shopify/remix-oxygen';

import {Link} from '@remix-run/react';

import {CartForm, useOptimisticCart} from '@shopify/hydrogen';

// Root loader returns the cart data

export async function loader({context}) {

return defer({

cart: context.cart.get(),

});

}

// The cart component renders each line item in the cart.

export function Cart({cart}) {

// `useOptimisticCart` adds optimistic line items to the cart.

// These line items are displayed in the cart until the server responds.

const optimisticCart = useOptimisticCart(cart);

if (!optimisticCart?.lines?.nodes?.length) return <p>Nothing in cart</p>;

return optimisticCart.lines.nodes.map((line) => (

{line.merchandise.product.title}

</Link>

<CartForm

route="/cart"

action={CartForm.ACTIONS.LinesRemove}

inputs={{lineIds: [line.id]}}

{/* Each line item has an `isOptimistic` property. Optimistic line items

should have actions disabled */}

Remove

</button>

</CartForm>

</div>

));

}

Examples

Example code

Description

I am the default example

JavaScript

import {defer} from '@shopify/remix-oxygen';
import {Link} from '@remix-run/react';
import {CartForm, useOptimisticCart} from '@shopify/hydrogen';

// Root loader returns the cart data
export async function loader({context}) {
  return defer({
    cart: context.cart.get(),
  });
}

// The cart component renders each line item in the cart.
export function Cart({cart}) {
  // `useOptimisticCart` adds optimistic line items to the cart.
  // These line items are displayed in the cart until the server responds.
  const optimisticCart = useOptimisticCart(cart);

  if (!optimisticCart?.lines?.nodes?.length) return <p>Nothing in cart</p>;

  return optimisticCart.lines.nodes.map((line) => (
    <div key={line.id}>
      <Link to={`/products${line.merchandise.product.handle}`}>
        {line.merchandise.product.title}
      </Link>
      <CartForm
        route="/cart"
        action={CartForm.ACTIONS.LinesRemove}
        inputs={{lineIds: [line.id]}}
      >
        {/* Each line item has an `isOptimistic` property. Optimistic line items
        should have actions disabled */}
        <button type="submit" disabled={!!line.isOptimistic}>
          Remove
        </button>
      </CartForm>
    </div>
  ));
}

TypeScript

import {defer, type LoaderFunctionArgs} from '@shopify/remix-oxygen';
import {Link} from '@remix-run/react';
import {CartForm, OptimisticCart, useOptimisticCart} from '@shopify/hydrogen';
import type {Cart} from '@shopify/hydrogen-react/storefront-api-types';

// Root loader returns the cart data
export async function loader({context}: LoaderFunctionArgs) {
  return defer({
    cart: context.cart.get(),
  });
}

// The cart component renders each line item in the cart.
export function Cart({cart}: {cart: OptimisticCart}) {
  // `useOptimisticCart` adds optimistic line items to the cart.
  // These line items are displayed in the cart until the server responds.
  const optimisticCart = useOptimisticCart(cart);

  if (!optimisticCart?.lines?.nodes?.length) return <p>Nothing in cart</p>;

  return optimisticCart.lines.nodes.map((line) => (
    <div key={line.id}>
      <Link to={`/products${line.merchandise.product.handle}`}>
        {line.merchandise.product.title}
      </Link>
      <CartForm
        route="/cart"
        action={CartForm.ACTIONS.LinesRemove}
        inputs={{lineIds: [line.id]}}
      >
        {/* Each line item has an `isOptimistic` property. Optimistic line items
        should have actions disabled */}
        <button type="submit" disabled={!!line.isOptimistic}>
          Remove
        </button>
      </CartForm>
    </div>
  ));
}