\n ![\"React](\"./docs/head.png\")
\n
\n \n
{userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n {userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n \n {JSON.stringify(data, null, 2)};\n```\n\n### Filter queries\n\nYou can filer the query via a second argument. You can mutate the query in any way that Moralis.Query can.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisQuery(\"GameScore\", query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n);\n```\n\nThis example will fetch the top 3 scores that are at least 100, in descending order.\n\nYou can also filter dynamically, but you need to provide a dependency array as third argument (similar to other hooks), to specify when this hook needs to update.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n);\n```\n\n### Automatic updates with dependencies\n\nThis query will automatically refetch when the limit is changed.\n\nIf you want to disable the automatic fetching, you can also manually fetch. You need to provide `autoFetch: false` as option in the 4th argument. In that case it will ignore the dependencies and will only fetch if you manually call `fetch()`\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [],\n { autoFetch: false },\n);\n\nreturn ;\n```\n\n### Realtime / live queries\n\nThe `useMoralisQuery` hook can also be used to update upon realtime events. All you need to do is provide `live: true`. If any events update the query, then the `data` is automatically updated.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n },\n);\n```\n\nBy default we use these rules\n\n| Eventname | Action |\n| ---------- | ----------------------------------- |\n| `\"create\"` | Add to the data |\n| `\"update\"` | Update if object is already in data |\n| `\"enter\"` | Add to the data |\n| `\"leave\"` | Remove to the data |\n| `\"delete\"` | Remove to the data |\n\nYou can override these rules with your own functions.\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n onLiveEnter: (entity, all) => [...all, entity],\n onLiveCreate: (entity, all) => [...all, entity],\n onLiveDelete: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveLeave: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveUpdate: (entity, all) =>\n all.map(e => (e.id === entity.id ? entity : e)),\n },\n);\n```\n\n## `useMoralisSubscription()`\n\n### Listen for query events\n\nThis hook is used when you use `useMoralisQuery` with `live: true`. But if you want fine-grained control over subscriptions, and want to do actions upon the events, then you can use this hook.\n\nIt's as simple as calling this hook with the callbacks that you want. The first 3 arguments are the same as `useMoralisQuery` (queryName, filter, dependencies). In the last argument, you can specify the callbacks:\n\n| Eventname | callback |\n| ---------- | -------- |\n| `\"create\"` | onCreate |\n| `\"update\"` | onUpdate |\n| `\"enter\"` | onEnter |\n| `\"leave\"` | onLeave |\n| `\"delete\"` | onDelete |\n\nThey will all return the object as data.\n\nFor example if you want to notify when a new player was added:\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n});\n```\n\nThis hook will handle the subscribing and unsubscribing automatically. It will automatically subscribe/unsubscribe when the component mounts/unmounts. All you have to do is use this hook.\n\nYou can disable the subscription by providing: `enabled: false`\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n enabled: false,\n});\n```\n\n## `useMoralisFile()`\n\nGet the data, and saveFunction with the `useMoralisFile` hook\n\n```jsx\nconst {\n error,\n isUploading,\n moralisFile,\n saveFile,\n} = useMoralisFile();\n```\n\n### Save to Moralis\n\nAll you need to do is call the save function with a valid file:\n\n```jsx\nsaveFile(\"batman.jpeg\", file);\n```\n\nThen you can read the state from the provided variables `error`,\n`isUploading` and\n`moralisFile`,\n\n### Save to IPFS\n\n```jsx\nsaveFile(\"batman.jpeg\", file, { saveIPFS: true });\n```\n\nThen you can get the ipfs data via `moralisFile._ipfs` and `moralisFile._hash` or `moralisFile.ipfs()` and `moralisFile.hash()` \n\n### Other options\n\nAdditionally you can also provide metadata, tags or specify the fileType in the options like:\n\n*Example:*\n\n```jsx\nconst metadata = { createdById: \"some-user-id\" };\nconst tags = { groupId: \"some-group-id\" };\n\nsaveFile(\"batman.jpeg\", file, {\n type: \"image/jpeg\",\n metadata,\n tags,\n saveIPFS: true,\n});\n```\n\n## `useMoralisCloudFunction()`\n\nYou can use the `useMoralisCloudFunction` hook to run cloud functions easily. All you need to do is provide a name for the function, and it will automatically fetch the data for you.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\");\n```\n\nIf you have a function that requires parameters, then you can provide it as second argument:\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\", {\n limit,\n});\n```\n\n### Trigger manually\n\nIf you rather want to trigger the fetching manually, you can provide `autoFetch: false` as option. And call the `fetch` function manually.\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisCloudFunction(\n \"topScores\",\n {\n limit\n },\n { autoFetch: false }\n);\n\n\n \n
{userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n {userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n \n {JSON.stringify(data, null, 2)};\n```\n\n### Filter queries\n\nYou can filer the query via a second argument. You can mutate the query in any way that Moralis.Query can.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisQuery(\"GameScore\", query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n);\n```\n\nThis example will fetch the top 3 scores that are at least 100, in descending order.\n\nYou can also filter dynamically, but you need to provide a dependency array as third argument (similar to other hooks), to specify when this hook needs to update.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n);\n```\n\n### Automatic updates with dependencies\n\nThis query will automatically refetch when the limit is changed.\n\nIf you want to disable the automatic fetching, you can also manually fetch. You need to provide `autoFetch: false` as option in the 4th argument. In that case it will ignore the dependencies and will only fetch if you manually call `fetch()`\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [],\n { autoFetch: false },\n);\n\nreturn ;\n```\n\n### Realtime / live queries\n\nThe `useMoralisQuery` hook can also be used to update upon realtime events. All you need to do is provide `live: true`. If any events update the query, then the `data` is automatically updated.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n },\n);\n```\n\nBy default we use these rules\n\n| Eventname | Action |\n| ---------- | ----------------------------------- |\n| `\"create\"` | Add to the data |\n| `\"update\"` | Update if object is already in data |\n| `\"enter\"` | Add to the data |\n| `\"leave\"` | Remove to the data |\n| `\"delete\"` | Remove to the data |\n\nYou can override these rules with your own functions.\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n onLiveEnter: (entity, all) => [...all, entity],\n onLiveCreate: (entity, all) => [...all, entity],\n onLiveDelete: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveLeave: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveUpdate: (entity, all) =>\n all.map(e => (e.id === entity.id ? entity : e)),\n },\n);\n```\n\n## `useMoralisSubscription()`\n\n### Listen for query events\n\nThis hook is used when you use `useMoralisQuery` with `live: true`. But if you want fine-grained control over subscriptions, and want to do actions upon the events, then you can use this hook.\n\nIt's as simple as calling this hook with the callbacks that you want. The first 3 arguments are the same as `useMoralisQuery` (queryName, filter, dependencies). In the last argument, you can specify the callbacks:\n\n| Eventname | callback |\n| ---------- | -------- |\n| `\"create\"` | onCreate |\n| `\"update\"` | onUpdate |\n| `\"enter\"` | onEnter |\n| `\"leave\"` | onLeave |\n| `\"delete\"` | onDelete |\n\nThey will all return the object as data.\n\nFor example if you want to notify when a new player was added:\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n});\n```\n\nThis hook will handle the subscribing and unsubscribing automatically. It will automatically subscribe/unsubscribe when the component mounts/unmounts. All you have to do is use this hook.\n\nYou can disable the subscription by providing: `enabled: false`\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n enabled: false,\n});\n```\n\n## `useMoralisFile()`\n\nGet the data, and saveFunction with the `useMoralisFile` hook\n\n```jsx\nconst {\n error,\n isUploading,\n moralisFile,\n saveFile,\n} = useMoralisFile();\n```\n\n### Save to Moralis\n\nAll you need to do is call the save function with a valid file:\n\n```jsx\nsaveFile(\"batman.jpeg\", file);\n```\n\nThen you can read the state from the provided variables `error`,\n`isUploading` and\n`moralisFile`,\n\n### Save to IPFS\n\n```jsx\nsaveFile(\"batman.jpeg\", file, { saveIPFS: true });\n```\n\nThen you can get the ipfs data via `moralisFile._ipfs` and `moralisFile._hash` or `moralisFile.ipfs()` and `moralisFile.hash()` \n\n### Other options\n\nAdditionally you can also provide metadata, tags or specify the fileType in the options like:\n\n*Example:*\n\n```jsx\nconst metadata = { createdById: \"some-user-id\" };\nconst tags = { groupId: \"some-group-id\" };\n\nsaveFile(\"batman.jpeg\", file, {\n type: \"image/jpeg\",\n metadata,\n tags,\n saveIPFS: true,\n});\n```\n\n## `useMoralisCloudFunction()`\n\nYou can use the `useMoralisCloudFunction` hook to run cloud functions easily. All you need to do is provide a name for the function, and it will automatically fetch the data for you.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\");\n```\n\nIf you have a function that requires parameters, then you can provide it as second argument:\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\", {\n limit,\n});\n```\n\n### Trigger manually\n\nIf you rather want to trigger the fetching manually, you can provide `autoFetch: false` as option. And call the `fetch` function manually.\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisCloudFunction(\n \"topScores\",\n {\n limit\n },\n { autoFetch: false }\n);\n\n\n \n
{userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n {userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n \n {JSON.stringify(data, null, 2)};\n```\n\n### Filter queries\n\nYou can filer the query via a second argument. You can mutate the query in any way that Moralis.Query can.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisQuery(\"GameScore\", query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n);\n```\n\nThis example will fetch the top 3 scores that are at least 100, in descending order.\n\nYou can also filter dynamically, but you need to provide a dependency array as third argument (similar to other hooks), to specify when this hook needs to update.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n);\n```\n\n### Automatic updates with dependencies\n\nThis query will automatically refetch when the limit is changed.\n\nIf you want to disable the automatic fetching, you can also manually fetch. You need to provide `autoFetch: false` as option in the 4th argument. In that case it will ignore the dependencies and will only fetch if you manually call `fetch()`\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [],\n { autoFetch: false },\n);\n\nreturn ;\n```\n\n### Realtime / live queries\n\nThe `useMoralisQuery` hook can also be used to update upon realtime events. All you need to do is provide `live: true`. If any events update the query, then the `data` is automatically updated.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n },\n);\n```\n\nBy default we use these rules\n\n| Eventname | Action |\n| ---------- | ----------------------------------- |\n| `\"create\"` | Add to the data |\n| `\"update\"` | Update if object is already in data |\n| `\"enter\"` | Add to the data |\n| `\"leave\"` | Remove to the data |\n| `\"delete\"` | Remove to the data |\n\nYou can override these rules with your own functions.\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n onLiveEnter: (entity, all) => [...all, entity],\n onLiveCreate: (entity, all) => [...all, entity],\n onLiveDelete: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveLeave: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveUpdate: (entity, all) =>\n all.map(e => (e.id === entity.id ? entity : e)),\n },\n);\n```\n\n## `useMoralisSubscription()`\n\n### Listen for query events\n\nThis hook is used when you use `useMoralisQuery` with `live: true`. But if you want fine-grained control over subscriptions, and want to do actions upon the events, then you can use this hook.\n\nIt's as simple as calling this hook with the callbacks that you want. The first 3 arguments are the same as `useMoralisQuery` (queryName, filter, dependencies). In the last argument, you can specify the callbacks:\n\n| Eventname | callback |\n| ---------- | -------- |\n| `\"create\"` | onCreate |\n| `\"update\"` | onUpdate |\n| `\"enter\"` | onEnter |\n| `\"leave\"` | onLeave |\n| `\"delete\"` | onDelete |\n\nThey will all return the object as data.\n\nFor example if you want to notify when a new player was added:\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n});\n```\n\nThis hook will handle the subscribing and unsubscribing automatically. It will automatically subscribe/unsubscribe when the component mounts/unmounts. All you have to do is use this hook.\n\nYou can disable the subscription by providing: `enabled: false`\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n enabled: false,\n});\n```\n\n## `useMoralisFile()`\n\nGet the data, and saveFunction with the `useMoralisFile` hook\n\n```jsx\nconst {\n error,\n isUploading,\n moralisFile,\n saveFile,\n} = useMoralisFile();\n```\n\n### Save to Moralis\n\nAll you need to do is call the save function with a valid file:\n\n```jsx\nsaveFile(\"batman.jpeg\", file);\n```\n\nThen you can read the state from the provided variables `error`,\n`isUploading` and\n`moralisFile`,\n\n### Save to IPFS\n\n```jsx\nsaveFile(\"batman.jpeg\", file, { saveIPFS: true });\n```\n\nThen you can get the ipfs data via `moralisFile._ipfs` and `moralisFile._hash` or `moralisFile.ipfs()` and `moralisFile.hash()` \n\n### Other options\n\nAdditionally you can also provide metadata, tags or specify the fileType in the options like:\n\n*Example:*\n\n```jsx\nconst metadata = { createdById: \"some-user-id\" };\nconst tags = { groupId: \"some-group-id\" };\n\nsaveFile(\"batman.jpeg\", file, {\n type: \"image/jpeg\",\n metadata,\n tags,\n saveIPFS: true,\n});\n```\n\n## `useMoralisCloudFunction()`\n\nYou can use the `useMoralisCloudFunction` hook to run cloud functions easily. All you need to do is provide a name for the function, and it will automatically fetch the data for you.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\");\n```\n\nIf you have a function that requires parameters, then you can provide it as second argument:\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\", {\n limit,\n});\n```\n\n### Trigger manually\n\nIf you rather want to trigger the fetching manually, you can provide `autoFetch: false` as option. And call the `fetch` function manually.\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisCloudFunction(\n \"topScores\",\n {\n limit\n },\n { autoFetch: false }\n);\n\n\n \n
{userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n {userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n \n {JSON.stringify(data, null, 2)};\n```\n\n### Filter queries\n\nYou can filer the query via a second argument. You can mutate the query in any way that Moralis.Query can.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisQuery(\"GameScore\", query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n);\n```\n\nThis example will fetch the top 3 scores that are at least 100, in descending order.\n\nYou can also filter dynamically, but you need to provide a dependency array as third argument (similar to other hooks), to specify when this hook needs to update.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n);\n```\n\n### Automatic updates with dependencies\n\nThis query will automatically refetch when the limit is changed.\n\nIf you want to disable the automatic fetching, you can also manually fetch. You need to provide `autoFetch: false` as option in the 4th argument. In that case it will ignore the dependencies and will only fetch if you manually call `fetch()`\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [],\n { autoFetch: false },\n);\n\nreturn ;\n```\n\n### Realtime / live queries\n\nThe `useMoralisQuery` hook can also be used to update upon realtime events. All you need to do is provide `live: true`. If any events update the query, then the `data` is automatically updated.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n },\n);\n```\n\nBy default we use these rules\n\n| Eventname | Action |\n| ---------- | ----------------------------------- |\n| `\"create\"` | Add to the data |\n| `\"update\"` | Update if object is already in data |\n| `\"enter\"` | Add to the data |\n| `\"leave\"` | Remove to the data |\n| `\"delete\"` | Remove to the data |\n\nYou can override these rules with your own functions.\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n onLiveEnter: (entity, all) => [...all, entity],\n onLiveCreate: (entity, all) => [...all, entity],\n onLiveDelete: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveLeave: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveUpdate: (entity, all) =>\n all.map(e => (e.id === entity.id ? entity : e)),\n },\n);\n```\n\n## `useMoralisSubscription()`\n\n### Listen for query events\n\nThis hook is used when you use `useMoralisQuery` with `live: true`. But if you want fine-grained control over subscriptions, and want to do actions upon the events, then you can use this hook.\n\nIt's as simple as calling this hook with the callbacks that you want. The first 3 arguments are the same as `useMoralisQuery` (queryName, filter, dependencies). In the last argument, you can specify the callbacks:\n\n| Eventname | callback |\n| ---------- | -------- |\n| `\"create\"` | onCreate |\n| `\"update\"` | onUpdate |\n| `\"enter\"` | onEnter |\n| `\"leave\"` | onLeave |\n| `\"delete\"` | onDelete |\n\nThey will all return the object as data.\n\nFor example if you want to notify when a new player was added:\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n});\n```\n\nThis hook will handle the subscribing and unsubscribing automatically. It will automatically subscribe/unsubscribe when the component mounts/unmounts. All you have to do is use this hook.\n\nYou can disable the subscription by providing: `enabled: false`\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n enabled: false,\n});\n```\n\n## `useMoralisFile()`\n\nGet the data, and saveFunction with the `useMoralisFile` hook\n\n```jsx\nconst {\n error,\n isUploading,\n moralisFile,\n saveFile,\n} = useMoralisFile();\n```\n\n### Save to Moralis\n\nAll you need to do is call the save function with a valid file:\n\n```jsx\nsaveFile(\"batman.jpeg\", file);\n```\n\nThen you can read the state from the provided variables `error`,\n`isUploading` and\n`moralisFile`,\n\n### Save to IPFS\n\n```jsx\nsaveFile(\"batman.jpeg\", file, { saveIPFS: true });\n```\n\nThen you can get the ipfs data via `moralisFile._ipfs` and `moralisFile._hash` or `moralisFile.ipfs()` and `moralisFile.hash()` \n\n### Other options\n\nAdditionally you can also provide metadata, tags or specify the fileType in the options like:\n\n*Example:*\n\n```jsx\nconst metadata = { createdById: \"some-user-id\" };\nconst tags = { groupId: \"some-group-id\" };\n\nsaveFile(\"batman.jpeg\", file, {\n type: \"image/jpeg\",\n metadata,\n tags,\n saveIPFS: true,\n});\n```\n\n## `useMoralisCloudFunction()`\n\nYou can use the `useMoralisCloudFunction` hook to run cloud functions easily. All you need to do is provide a name for the function, and it will automatically fetch the data for you.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\");\n```\n\nIf you have a function that requires parameters, then you can provide it as second argument:\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\", {\n limit,\n});\n```\n\n### Trigger manually\n\nIf you rather want to trigger the fetching manually, you can provide `autoFetch: false` as option. And call the `fetch` function manually.\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisCloudFunction(\n \"topScores\",\n {\n limit\n },\n { autoFetch: false }\n);\n\n\n \n
{userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n {userError.message}
}\n \n\n {JSON.stringify(user)}\n \n\n \n {JSON.stringify(data, null, 2)};\n```\n\n### Filter queries\n\nYou can filer the query via a second argument. You can mutate the query in any way that Moralis.Query can.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisQuery(\"GameScore\", query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n);\n```\n\nThis example will fetch the top 3 scores that are at least 100, in descending order.\n\nYou can also filter dynamically, but you need to provide a dependency array as third argument (similar to other hooks), to specify when this hook needs to update.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n);\n```\n\n### Automatic updates with dependencies\n\nThis query will automatically refetch when the limit is changed.\n\nIf you want to disable the automatic fetching, you can also manually fetch. You need to provide `autoFetch: false` as option in the 4th argument. In that case it will ignore the dependencies and will only fetch if you manually call `fetch()`\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [],\n { autoFetch: false },\n);\n\nreturn ;\n```\n\n### Realtime / live queries\n\nThe `useMoralisQuery` hook can also be used to update upon realtime events. All you need to do is provide `live: true`. If any events update the query, then the `data` is automatically updated.\n\n*Example:*\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n },\n);\n```\n\nBy default we use these rules\n\n| Eventname | Action |\n| ---------- | ----------------------------------- |\n| `\"create\"` | Add to the data |\n| `\"update\"` | Update if object is already in data |\n| `\"enter\"` | Add to the data |\n| `\"leave\"` | Remove to the data |\n| `\"delete\"` | Remove to the data |\n\nYou can override these rules with your own functions.\n\n```jsx\nconst [limit, setLimit] = useState(3);\nconst { data, error, isLoading } = useMoralisQuery(\n \"GameScore\",\n query =>\n query\n .greaterThanOrEqualTo(\"score\", 100)\n .descending(\"score\")\n .limit(limit),\n [limit],\n {\n live: true,\n onLiveEnter: (entity, all) => [...all, entity],\n onLiveCreate: (entity, all) => [...all, entity],\n onLiveDelete: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveLeave: (entity, all) => all.filter(e => e.id !== entity.id),\n onLiveUpdate: (entity, all) =>\n all.map(e => (e.id === entity.id ? entity : e)),\n },\n);\n```\n\n## `useMoralisSubscription()`\n\n### Listen for query events\n\nThis hook is used when you use `useMoralisQuery` with `live: true`. But if you want fine-grained control over subscriptions, and want to do actions upon the events, then you can use this hook.\n\nIt's as simple as calling this hook with the callbacks that you want. The first 3 arguments are the same as `useMoralisQuery` (queryName, filter, dependencies). In the last argument, you can specify the callbacks:\n\n| Eventname | callback |\n| ---------- | -------- |\n| `\"create\"` | onCreate |\n| `\"update\"` | onUpdate |\n| `\"enter\"` | onEnter |\n| `\"leave\"` | onLeave |\n| `\"delete\"` | onDelete |\n\nThey will all return the object as data.\n\nFor example if you want to notify when a new player was added:\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n});\n```\n\nThis hook will handle the subscribing and unsubscribing automatically. It will automatically subscribe/unsubscribe when the component mounts/unmounts. All you have to do is use this hook.\n\nYou can disable the subscription by providing: `enabled: false`\n\n*Example:*\n\n```jsx\nuseMoralisSubscription(\"GameScore\", q => q, [], {\n onCreate: data => alert(`${data.attributes.playerName} was just created`),\n enabled: false,\n});\n```\n\n## `useMoralisFile()`\n\nGet the data, and saveFunction with the `useMoralisFile` hook\n\n```jsx\nconst {\n error,\n isUploading,\n moralisFile,\n saveFile,\n} = useMoralisFile();\n```\n\n### Save to Moralis\n\nAll you need to do is call the save function with a valid file:\n\n```jsx\nsaveFile(\"batman.jpeg\", file);\n```\n\nThen you can read the state from the provided variables `error`,\n`isUploading` and\n`moralisFile`,\n\n### Save to IPFS\n\n```jsx\nsaveFile(\"batman.jpeg\", file, { saveIPFS: true });\n```\n\nThen you can get the ipfs data via `moralisFile._ipfs` and `moralisFile._hash` or `moralisFile.ipfs()` and `moralisFile.hash()` \n\n### Other options\n\nAdditionally you can also provide metadata, tags or specify the fileType in the options like:\n\n*Example:*\n\n```jsx\nconst metadata = { createdById: \"some-user-id\" };\nconst tags = { groupId: \"some-group-id\" };\n\nsaveFile(\"batman.jpeg\", file, {\n type: \"image/jpeg\",\n metadata,\n tags,\n saveIPFS: true,\n});\n```\n\n## `useMoralisCloudFunction()`\n\nYou can use the `useMoralisCloudFunction` hook to run cloud functions easily. All you need to do is provide a name for the function, and it will automatically fetch the data for you.\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\");\n```\n\nIf you have a function that requires parameters, then you can provide it as second argument:\n\n*Example:*\n\n```jsx\nconst { data, error, isLoading } = useMoralisCloudFunction(\"topScores\", {\n limit,\n});\n```\n\n### Trigger manually\n\nIf you rather want to trigger the fetching manually, you can provide `autoFetch: false` as option. And call the `fetch` function manually.\n\n*Example:*\n\n```jsx\nconst { fetch, data, error, isLoading } = useMoralisCloudFunction(\n \"topScores\",\n {\n limit\n },\n { autoFetch: false }\n);\n\n