Package Exports

check-outdated

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (check-outdated) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

check-outdated

Ensures 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 of a package (e.g. to skip a broken version)
Optionally check globally installed packages
Optionally set depth for checking dependency tree
Show link to changelogs
Configure visible columns

Example Screenshot

Install

npm install check-outdated --save-dev

Usage

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

node_modules/.bin/check-outdated --ignore-pre-releases --ignore-dev-dependencies --ignore-packages package1,package2 --columns name,type,current,latest,changes

Or put it into your package.json:

{
  "scripts": {
    "check-outdated": "check-outdated --ignore-pre-releases --ignore-dev-dependencies --ignore-packages package1,package2 --columns name,type,current,latest,changes",
    "preversion": "npm run lint && npm run test && npm run check-outdated"
  }
}

Argument	Description	Example
--help, -h	Show the help	`--help`
--ignore-pre-releases	Don't recommend to update to the latest version, if it contains a hyphen (e.g. "2.1.0-alpha", "2.1.0-beta", "2.1.0-rc.1")	`--ignore-pre-releases`
--ignore-dev-dependencies	Do not warn if devDependencies are outdated.	`--ignore-dev-dependencies`
--ignore-packages <comma-separated-list-of-package-names>	Ignore the listed packages, even if they are outdated. Using the `@` syntax (`<package>@<version>`) you can also, only ignore a specific version of a package (e.g. if it's broken).	`--ignore-packages typescript,terser-webpack-plugin@3.0.0`
--columns <comma-separated-list-of-columns>	Defines which columns should be shown in which order. (See Available Columns below)	`--columns name,current,latest,changes`
--global	Check packages in the global install prefix instead of in the current project (equal to the npm outdated-option)	`--global`
--depth <number>	Max depth for checking dependency tree (equal to the npm outdated-option)	`--depth 3`

Available Columns

By default, the following columns are shown:
name, current, wanted, latest, type, location, packageType, changes

You are able to overwrite the default by using the --columns argument.

Caption	--columns value	Description	Example
Package	`name`	The name of the package. Red means there's a newer version matching your semver requirements, so you should update now. Yellow indicates that there's a newer version above your semver requirements (usually new major, or new 0.x minor) so proceed with caution.	typescript
Current	`current`	The currently installed version of the package.	3.7.2
Wanted	`wanted`	The maximum version of the package that satisfies the semver range specified in package.json. If there's no available semver range (i.e. you're using the `--global` argument, or the package isn't included in package.json), then wanted shows the currently-installed version. This column is always colored in green.	3.7.2
Latest	`latest`	The version of the package tagged as latest in the npm registry. This column is always colored in magenta.	3.8.3
Type	`type`	Shows if the difference between Current and Latest is a `major`, `minor` or `patch` update, in Semantic Versioning.	minor
Location	`location`	Shows where in the dependency tree the package is located. Note that check-outdated defaults to a depth of 0, so unless you override that, you'll always be seeing only top-level dependencies that are outdated.	node_modules/typescript
Package Type	`packageType`	Tells you whether this package is a `dependency` or a `devDependency`. Packages not included in package.json are always marked dependencies.	devDependencies
Reference	`reference`	Contains a link to the line and column of the dependency in the package.json. By using a terminal which supports clicking on such links, you can navigate directly the the item.	P:\my-project\package.json:47:3
Changes	`changes`	check-outdated tries to find a direct link to changelog of the package. The following places are considered in the given order: {package}/package.json > "repository" * {package}/package.json > "homepage" `https://www.npmjs.com/package/{name}` * GitHub-repository URLs are adjusted, so that they directly link to the CHANGELOG.md or the Releases section.	https://github.com/Microsoft/TypeScript/releases
Changes	`changesPreferLocal`	Same as `changes`, but first check for a CHANGELOG.md in the package folder. Keep in mind, you'll only see the changelog of the currently installed version, not of the version which is recommended.	node_modules/fs-extra/CHANGELOG.md
Homepage	`homepage`	An URL with additional information to the package. The following places are considered in the given order: {package}/package.json > "homepage" {package}/package.json > "repository" {package}/package.json > "author" `https://www.npmjs.com/package/{name}`	https://www.typescriptlang.org/
npmjs.com	`npmjs`	A link to the package on the npmjs.com website.	https://www.npmjs.com/package/typescript