get()

The get() method retrieves a specific item from your collection by its key. You can access the entire item state, use a custom selector, or use predefined selectors.

import { createCollection } from 'finalstore';
 
const users = createCollection({
  states: {
    name: '',
    age: 0,
    active: true
  },
  actions: {}, // Required, even if empty
  selectors: {
    userDetails: (state) => ({
      displayName: state.name,
      isActive: state.active
    })
  }
});

Basic Usage

// Get entire item state
const user = users.key('user-1').get();
console.log('User:', user);
 
// Get with custom selector
const name = users.key('user-1').get((state) => state.name);
console.log('Name:', name);

With Custom Selectors

function getUserStatus(userId: string) {
  const status = users.key(userId).get((state) => ({
    name: state.name,
    active: state.active
  }));
 
  console.log('User status:', status);
}

With Predefined Selectors

function logUserDetails(userId: string) {
  const details = users.key(userId).getSelector.userDetails();
  console.log('User details:', details);
}

On this page