Skip to main content

Function: useFind()

function useFind(
stack,
query,
sort?,
limit?): object;

Defined in: react/src/hooks/index.ts:178

Hook to find documents in a stack using a Mango selector.

Parameters

ParameterTypeDefault valueDescription
stackstringundefinedThe name of the stack to query.
query{ fields?: string[]; selector: { [key: string]: string | number; }; }undefinedObject containing the selector and optional fields projection.
query.fields?string[]undefined-
query.selector?{ [key: string]: string | number; }undefined-
sort?anyundefinedOptional sort criteria.
limit?number50Maximum number of documents to return (default: 50).

Returns

object

Object containing the list of documents, loading state, and error.

NameTypeDefined in
docsDocument[]react/src/hooks/index.ts:261
errornullreact/src/hooks/index.ts:261
loadingbooleanreact/src/hooks/index.ts:261

Example

const ActiveTasks = () => {
const { docs, loading } = useFind('my-stack', {
selector: {
"~class": "Task",
active: true
},
fields: ['_id', 'title']
});

if (loading) return <div>Loading...</div>;

return (
<ul>
{docs.map(doc => <li key={doc._id}>{doc.title}</li>)}
</ul>
);
};