# npm view
查看注册中心信息
# 概要
npm view [<package-spec>] [<field>[.subfield]...]
aliases: info, show, v
# 描述
此命令显示有关包的数据并将其打印到标准输出。
例如,connect
要从注册表查看有关包的信息,你可以运行:
npm view connect
如果未指定,默认版本是 lastest
。
可以在包描述符之后指定字段名称。例如,要在 0.3.5 版本显示 ronn
包的依赖项,你可以执行以下操作:
npm view ronn@0.3.5 dependencies
你可以通过用句点分隔子字段来查看子字段。要查看 npm 最新版本的 git 存储库 URL,你可以执行以下操作:
npm view npm repository.url
这使得通过一些 shell 脚本可以轻松查看有关依赖项的信息。例如,要查看有关 ronn
所依赖的 opts
版本的所有数据,你可以这样做:
npm view opts@$(npm view ronn dependencies.opts)
对于数组字段,请求非数字字段将返回列表中对象的所有值。例如,要获取 express
项目的所有贡献者姓名,你可以这样做:
npm view express contributors.email
你还可以使用方括号中的数字索引来专门选择数组字段中的项目。要获取列表中第一个贡献者的电子邮件地址,你可以执行以下操作:
npm view express contributors[0].email
可以指定多个字段,并将一个接一个打印。例如,要获取所有贡献者姓名和电子邮件地址,你可以执行以下操作:
npm view express contributors.name contributors.email
如果 person
字段显示为对象,则它们显示为字符串。因此,例如,这将以缩短的字符串格式显示 npm 贡献者列表。(有关 package.json
更多信息,请参阅。)
npm view npm contributors
如果提供了版本范围,则将为包的每个匹配版本打印数据。这将显示 jsdom 的每个匹配版本的需要哪个版本的 yui3:
npm view yui3@'>0.5.4' dependencies.jsdom
要显示 connect
包版本历史记录,你可以执行以下操作:
npm view connect versions
# 配置
# json
- Default: false
- Type: Boolean
是否输出 JSON 数据,而不是正常输出。
npm pkg set
支持使用 JSON.parse() 解析集合值,然后保存到你的package.json
。
并非所有 npm 命令都支持。
# workspace
- Default:
- Type: String (可以设置多次)
启用在当前项目的已配置工作区的上下文中运行命令,同时通过仅运行此配置选项定义的工作区进行过滤。
workspace
配置的有效值如下:
- 工作区名称
- 工作区目录的路径
- 父工作区目录的路径(将导致选择该文件夹中的所有工作区)
为 npm init
命令设置时,可以将其设置为尚不存在的工作空间的文件夹,以创建文件夹并将其设置为项目中的全新工作空间。
此值不会导出到子进程的环境中。
# workspaces
- Default: null
- Type: null or Boolean
设置为 true 将在所有配置的工作区中运行该命令。
显式地将此设置为 false 将导致如下命令 install
完全忽略工作空间。当没有显式设置时:
- 在
node_modules
树上操作的命令 (install, update, etc.) 时,将把工作区链接到node_modules
文件夹中。做其他事情的命令 (test, exec, publish, etc.) 将在根项目上操作,除非在workspace
配置中指定了一个或多个工作空间。
此值不会导出到子进程的环境中。
# include-workspace-root
- Default: false
- Type: Boolean
当为某个命令启用工作区时,请包含工作区根目录。
当为 false 时,通过 workspace
配置指定单个工作空间,或通过 workspaces
标志指定所有工作空间,将导致 npm 仅在指定的工作空间上运行,而不是在根项目上运行。
此值不会导出到子进程的环境中。
# 输出
如果只输出单个版本的单个字符串字段,则不会对其进行着色或引用,以便能够将输出传递到另一个命令。如果该字段是一个对象,它将作为 JavaScript 对象字面量输出。
如果给出了 --json
标志,则输出的字段将为 JSON。
如果版本范围匹配多个版本,则每个打印值都将以其适用的版本作为前缀。
如果请求多个字段,则每个字段都以字段名称为前缀。