Type Alias: GetCartItems()

GetCartItems = (cartId) => Promise<GetCartItemsResponse>

Function

Retrieves all items currently in the specified cart.

This method fetches the full list of products that have been added to a cart, including their quantities, configurations, and current prices. It's essential for displaying cart contents, calculating totals, or implementing cart management interfaces.

The response includes complete item details that can be used to render cart items, allow quantity adjustments, show product thumbnails, and display price information.

If the cart is not accessible (e.g., closed, doesn't exist, or forbidden), the method returns an object with a code indicating the specific issue rather than throwing an error.

Parameters

cartId

string

The unique identifier for the cart to retrieve items from

Returns

Promise<GetCartItemsResponse>

A promise that resolves to either an array of cart items or an object indicating why the cart items couldn't be retrieved

Example

// Fetch and display all items in the current cart
const cartItems = await window.mimeeqApp.actions.getCartItems('cart_123456');

// Check if we received an error code
if ('code' in cartItems) {
  if (cartItems.code === 'CART_CLOSED') {
    showMessage('This cart has already been submitted');
  } else if (cartItems.code === 'CART_NOT_FOUND') {
    showMessage('Cart not found - please create a new one');
  }
  return;
}

// Display the cart items
cartItems.forEach(item => {
  addItemToCartDisplay(item);
});