vuex/docs/ptbr/guide/getters.md

Getters

Tente esta lição no Scrimba

Às vezes, talvez precisemos calcular o estado derivado com base no estado do store, por exemplo, filtrar através de uma lista de itens e contá-los:

computed: {
  doneTodosCount () {
    return this.$store.state.todos.filter(todo => todo.done).length
  }
}

Se mais do que um componente precisa fazer uso disso, temos que duplicar a função, ou extraí-lo em um auxiliar compartilhado e importá-lo em vários lugares - ambos são menos do que o ideal.

O Vuex nos permite definir getters no store. Você pode pensar neles como dados computados para os stores. Como os dados computados, o resultado de um getter é armazenado em cache com base em suas dependências e só será reavaliado quando algumas de suas dependências forem alteradas.

Os getters receberão o estado como 1º argumento:

const store = createStore({
  state: {
    todos: [
      { id: 1, text: '...', done: true },
      { id: 2, text: '...', done: false }
    ]
  },
  getters: {
    doneTodos (state) {
      return state.todos.filter(todo => todo.done)
    }
  }
})

Acesso Estilo-Propriedade

Os getters serão expostos no objeto store.getters e você acessa valores como propriedades:

store.getters.doneTodos // -> [{ id: 1, text: '...', done: true }]

Os getters também recebem outros getters como o 2º argumento:

getters: {
  // ...
  doneTodosCount (state, getters) {
    return getters.doneTodos.length
  }
}

store.getters.doneTodosCount // -> 1

Agora podemos usar facilmente isso dentro de qualquer componente:

computed: {
  doneTodosCount () {
    return this.$store.getters.doneTodosCount
  }
}

Observe que os getters acessados ​​como propriedades são armazenados em cache como parte do sistema de reatividade do Vue.

Acesso Estilo-Método

Você também pode passar argumentos para os getters retornando uma função. Isso é particularmente útil quando você deseja consultar um Array no store:

getters: {
  // ...
  getTodoById: (state) => (id) => {
    return state.todos.find(todo => todo.id === id)
  }
}

store.getters.getTodoById(2) // -> { id: 2, text: '...', done: false }

Observe que os getters acessados ​​via métodos serão executados toda vez que você os chamar, e o resultado não será armazenado em cache.

O Auxiliar mapGetters

O auxiliar mapGetters simplesmente mapeia os getters do store para os dados computados locais:

import { mapGetters } from 'vuex'

export default {
  // ...
  computed: {
    // mistura os getters nos dados computatos com o operador spread
    ...mapGetters([
      'doneTodosCount',
      'anotherGetter',
      // ...
    ])
  }
}

Se você deseja mapear um getter com um nome diferente, use um objeto:

...mapGetters({
  // mapeia `this.doneCount` para `this.$store.getters.doneTodosCount`
  doneCount: 'doneTodosCount'
})