.pnpmfile.cjs
- 钩子
- 相关配置

.pnpmfile.cjs

pnpm 允许您通过特殊功能（钩子）直接挂钩到安装过程。钩子可以在名为 .pnpmfile.cjs 的文件中声明。

默认情况下， .pnpmfile.cjs 应该与锁文件位于同一目录中。例如，在具有共享锁文件的工作区中 .pnpmfile.cjs 应该位于 monorepo 的根目录中。

钩子

摘要：

钩子函数	过程	用途
`hooks.readPackage(pkg, context): pkg`	在 pnpm 解析依赖项的包清单后调用	允许您改变依赖项的 `package.json`
`hooks.afterAllResolved(lockfile, context): lockfile`	在解析完依赖关系后调用。	允许您更改锁文件。

`hooks.readPackage(pkg, context): pkg | Promise<pkg>`

允许您在语法解析之后和依赖解析之前改变依赖项的 package.json。这些突变不会保存到文件系统，但是，它们将影响被解析至锁文件的内容，从而影响哪些包将被安装。

请注意，如果您已经解析好了要修改的依赖项，则需要删除 pnpm-lock.yaml。

参数

pkg - 包的清单。来自注册源的响应或 package.json 的内容。
context - 步骤的上下文对象。方法 #log(msg) 允许您使用该步骤的调试日志。

使用方法

示例 .pnpmfile.cjs （更改依赖项的依赖关系）：

function readPackage(pkg, context) {
  // Override the manifest of foo@1.x after downloading it from the registry
  if (pkg.name === 'foo' && pkg.version.startsWith('1.')) {
    // Replace bar@x.x.x with bar@2.0.0
    pkg.dependencies = {
      ...pkg.dependencies,
      bar: '^2.0.0'
    }
    context.log('bar@1 => bar@2 in dependencies of foo')
  }
  // This will change any packages using baz@x.x.x to use baz@1.2.3
  if (pkg.dependencies.baz) {
    pkg.dependencies.baz = '1.2.3';
  }
  return pkg
}
module.exports = {
  hooks: {
    readPackage
  }
}

已知限制

使用 readPackage 从依赖项的清单中删除 scripts 字段不会阻止 pnpm 构建依赖项。构建依赖时，pnpm 从包的存档中读取包的 package.json ，这不受钩子的影响。为了忽略包的构建，请使用 pnpm.neverBuiltDependencies 字段。

`hooks.afterAllResolved(lockfile, context): lockfile | Promise<lockfile>`

添加于：v1.41.0

允许您在序列化之前更改锁文件的输出。

参数

lockfile - 锁文件的解析对象，序列化为 pnpm-lock.yaml。
context - 步骤的上下文对象。方法 #log(msg) 允许您使用该步骤的调试日志。

用法示例

.pnpmfile.cjs

function afterAllResolved(lockfile, context) {
  // ...
  return lockfile
}
module.exports = {
  hooks: {
    afterAllResolved
  }
}

已知限制

没有 - 任何可以通过修改锁文件达到的功能都可以通过这个函数完成，甚至可以扩展锁文件的功能。

.pnpmfile.cjs

.pnpmfile.cjs

钩子

摘要：

`hooks.readPackage(pkg, context): pkg | Promise<pkg>`

参数

使用方法

已知限制

`hooks.afterAllResolved(lockfile, context): lockfile | Promise<lockfile>`

参数

用法示例

已知限制

相关配置

ignore-pnpmfile

pnpmfile

global-pnpmfile