check-outdated

check-outdated

[](https://opensource.org/licenses/MIT)

Light-weight CLI tool to ensure that your dependencies are up-to-date, otherwise the process is terminated with status code 1.

This is an improved version of npm outdated, which can be used in build-pipelines, pre-publish scripts (npm) or pre-commit hook (Git) to make sure all the used dependencies are up-to-date.

• Zero dependencies
• Optionally ignore pre-releases (e.g. "2.1.0-alpha", "2.1.0-beta", "2.1.0-rc.1")
• Optionally ignore dev dependencies
• Optionally ignore specific packages
• Optionally ignore a specific version or version range of a package (e.g. to skip a broken version)
• Optionally filter by version age to avoid very new or potentially compromised releases

• Supports aliased npm dependencies (e.g. "alias-name": "npm:actual-package@1.0.0")
• Optionally restrict the update type (e.g. only show minor updates, or reverted versions)
• Optionally check globally installed packages
• Optionally set depth for checking dependency tree
• Show link to changelogs
• Configure visible columns

Example Screenshot

<img src="https://cdn.jsdelivr.net/gh/jens-duttke/check-outdated@93cb33b/screenshot.png" width="100%" alt="" /

Usage without installation

The benefit of using npx is, that it ensures that always the latest version of check-outdated is used. In addition, a download is only necessary in environments where it is needed - e.g. if check-outdated is not needed on the build server, it does not have to be downloaded there, which may speeds up the dependency installation slightly.

On command-line you can run the command like this:

npx check-outdated

All arguments are optional. Here is a more advanced example:

npx check-outdated --ignore-pre-releases --ignore-dev-dependencies --ignore-packages package1,package2 --columns name,type,current,latest,changes --min-age 14 --min-age-patch 3

Or put it into your package.json:

{
  "scripts": {
    "check-outdated": "npx --yes -- check-outdated --ignore-pre-releases --ignore-dev-dependencies --ignore-packages package1,package2 --columns name,type,current,latest,changes --types major,minor,patch,reverted --min-age 14 --min-age-patch 3",
    "preversion": "npm run lint && npm run test && npm run check-outdated"
  }
}

Usage with installation

Install