Repolode
Enviar
syntax-tree

syntax-tree/unist-util-visit

Utilidad de unist para recorrer y visitar nodos en árboles de sintaxis, como AST de Markdown, con filtro de prueba y visitantes de entrada y salida.

Ver en GitHubSitio web
Estrellas
359
Forks
23
Issues abiertos
0
Último commit
hace 13 días

¿Qué es?

unist-util-visit recorre un árbol de sintaxis basado en unist, como los árboles MDAST que genera mdast-util-from-markdown, y llama a una función visitante para cada nodo. Puedes pasar una prueba para limitar las visitas a los nodos que coincidan, usando el mismo formato de prueba que unist-util-is, por ejemplo, una cadena con el tipo de nodo.

Los visitantes reciben el nodo, su índice en el nodo padre y el propio nodo padre. Cada visitante puede devolver CONTINUE, EXIT para detener el recorrido o SKIP para omitir los hijos de un nodo. También puede ejecutarse un visitante de salida independiente después de procesar los hijos de un nodo. El paquete solo está disponible como ESM, requiere Node.js 16 o posterior y también se puede usar desde Deno y navegadores mediante esm.sh.

Si necesitas la cadena completa de antecesores de cada nodo, el paquete hermano unist-util-visit-parents ofrece esa funcionalidad; este paquete funciona del mismo modo, pero expone el nodo padre y el índice.

Funciones clave

  • 01Visita todos los nodos de un árbol unist, con la opción de filtrarlos mediante una prueba, como el tipo de nodo.
  • 02Los visitantes reciben el nodo, su índice y su nodo padre.
  • 03Devuelve CONTINUE, EXIT o SKIP para controlar el recorrido.
  • 04Admite visitantes independientes de entrada y salida.
  • 05Funciona en Node.js, Deno y navegadores mediante esm.sh.

Casos de uso

  • Buscar y transformar nodos específicos de Markdown, como todos los nodos de texto o de código, en un plugin de remark o unified.
  • Recopilar información de un árbol de sintaxis durante un paso de compilación.
  • Crear linters o transformadores personalizados basados en parsers compatibles con unist.

Inicio rápido

  1. 1

    Instala el paquete con npm (Node.js 16 o superior).

    npm install unist-util-visit
  2. 2

    Importa visit y recorre un árbol de sintaxis, como uno generado por fromMarkdown.

Antes de usarlo

  • Este paquete solo admite ESM, por lo que no se puede cargar con require() en proyectos CommonJS.
  • Es una utilidad de bajo nivel para recorrer árboles unist y necesita un parser, como mdast-util-from-markdown, para generar la entrada.

En colecciones

Generadores de sitios estáticos y herramientas de documentación

Temas

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

Preguntas frecuentes

¿Qué es unist-util-visit?
Utilidad de unist para recorrer y visitar nodos en árboles de sintaxis, como AST de Markdown, con filtro de prueba y visitantes de entrada y salida. unist-util-visit recorre un árbol de sintaxis basado en unist, como los árboles MDAST que genera mdast-util-from-markdown, y llama a una función visitante para cada nodo. Puedes pasar una prueba para limitar las visitas a los nodos que coincidan, usando el mismo formato de prueba que unist-util-is, por ejemplo, una cadena con el tipo de nodo.
¿unist-util-visit es gratuito? ¿Qué licencia tiene?
unist-util-visit es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿unist-util-visit sigue mantenido?
Mantenimiento activo. El último commit de unist-util-visit fue el 24 oct 2026.
¿Para qué puedo usar unist-util-visit?
Buscar y transformar nodos específicos de Markdown, como todos los nodos de texto o de código, en un plugin de remark o unified. Recopilar información de un árbol de sintaxis durante un paso de compilación. Crear linters o transformadores personalizados basados en parsers compatibles con unist.
¿Cómo se instala unist-util-visit?
Instala el paquete con npm (Node.js 16 o superior).: npm install unist-util-visit Importa visit y recorre un árbol de sintaxis, como uno generado por fromMarkdown.
¿Dónde consigo unist-util-visit?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/syntax-tree/unist-util-visit

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados