1NPM-LS(1) NPM-LS(1)
2
3
4
6 npm-ls - List installed packages
7
8 Synopsis
9 npm ls [[<@scope>/]<pkg> ...]
10
11 aliases: list, la, ll
12
13 Description
14 This command will print to stdout all the versions of packages that are
15 installed, as well as their dependencies, in a tree-structure.
16
17 Positional arguments are name@version-range identifiers, which will
18 limit the results to only the paths to the packages named. Note that
19 nested packages will also show the paths to the specified packages.
20 For example, running npm ls promzard in npm's source tree will show:
21
22 npm@6.14.11 /path/to/npm
23 └─┬ init-package-json@0.0.4
24 └── promzard@0.1.5
25
26 It will print out extraneous, missing, and invalid packages.
27
28 If a project specifies git urls for dependencies these are shown in
29 parentheses after the name@version to make it easier for users to rec‐
30 ognize potential forks of a project.
31
32 The tree shown is the logical dependency tree, based on package depen‐
33 dencies, not the physical layout of your node_modules folder.
34
35 When run as ll or la, it shows extended information by default.
36
37 Configuration
38 json
39 · Default: false
40
41 · Type: Boolean
42
43
44 Show information in JSON format.
45
46 long
47 · Default: false
48
49 · Type: Boolean
50
51
52 Show extended information.
53
54 parseable
55 · Default: false
56
57 · Type: Boolean
58
59
60 Show parseable output instead of tree view.
61
62 global
63 · Default: false
64
65 · Type: Boolean
66
67
68 List packages in the global install prefix instead of in the current
69 project.
70
71 depth
72 · Type: Int
73
74
75 Max display depth of the dependency tree.
76
77 prod / production
78 · Type: Boolean
79
80 · Default: false
81
82
83 Display only the dependency tree for packages in dependencies.
84
85 dev / development
86 · Type: Boolean
87
88 · Default: false
89
90
91 Display only the dependency tree for packages in devDependencies.
92
93 only
94 · Type: String
95
96
97 When "dev" or "development", is an alias to dev.
98
99 When "prod" or "production", is an alias to production.
100
101 link
102 · Type: Boolean
103
104 · Default: false
105
106
107 Display only dependencies which are linked
108
109 unicode
110 · Type: Boolean
111
112 · Default: true
113
114
115 Whether to represent the tree structure using unicode characters. Set
116 it to false in order to use all-ansi output.
117
118 See Also
119 · npm help config
120
121 · npm help npmrc
122
123 · npm help folders
124
125 · npm help install
126
127 · npm help link
128
129 · npm help prune
130
131 · npm help outdated
132
133 · npm help update
134
135
136
137
138 February 2021 NPM-LS(1)