sindresorhus / npm-keyword

Get a list of npm packages with keywords
MIT License
52 stars 8 forks source link

npm-keyword

Get a list of npm packages with keywords

Install

npm install npm-keyword

Usage

import {npmKeyword, npmKeywordNames, npmKeywordCount} from 'npm-keyword';

console.log(await npmKeyword('gulpplugin'));
//=> [{name: 'gulp-autoprefixer', description: '…'}, …]

console.log(await npmKeywordNames('gulpplugin'));
//=> ['gulp-autoprefixer', …]

console.log(await npmKeywordCount('gulpplugin'));
//=> 3457

Caveat

The list of packages will contain a maximum of 250 packages matching the keywords. This limitation is caused by the npm registry API.

API

npmKeyword(keywords, options?)

Returns a promise for a list of packages having the specified keyword in their package.json keywords property.

keywords

Type: string | string[]\ Example: ['string', 'camelcase']

One or more keywords. Only matches packages that have all the given keywords.

options

Type: object

size

Type: number\ Default: 250

Limits the amount of results.

npmKeywordNames(keywords, options?)

Returns a promise for a list of package names.

keywords

Type: string | string[]\ Example: ['string', 'camelcase']

One or more keywords. Only matches packages that have all the given keywords.

options

Type: object

size

Type: number\ Default: 250

Limits the amount of results.

npmKeywordCount(keywords)

Returns a promise for the count of packages.

keywords

Type: string | string[]\ Example: ['string', 'camelcase']

One or more keywords. Only matches packages that have all the given keywords.

Related