unist-find-node

Find the nearest MDAST node matching the position (inline nodes excluded).

Install

npm:

npm i --save unist-find-node

Usage

See the following example as Example.md:

# hello, This is Markdown 
... any other texts

let vfile = require("to-vfile");
let unified = require("unified");
let parse = require("remark-parse");
let findNode = require("./index.js");


let assert = require("assert");

let tree = unified()
  .use(parse)
  .parse("Example.md");
let child = findNode(tree, { line: 1, column: 1 });

Then the child is the first heading node which would be intercepted as

let inspect = require("unist-util-inspect");
console.log(inspect(child));
// heading[1] (1:1-1:27, 0-26) [depth=1]
//   -- text: "hello, This is Markdown" (1:3-1:26, 2-25)

API

  child = findNode(node, position, customizeRules = [] )

• node: the AST node parsed by unist
• position: {line, column} an object with line and column property
• customizeRules: An array of Functions customizing your rules for looking for nodes;
  It is an function of (node, parent) => true|fasle|null|undefined], taking node and its parent and return one of the four. Rules are executed sequetially in the array, and
  1. If a function returns true, then findNode return node;
  2. If a function returns flase, then findNode return parent
  3. If a function returns null, then findNode will stop executing following rules and try to find result in the node.children; If no result exists in node.children (when and only when position ranges of node.children does not cover positopn), then return node.
  4. If a function returns undefined, then findNode will continue following rules; If all rules return undefined, the node will continue to search at node.children; If no result exists in node.children, return node