Zoltan Kochan
07839df5c3
* docs: move website documentation into the pnpm repository * docs: keep v11 and v12 documentation beside their implementations * docs(pnpr): keep registry documentation beside its implementation * ci: classify product documentation as documentation changes * test: cover product documentation in Rust CI exclusions * ci: isolate documentation publishing and support manual sync * test: make dependency status fixture timestamps deterministic
84 lines
2.0 KiB
Markdown
84 lines
2.0 KiB
Markdown
---
|
|
id: list
|
|
title: pnpm list
|
|
---
|
|
|
|
Aliases: `ls`
|
|
|
|
This command will output all the versions of packages that are installed, as
|
|
well as their dependencies, in a tree-structure.
|
|
|
|
Positional arguments are `name-pattern@version-range` identifiers, which will
|
|
limit the results to only the packages named. For example,
|
|
`pnpm list "babel-*" "eslint-*" semver@5`.
|
|
|
|
## Options
|
|
|
|
### --recursive, -r
|
|
|
|
Perform command on every package in subdirectories or on every workspace
|
|
package, when executed inside a workspace.
|
|
|
|
Since v11.28.0, running `pnpm list` inside a workspace package without
|
|
`--recursive` or `--filter` lists only that package.
|
|
|
|
### --json
|
|
|
|
Log output in JSON format.
|
|
|
|
### --long
|
|
|
|
Show extended information.
|
|
|
|
### --lockfile-only
|
|
|
|
Added in: v10.23.0
|
|
|
|
Read package information from the lockfile instead of checking the actual `node_modules` directory. This is useful for quickly inspecting what would be installed without requiring a full installation.
|
|
|
|
### --parseable
|
|
|
|
Outputs package directories in a parseable format instead of their tree view.
|
|
|
|
### --global, -g
|
|
|
|
List packages in the global install directory instead of in the current project.
|
|
|
|
### --depth <number\>
|
|
|
|
Max display depth of the dependency tree.
|
|
|
|
`pnpm ls --depth 0` (default) will list direct dependencies only.
|
|
`pnpm ls --depth -1` will list projects only. Useful inside a workspace when
|
|
used with the `-r` option.
|
|
`pnpm ls --depth Infinity` will list all dependencies regardless of depth.
|
|
|
|
### --prod, -P
|
|
|
|
Display only the dependency graph for packages in `dependencies` and
|
|
`optionalDependencies`.
|
|
|
|
### --dev, -D
|
|
|
|
Display only the dependency graph for packages in `devDependencies`.
|
|
|
|
### --no-optional
|
|
|
|
Don't display packages from `optionalDependencies`.
|
|
|
|
### --only-projects
|
|
|
|
Display only dependencies that are also projects within the workspace.
|
|
|
|
### --exclude-peers
|
|
|
|
Exclude peer dependencies from the results (but dependencies of peer dependencies are not ignored).
|
|
|
|
### --filter <package_selector\>
|
|
|
|
[Read more about filtering.](../filtering.md)
|
|
|
|
import FindBy from '../settings/_findBy.mdx'
|
|
|
|
<FindBy />
|