vuex/docs/en/api.md

API Reference

Vuex.Store

import Vuex from 'vuex'

const store = new Vuex.Store({ ...options })

Vuex.Store Constructor Options

• state

  • type: Object

  The root state object for the Vuex store.

  Details

• mutations

  • type: Object | Array<Object>

  An object where each entry's key is the mutation name and the value is a mutation handler function. The handler function always receives state as the first argument, and receives all arguments passed to the dispatch call following that.

  If passing in an Array of Objects, these objects will be automatically merged together into one final object.

  Details

• actions

  • type: Object | Array<Object>

  An object where each entry's key is the action name and the value is either

  1. A mutation name string; or
  2. A function which will receive the store as the first argument, followed by additional payload arguments.

  Vuex will process these entries and create the actual callable action functions and expose them on the actions property of the store.

  If passing in an Array of Objects, these objects will be automatically merged together into one final object.

  Details

• getters

  • type: Object | Array<Object>

  An object where each entry's key is the getter name and the value of a function which will receive the state as the first argument.

  Vuex will process these entries and create the actual callable getter functions and expose them on the getters property of the store.

  If passing in an Array of Objects, these objects will be automatically merged together into one final object.

  Details

• middlewares

  • type: Array<Object>

  An array of middleware objects that are in the shape of:

  {
    snapshot: Boolean, // default: false
    onInit: Function,
    onMutation: Function
  }
  

  All fields are optional. Details

• strict

  • type: Boolean
  • default: false

  Force the Vuex store into strict mode. In strict mode any mutations to Vuex state outside of mutation handlers will throw an Error.

  Details

Vuex.Store Instance Properties

• state

  • type: Object

  The root state. Read only.

• actions

  • type: Object

  The callable action functions.

Vuex.Store Instance Methods

• dispatch(mutationName: String, ...args)

Directly dispatch a mutation. This is useful in certain situations are in general you should prefer using actions in application code.

• hotUpdate(newOptions: Object)

Hot swap new actions and mutations. Details