React & React NativeHooksUsersuseFetchUserSuggestions

useFetchUserSuggestions

Overview

The useFetchUserSuggestions hook is used to retrieve a list of suggested users based on a search query. This is commonly used in features like @mentions, user search, or friend suggestions.

Usage Example

import { useFetchUserSuggestions } from "@replyke/react-js";
 
function UserSuggestions({ query }: { query: string }) {
  const fetchUserSuggestions = useFetchUserSuggestions();
 
  const handleFetchSuggestions = async () => {
    try {
      const suggestions = await fetchUserSuggestions({ query });
      console.log("User suggestions:", suggestions);
    } catch (error) {
      console.error("Failed to fetch user suggestions:", error.message);
    }
  };
 
  return <button onClick={handleFetchSuggestions}>Get User Suggestions</button>;
}

Parameters & Returns

Parameters

The hook returns a function that accepts the following parameter:

ParameterTypeRequiredDescription
querystringYesThe search query for user suggestions.

Returns

The function resolves with an array of user objects:

Return ValueTypeDescription
User[]User[]A list of user objects matching the query.

Implementation Details

  • Uses the public API endpoint (no authentication required)
  • Searches users within the current project context
  • Returns full User objects with all available user information
  • Typically used as a building block for more complex mention functionality