Nuxt/docs/content/3.api/1.composables/use-state.md
Daniel Roe d77b62d63e
docs: warn that useState should only contain JSON-serializable content (#5994)
Co-authored-by: pooya parsa <pyapar@gmail.com>
Co-authored-by: Damian Głowala <48835293+DamianGlowala@users.noreply.github.com>
Co-authored-by: Alwin Lohrie <46248939+niwla23@users.noreply.github.com>
2022-07-21 10:56:01 +02:00

18 lines
801 B
Markdown

# `useState`
```ts
useState<T>(init?: () => T | Ref<T>): Ref<T>
useState<T>(key: string, init?: () => T | Ref<T>): Ref<T>
```
* **key**: A unique key ensuring that data fetching is properly de-duplicated across requests. If you do not provide a key, then a key that is unique to the file and line number of the instance of `useState` will be generated for you.
* **init**: A function that provides initial value for the state when not initiated. This function can also return a `Ref`.
* **T**: (typescript only) Specify the type of state
::alert{type=warning}
Because the data inside `useState` will be serialized to JSON, it is important that it does not contain anything that cannot be serialized, such as classes, functions or symbols.
::
::ReadMore{link="/guide/features/state-management"}
::