Referência
Devtools
Quando algo mostra o texto errado, você quer uma só resposta: que key é essa e de onde veio? O overlay verbaly/devtools responde isso no navegador.
Conecte o inspetor
Importe só em desenvolvimento: é um chunk separado, tree-shaken fora dos builds de produção.
if (import.meta.env.DEV) {
const { attachDevtools } = await import('verbaly/devtools');
attachDevtools(verbaly);
}- Um painel mostra quantas keys estão ok, em fallback ou faltando, e nomeia o arquivo de catálogo para corrigir cada uma.
- Mantenha Alt e passe por cima de qualquer elemento para ver a sua chave, o idioma de onde saiu e o texto de origem. O painel escreve a tecla que está ouvindo, por isso nunca é preciso adivinhá-la.
O que você pode mudar
Os valores padrão servem para uma app normal, e todos aceitam um argumento quando a sua não é.
| Opção | Padrão | O que faz |
|---|---|---|
hotkey | 'alt' | A tecla que você mantém para inspecionar: 'alt', 'ctrl', 'shift' ou 'meta'. Mude-a quando o Alt já for de outra coisa na sua página |
root | document.body | A parte da página que observa, para uma app montada dentro de outra maior |
attribute | 'data-verbaly' | O atributo que lê, se você renomeou o que o seu markup usa |
catalogDir | 'locales' | A pasta que nomeia quando te diz onde acrescentar uma mensagem em falta |
O hook onResolve
Prefere seu próprio logging? onResolve dispara em cada t() com a key, o locale, o valor e se foi hit, fallback ou miss.
createVerbaly({
onResolve: (info) => {
if (info.status === 'miss') console.warn('missing', info.key);
},
});Para uma consulta pontual, verbaly.inspect(key) devolve o locale resolvido e o texto fonte.