Repolode
Enviar
syntax-tree

syntax-tree/unist-util-visit

Utilitário unist para percorrer e visitar nós em árvores sintáticas, como ASTs de Markdown, com filtro de teste e visitantes de entrada e saída.

Ver no GitHubSite
Estrelas
359
Forks
23
Issues abertas
0
Último commit
há 14 dias

O que é?

unist-util-visit percorre uma árvore sintática baseada em unist, como as árvores MDAST produzidas por mdast-util-from-markdown, e chama uma função visitante para cada nó. Você pode passar um teste para limitar as visitas aos nós correspondentes, usando o mesmo formato de teste de unist-util-is, como uma string com o tipo do nó.

Os visitantes recebem o nó, seu índice no nó pai e o próprio nó pai. Cada visitante pode retornar CONTINUE, EXIT para interromper a travessia ou SKIP para ignorar os filhos de um nó. Também é possível executar um visitante de saída separado depois que os filhos do nó forem processados. O pacote é exclusivamente ESM, tem como alvo Node.js 16+ e também pode ser usado no Deno e em navegadores via esm.sh.

Se você precisa da cadeia completa de ancestrais de cada nó, o pacote irmão unist-util-visit-parents oferece esse recurso. Este pacote funciona da mesma forma, mas expõe o nó pai e o índice.

Recursos principais

  • 01Visita todos os nós de uma árvore unist, com a opção de filtrá-los por um teste, como o tipo do nó.
  • 02Os visitantes recebem o nó, seu índice e o nó pai.
  • 03Retorne CONTINUE, EXIT ou SKIP para controlar a travessia.
  • 04Oferece suporte a visitantes separados de entrada e saída.
  • 05Funciona no Node.js, no Deno e em navegadores via esm.sh.

Casos de uso

  • Encontrar e transformar nós específicos de Markdown, como todos os nós de texto ou de código, em um plugin de remark ou unified.
  • Coletar informações de uma árvore sintática durante uma etapa de build.
  • Criar linters ou transformadores personalizados com base em parsers compatíveis com unist.

Início rápido

  1. 1

    Instale o pacote com npm (Node.js 16 ou superior).

    npm install unist-util-visit
  2. 2

    Importe visit e percorra uma árvore sintática, como uma gerada por fromMarkdown.

Antes de usar

  • Este pacote é exclusivo para ESM, portanto não pode ser carregado com require() em projetos CommonJS.
  • É um utilitário de baixo nível para percorrer árvores unist e precisa de um parser, como mdast-util-from-markdown, para gerar a entrada.

Em coleções

Geradores de sites estáticos e ferramentas de documentação

Tópicos

#syntax-tree#unist#ast#markdown#tree-traversal#unified#unist-util#util#visit#walk

Perguntas frequentes

O que é unist-util-visit?
Utilitário unist para percorrer e visitar nós em árvores sintáticas, como ASTs de Markdown, com filtro de teste e visitantes de entrada e saída. unist-util-visit percorre uma árvore sintática baseada em unist, como as árvores MDAST produzidas por mdast-util-from-markdown, e chama uma função visitante para cada nó. Você pode passar um teste para limitar as visitas aos nós correspondentes, usando o mesmo formato de teste de unist-util-is, como uma string com o tipo do nó.
unist-util-visit é gratuito? Qual é a licença?
unist-util-visit é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
unist-util-visit ainda é mantido?
Manutenção ativa. O último commit de unist-util-visit foi em 24 de out. de 2026.
Para que posso usar unist-util-visit?
Encontrar e transformar nós específicos de Markdown, como todos os nós de texto ou de código, em um plugin de remark ou unified. Coletar informações de uma árvore sintática durante uma etapa de build. Criar linters ou transformadores personalizados com base em parsers compatíveis com unist.
Como instalar unist-util-visit?
Instale o pacote com npm (Node.js 16 ou superior).: npm install unist-util-visit Importe visit e percorra uma árvore sintática, como uma gerada por fromMarkdown.
Onde consigo unist-util-visit?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/syntax-tree/unist-util-visit

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados