¿Qué hace Pinia?
Pinia es la biblioteca oficial de gestión de estado para Vue, diseñada para ser intuitiva y segura en tipos. Soporta tanto la API de Options como la de Composition, con soporte de primera clase para TypeScript e integración con las herramientas de desarrollo.
La habilidad está basada en Pinia v3.0.4, generada el 2026-01-28.
Referencias Principales
| Tema | Descripción | Referencia |
|---|
| Stores | Definición de stores, estado, getters, acciones, storeToRefs, suscripciones | core-stores |
Características
Extensibilidad
| Tema | Descripción | Referencia |
|---|
| Plugins | Extender stores con propiedades personalizadas, estado y comportamiento | features-plugins |
Componibilidad
Mejores Prácticas
Avanzado
| Tema | Descripción | Referencia |
|---|
| SSR | Renderizado del lado del servidor, hidratación de estado | advanced-ssr |
| Nuxt | Integración con Nuxt, auto-importaciones, mejores prácticas SSR | advanced-nuxt |
| HMR | Reemplazo de módulos en caliente para desarrollo | advanced-hmr |
Recomendaciones Clave
- Preferir Setup Stores para lógica compleja, composables y watchers
- Usa
storeToRefs() al desestructurar estado/getters para preservar la reactividad
- Las acciones se pueden desestructurar directamente - están enlazadas al store
- Llama a los stores dentro de funciones, no en el ámbito del módulo, especialmente para SSR
- Añade soporte HMR a cada store para una mejor experiencia de desarrollo
- Usa
@pinia/testing para pruebas de componentes con stores simulados