目录
npm-install-test
选择 CLI 版本
目录
摘要
npm install-test [<package-spec> ...]alias: it
描述
此命令运行 npm install
,然后立即运行 npm test
。它接受与 npm install
完全相同的参数。
配置
save
- 默认:
true
,除非使用npm update
,在这种情况下默认为false
- 类型:布尔值
将安装的包保存到 package.json
文件中作为依赖项。
当与 npm rm
命令一起使用时,会从 package.json
中删除依赖项。
如果设置为 false
,也会阻止写入 package-lock.json
。
save-exact
- 默认:false
- 类型:布尔值
保存到 package.json 的依赖项将使用精确版本进行配置,而不是使用 npm 的默认 semver 范围运算符。
global
- 默认:false
- 类型:布尔值
在“全局”模式下运行,因此包将安装到 prefix
文件夹中,而不是当前工作目录。有关行为差异的更多信息,请参见 文件夹。
- 包安装到
{prefix}/lib/node_modules
文件夹中,而不是当前工作目录。 - bin 文件链接到
{prefix}/bin
- 手册页链接到
{prefix}/share/man
install-strategy
- 默认:“hoisted”
- 类型:“hoisted”、“nested”、“shallow” 或“linked”
设置在 node_modules 中安装包的策略。hoisted(默认):在顶层安装未重复的包,并在目录结构中根据需要重复安装。nested:(以前为 --legacy-bundling)就地安装,不进行提升。shallow(以前为 --global-style)仅在顶层安装直接依赖项。linked:(实验性)安装到 node_modules/.store 中,就地链接,不进行提升。
legacy-bundling
- 默认:false
- 类型:布尔值
- 已弃用:此选项已弃用,取而代之的是
--install-strategy=nested
不要在 node_modules
中提升包安装,而是以与它们被依赖的方式相同的方式安装包。这可能会导致非常深的目录结构和重复的包安装,因为没有去重。设置 --install-strategy=nested
。
global-style
- 默认:false
- 类型:布尔值
- 已弃用:此选项已弃用,取而代之的是
--install-strategy=shallow
仅在顶层 node_modules
中安装直接依赖项,但在更深层的依赖项上进行提升。设置 --install-strategy=shallow
。
omit
- 默认:如果
NODE_ENV
环境变量设置为“production”,则为“dev”,否则为空。 - 类型:“dev”、“optional” 或“peer”(可以设置多次)
从磁盘上的安装树中省略的依赖项类型。
请注意,这些依赖项仍然会被解析并添加到 package-lock.json
或 npm-shrinkwrap.json
文件中。它们只是没有实际安装在磁盘上。
如果包类型同时出现在 --include
和 --omit
列表中,则它将被包含。
如果生成的省略列表包含 'dev'
,那么对于所有生命周期脚本,NODE_ENV
环境变量将被设置为 'production'
。
include
- 默认
- 类型:“prod”、“dev”、“optional” 或“peer”(可以设置多次)
允许定义要安装的依赖项类型的选项。
这是 --omit=<type>
的反面。
在 --include
中指定的依赖项类型不会被省略,无论在命令行上省略/包含的指定顺序如何。
strict-peer-deps
- 默认:false
- 类型:布尔值
如果设置为 true
,并且 --legacy-peer-deps
未设置,则任何冲突的 peerDependencies
将被视为安装失败,即使 npm 可以基于非对等依赖项关系合理地猜测合适的解决方案。
默认情况下,依赖项图中深层的冲突 peerDependencies
将使用最接近的非对等依赖项规范进行解析,即使这样做会导致某些包收到超出其包的 peerDependencies
对象中设置的范围的对等依赖项。
当执行此类覆盖时,将打印警告,解释冲突和涉及的包。如果设置了 --strict-peer-deps
,则该警告将被视为失败。
prefer-dedupe
- 默认:false
- 类型:布尔值
如果可能,优先对包进行去重,而不是选择依赖项的更新版本。
package-lock
- 默认:true
- 类型:布尔值
如果设置为 false,则在安装时忽略 package-lock.json
文件。这也会阻止在 save
为 true 时写入 package-lock.json
。
package-lock-only
- 默认:false
- 类型:布尔值
如果设置为 true,当前操作将只使用 package-lock.json
,忽略 node_modules
。
对于 update
,这意味着只有 package-lock.json
会被更新,而不是检查 node_modules
并下载依赖项。
对于 list
,这意味着输出将基于 package-lock.json
中描述的树,而不是 node_modules
的内容。
foreground-scripts
- 默认值:
false
,除非使用npm pack
或npm publish
,在这种情况下默认为true
。 - 类型:布尔值
在前景进程中运行所有已安装包的构建脚本(例如,preinstall
、install
和 postinstall
),与主 npm 进程共享标准输入、输出和错误。
请注意,这通常会使安装速度变慢,并产生更多噪音,但这对于调试非常有用。
ignore-scripts
- 默认:false
- 类型:布尔值
如果为 true,npm 不会运行 package.json 文件中指定的脚本。
请注意,明确用于运行特定脚本的命令,例如 npm start
、npm stop
、npm restart
、npm test
和 npm run-script
,如果设置了 ignore-scripts
,它们仍然会运行其目标脚本,但它们不会运行任何前置或后置脚本。
audit
- 默认:true
- 类型:布尔值
当为 "true" 时,将审核报告与当前 npm 命令一起提交到默认注册表以及为范围配置的所有注册表。有关提交内容的详细信息,请参阅 npm audit
文档。
bin-links
- 默认:true
- 类型:布尔值
告诉 npm 为包可执行文件创建符号链接(或在 Windows 上创建 .cmd
shim)。
设置为 false 以使其不执行此操作。这可用于解决某些文件系统不支持符号链接这一事实,即使在表面上是 Unix 系统上也是如此。
fund
- 默认:true
- 类型:布尔值
当为 "true" 时,在每次 npm install
结束时显示一条消息,确认正在寻找资助的依赖项数量。有关详细信息,请参阅 npm fund
。
dry-run
- 默认:false
- 类型:布尔值
指示您不希望 npm 进行任何更改,并且它应该只报告将要执行的操作。这可以传递到任何修改本地安装的命令中,例如 install
、update
、dedupe
、uninstall
,以及 pack
和 publish
。
注意:其他与网络相关的命令(例如 dist-tags
、owner
等)不会遵守此设置。
cpu
- 默认值:null
- 类型:null 或 String
覆盖要安装的本机模块的 CPU 架构。可接受的值与 package.json 的 cpu
字段相同,该字段来自 process.arch
。
os
- 默认值:null
- 类型:null 或 String
覆盖要安装的本机模块的操作系统。可接受的值与 package.json 的 os
字段相同,该字段来自 process.platform
。
libc
- 默认值:null
- 类型:null 或 String
覆盖要安装的本机模块的 libc。可接受的值与 package.json 的 libc
字段相同。
workspace
- 默认
- 类型:String(可以设置多次)
启用在当前项目的配置工作区的上下文中运行命令,同时通过仅运行此配置选项定义的工作区进行过滤。
对于 workspace
配置,有效值为:
- 工作区名称
- 工作区目录的路径
- 父工作区目录的路径(将导致选择该文件夹中的所有工作区)
当为 npm init
命令设置时,这可以设置为尚未存在的工作区的文件夹,以创建文件夹并将其设置为项目中的一个全新工作区。
此值不会导出到子进程的环境中。
workspaces
- 默认值:null
- 类型:null 或 Boolean
设置为 true 以在 **所有** 配置的工作区的上下文中运行命令。
明确将此设置为 false 将导致像 install
这样的命令完全忽略工作区。当未明确设置时,
- 对
node_modules
树进行操作的命令(install、update 等)将链接工作区到node_modules
文件夹中。 - 执行其他操作的命令(test、exec、publish 等)将在根项目上运行,*除非*workspace
配置中指定了一个或多个工作区。
此值不会导出到子进程的环境中。
include-workspace-root
- 默认:false
- 类型:布尔值
在为命令启用工作区时,包含工作区根目录。
当为 false 时,通过 workspace
配置指定单个工作区,或通过 workspaces
标志指定所有工作区,将导致 npm 仅在指定的工作区上运行,而不是在根项目上运行。
此值不会导出到子进程的环境中。
install-links
- 默认:false
- 类型:布尔值
当设置 file: 协议依赖项时,它们将被打包并作为常规依赖项安装,而不是创建符号链接。此选项对工作区没有影响。