Uname : Linux serv1.rebootns.com 5.14.0-570.62.1.el9_6.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Nov 11 10:10:59 EST 2025 x86_64
Soft : LiteSpeed
Ip : 139.99.125.122
Port : 443
~
/
opt
/
alt
/
alt-nodejs22
/
root
/
usr
/
lib
/
node_modules
/
npm
/
node_modules
/
libnpmfund
[ HOME ]
Exec
Submit
README.md
# libnpmfund [](https://npm.im/libnpmfund) [](https://npm.im/libnpmfund) [](https://github.com/npm/cli/actions/workflows/ci-libnpmfund.yml) [`libnpmfund`](https://github.com/npm/libnpmfund) is a Node.js library for retrieving **funding** information for packages installed using [`arborist`](https://github.com/npm/arborist). ## Table of Contents * [Example](#example) * [Install](#install) * [Contributing](#contributing) * [API](#api) * [LICENSE](#license) ## Example ```js const { read } = require('libnpmfund') const fundingInfo = await read() console.log( JSON.stringify(fundingInfo, null, 2) ) // => { length: 2, name: 'foo', version: '1.0.0', funding: { url: 'https://example.com' }, dependencies: { bar: { version: '1.0.0', funding: { url: 'http://collective.example.com' } } } } ``` ## Install `$ npm install libnpmfund` ### Contributing The npm team enthusiastically welcomes contributions and project participation! There's a bunch of things you can do if you want to contribute! The [Contributor Guide](https://github.com/npm/cli/blob/latest/CONTRIBUTING.md) outlines the process for community interaction and contribution. Please don't hesitate to jump in if you'd like to, or even ask us questions if something isn't clear. All participants and maintainers in this project are expected to follow the [npm Code of Conduct](https://www.npmjs.com/policies/conduct), and just generally be excellent to each other. Please refer to the [Changelog](CHANGELOG.md) for project history details, too. Happy hacking! ### API ##### <a name="fund.read"></a> `> fund.read([opts]) -> Promise<Object>` Reads **funding** info from a npm install and returns a promise for a tree object that only contains packages in which funding info is defined. Options: - `countOnly`: Uses the tree-traversal logic from **npm fund** but skips over any obj definition and just returns an obj containing `{ length }` - useful for things such as printing a `6 packages are looking for funding` msg. - `workspaces`: `Array<String>` List of workspaces names to filter for, the result will only include a subset of the resulting tree that includes only the nodes that are children of the listed workspaces names. - `path`, `registry` and more [Arborist](https://github.com/npm/arborist/) options. ##### <a name="fund.readTree"></a> `> fund.readTree(tree, [opts]) -> Promise<Object>` Reads **funding** info from a given install tree and returns a tree object that only contains packages in which funding info is defined. - `tree`: An [`arborist`](https://github.com/npm/arborist) tree to be used, e.g: ```js const Arborist = require('@npmcli/arborist') const { readTree } = require('libnpmfund') const arb = new Arborist({ path: process.cwd() }) const tree = await arb.loadActual() return readTree(tree, { countOnly: false }) ``` Options: - `countOnly`: Uses the tree-traversal logic from **npm fund** but skips over any obj definition and just returns an obj containing `{ length }` - useful for things such as printing a `6 packages are looking for funding` msg. ##### <a name="fund.normalizeFunding"></a> `> fund.normalizeFunding(funding) -> Object` From a `funding` `<object|string|array>`, retrieves normalized funding objects containing a `url` property. e.g: ```js normalizeFunding('http://example.com') // => { url: 'http://example.com' } ``` ##### <a name="fund.isValidFunding"></a> `> fund.isValidFunding(funding) -> Boolean` Returns `<true>` if `funding` is a valid funding object, e.g: ```js isValidFunding({ foo: 'not a valid funding obj' }) // => false isValidFunding('http://example.com') // => true ``` ## LICENSE [ISC](./LICENSE)
Submit
Back
Folder Name
Submit
File Name
File Content
Submit
Name
Type
Size
Permission
Last Modified
Actions
.
dir
-
0755
2025-11-16 11:16:21
..
dir
-
0755
2025-11-16 11:16:21
lib
dir
-
0755
2025-11-16 11:16:21
LICENSE
file
738 B
0644
2025-08-28 12:23:57
README.md
file
3.81 KB
0644
2025-08-28 12:23:57
package.json
file
1.4 KB
0644
2025-08-28 12:23:57