You are browsing Nuxt 2 docs. Go to Nuxt 3 docs, or learn more about Nuxt 2 Long Term Support.

Translated page Contents of this page might be outdated.

Propriedade de Observação de Consulta

Observa as sequências de caracteres da consulta e executa os métodos do componente em caso de alteração (asyncData, fetch, validate, layout, ...).


  • Tipo: Boolean ou Array ou Function (predefinida como: [])

Usamos a chave watchQuery para definir um observador para as sequências de caracteres da consulta. Se as sequências de caracteres definidas mudarem, todos os métodos do componente (async, fetch(context), validate, layout, ...) serão chamados. A observação está desativada por predefinição para melhorar o desempenho.

Se quisermos definir um observador para todas as sequências de caracteres da consulta, definimos watchQuery: true:

export default {
  watchQuery: ['page']
}

Também podemos usar a função watchQuery(newQuery, oldQuery) para termos observadores mais refinados:

export default {
  watchQuery(newQuery, oldQuery) {
    // Só executa os métodos do componente se a sequência de
    // caracteres de consulta antiga contiver `bar`
    // e a nova sequência de caracteres de consulta contiver `foo`.
    return newQuery.foo && oldQuery.bar
  }
}
Aviso: A nova função gatilho fetch introduzida na versão 2.12 não é afetada pela watchQuery. Para mais informações consultar ouvir as alterações de sequência de caracteres de consulta .