123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161 |
- .TH "NPM\-LS" "1" "August 2021" "" ""
- .SH "NAME"
- \fBnpm-ls\fR \- List installed packages
- .SS Synopsis
- .P
- .RS 2
- .nf
- npm ls [[<@scope>/]<pkg> \.\.\.]
- aliases: list, la, ll
- .fi
- .RE
- .SS Description
- .P
- This command will print to stdout all the versions of packages that are
- installed, as well as their dependencies, in a tree\-structure\.
- .P
- Positional arguments are \fBname@version\-range\fP identifiers, which will
- limit the results to only the paths to the packages named\. Note that
- nested packages will \fIalso\fR show the paths to the specified packages\.
- For example, running \fBnpm ls promzard\fP in npm's source tree will show:
- .P
- .RS 2
- .nf
- npm@6\.14\.15 /path/to/npm
- └─┬ init\-package\-json@0\.0\.4
- └── promzard@0\.1\.5
- .fi
- .RE
- .P
- It will print out extraneous, missing, and invalid packages\.
- .P
- If a project specifies git urls for dependencies these are shown
- in parentheses after the name@version to make it easier for users to
- recognize potential forks of a project\.
- .P
- The tree shown is the logical dependency tree, based on package
- dependencies, not the physical layout of your node_modules folder\.
- .P
- When run as \fBll\fP or \fBla\fP, it shows extended information by default\.
- .SS Configuration
- .SS json
- .RS 0
- .IP \(bu 2
- Default: false
- .IP \(bu 2
- Type: Boolean
- .RE
- .P
- Show information in JSON format\.
- .SS long
- .RS 0
- .IP \(bu 2
- Default: false
- .IP \(bu 2
- Type: Boolean
- .RE
- .P
- Show extended information\.
- .SS parseable
- .RS 0
- .IP \(bu 2
- Default: false
- .IP \(bu 2
- Type: Boolean
- .RE
- .P
- Show parseable output instead of tree view\.
- .SS global
- .RS 0
- .IP \(bu 2
- Default: false
- .IP \(bu 2
- Type: Boolean
- .RE
- .P
- List packages in the global install prefix instead of in the current
- project\.
- .SS depth
- .RS 0
- .IP \(bu 2
- Type: Int
- .RE
- .P
- Max display depth of the dependency tree\.
- .SS prod / production
- .RS 0
- .IP \(bu 2
- Type: Boolean
- .IP \(bu 2
- Default: false
- .RE
- .P
- Display only the dependency tree for packages in \fBdependencies\fP\|\.
- .SS dev / development
- .RS 0
- .IP \(bu 2
- Type: Boolean
- .IP \(bu 2
- Default: false
- .RE
- .P
- Display only the dependency tree for packages in \fBdevDependencies\fP\|\.
- .SS only
- .RS 0
- .IP \(bu 2
- Type: String
- .RE
- .P
- When "dev" or "development", is an alias to \fBdev\fP\|\.
- .P
- When "prod" or "production", is an alias to \fBproduction\fP\|\.
- .SS link
- .RS 0
- .IP \(bu 2
- Type: Boolean
- .IP \(bu 2
- Default: false
- .RE
- .P
- Display only dependencies which are linked
- .SS unicode
- .RS 0
- .IP \(bu 2
- Type: Boolean
- .IP \(bu 2
- Default: true
- .RE
- .P
- Whether to represent the tree structure using unicode characters\.
- Set it to false in order to use all\-ansi output\.
- .SS See Also
- .RS 0
- .IP \(bu 2
- npm help config
- .IP \(bu 2
- npm help npmrc
- .IP \(bu 2
- npm help folders
- .IP \(bu 2
- npm help install
- .IP \(bu 2
- npm help link
- .IP \(bu 2
- npm help prune
- .IP \(bu 2
- npm help outdated
- .IP \(bu 2
- npm help update
- .RE
|