Security News
vlt Debuts New JavaScript Package Manager and Serverless Registry at NodeConf EU
vlt introduced its new package manager and a serverless registry this week, innovating in a space where npm has stagnated.
unist-util-find
Advanced tools
unist utility to find a node.
This package is a utility that takes any unist (whether mdast, hast, etc) node and returns the first node that matches a given condition.
This utility is the simplest way to find a single node in a tree.
For much more powerful tree walking, see unist-util-visit
.
This package is ESM only. In Node.js (version 16+), install with npm:
npm install unist-util-find
In Deno with esm.sh
:
import {find} from 'https://esm.sh/unist-util-find@3'
In browsers with esm.sh
:
<script type="module">
import {find} from 'https://esm.sh/unist-util-find@3?bundle'
</script>
import {fromMarkdown} from 'mdast-util-from-markdown'
import {find} from 'unist-util-find'
const tree = fromMarkdown('Some _emphasis_, **strongness**, and `code`.')
// String condition:
console.log(find(tree, 'value'))
// Object condition:
console.log(find(tree, {value: 'emphasis'}))
// Function condition:
console.log(
find(tree, function (node) {
return node.type === 'inlineCode'
})
)
Yields:
// string condition: 'value'
{
type: 'text',
value: 'Some ',
position: {
start: { line: 1, column: 1, offset: 0 },
end: { line: 1, column: 6, offset: 5 }
}
}
// object condition: { value: 'emphasis' }
{
type: 'text',
value: 'emphasis',
position: {
start: { line: 1, column: 7, offset: 6 },
end: { line: 1, column: 15, offset: 14 }
}
}
// function condition: function (node) { return node.type === 'inlineCode' }
{
type: 'inlineCode',
value: 'code',
position: {
start: { line: 1, column: 38, offset: 37 },
end: { line: 1, column: 44, offset: 43 }
}
}
This package exports the identifier find
.
There is no default export.
find(tree, condition)
Find a node in tree
matching condition
.
tree
(Node
)
— tree to search incondition
(TestFn
, TestObj
, or
TestStr
)
— condition used to test each nodeThe first node (Node
) that matches condition, or undefined
if no
node matches
TestFn
Find the first node for which function returns true
when passed node as
argument (TypeScript type).
node
(Node
)
— node to checkWhether node
matches your condition (boolean
).
TestObj
Find the first node that has matching values for all properties of object (TypeScript type).
type TestObj = Record<string, unknown>;
TestStr
Find the first node with a truthy property matching string
(TypeScript type).
type TestStr = string;
This package is fully typed with TypeScript.
It exports the additional types TestFn
,
TestObj
, and TestStr
.
Projects maintained by the unified collective are compatible with maintained versions of Node.js.
When we cut a new major release, we drop support for unmaintained versions of
Node.
This means we try to keep the current release line, unist-util-find@^3
,
compatible with Node.js 16.
This project is safe.
unist-util-visit
— visit nodesSee contributing.md
in syntax-tree/.github
for ways to get
started.
See support.md
for ways to get help.
This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.
FAQs
unist utility to find a node
The npm package unist-util-find receives a total of 73,821 weekly downloads. As such, unist-util-find popularity was classified as popular.
We found that unist-util-find demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
vlt introduced its new package manager and a serverless registry this week, innovating in a space where npm has stagnated.
Security News
Research
The Socket Research Team uncovered a malicious Python package typosquatting the popular 'fabric' SSH library, silently exfiltrating AWS credentials from unsuspecting developers.
Security News
At its inaugural meeting, the JSR Working Group outlined plans for an open governance model and a roadmap to enhance JavaScript package management.