useDuxtAnalytics()

#Assinatura

const analytics = useDuxtAnalytics();

analytics.track({ name: 'feedback', helpful: true });

#Devolve

{ track }. O track(event) carimba o contexto da documentação no evento e entrega-o a duxt.analytics.track, se o site tiver configurado um.

Não devolve nada e nunca lança: quem o chama não pode ter de se importar se a comunicação resultou, nem sequer se há alguém à escuta.

#Notas

O evento é um de uma união fechada — search, search-result, copy, api-request, feedback — e o track acrescenta o context: o caminho da documentação sem o seu prefixo de locale, query string ou fragmento, o locale, e a fonte e a versão onde o site tem mais do que uma.

Apenas no cliente. No servidor, o track devolve de imediato, por isso uma compilação e uma pré-renderização não comunicam nada — uma renderização estática não é um leitor.

Não há transporte nenhum por trás disto. Nem fila, nem memória intermédia, nem armazenamento, nem cookie, nem chamada de rede: a função do próprio site é a única coisa que sai da página, e é isso que mantém o fornecedor, a barreira de consentimento e a própria decisão de transmitir do lado de quem é dono deles. Um callback que lance ou rejeite é engolido.

Como ligar um, o contrato completo dos eventos e o que nunca é enviado de propósito: Enviar eventos de analítica.