diff --git a/docs/content/using-npm/scripts.md b/docs/content/using-npm/scripts.md index 8fb9dc1a677b4..2b9171e4aefdd 100644 --- a/docs/content/using-npm/scripts.md +++ b/docs/content/using-npm/scripts.md @@ -39,7 +39,7 @@ There are some special life cycle scripts that happen only in certain situations. These scripts happen in addition to the `pre`, `post`, and `` scripts. -* `prepare`, `prepublish`, `prepublishOnly`, `prepack`, `postpack` +* `prepare`, `prepublish`, `prepublishOnly`, `prepack`, `postpack`, `dependencies` **prepare** (since `npm@4.0.0`) * Runs any time before the package is packed, i.e. during `npm publish` @@ -71,6 +71,10 @@ situations. These scripts happen in addition to the `pre`, `post`, **postpack** * Runs AFTER the tarball has been generated but before it is moved to its final destination (if at all, publish does not save the tarball locally) +**dependencies** +* Runs AFTER any operations that modify the `node_modules` directory IF changes occurred. +* Does NOT run in global mode + #### Prepare and Prepublish **Deprecation Note: prepublish** @@ -96,6 +100,10 @@ The advantage of doing these things at `prepublish` time is that they can be don * You don't need to rely on your users having `curl` or `wget` or other system tools on the target machines. +#### Dependencies + +The `dependencies` script is run any time an `npm` command causes changes to the `node_modules` directory. It is run AFTER the changes have been applied and the `package.json` and `package-lock.json` files have been updated. + ### Life Cycle Operation Order #### [`npm cache add`](/commands/npm-cache)