deno outdated - Denoland

Checking for outdated dependencies

The outdated subcommand checks for new versions of NPM and JSR dependencies listed in deno.json or package.json files, and displays dependencies that could be updated. Workspaces are fully supported, including workspaces where some members use package.json and others use deno.json.

For example, take a project with a deno.json file:

json

{
  "imports": {
    "@std/fmt": "jsr:@std/fmt@^1.0.0",
    "@std/async": "jsr:@std/[email protected]",
    "chalk": "npm:chalk@4"
  }
}

and a lockfile that has @std/fmt at version 1.0.0.

bash

$ deno outdated
┌────────────────┬─────────┬────────┬────────┐
│ Package        │ Current │ Update │ Latest │
├────────────────┼─────────┼────────┼────────┤
│ jsr:@std/fmt   │ 1.0.0   │ 1.0.3  │ 1.0.3  │
├────────────────┼─────────┼────────┼────────┤
│ jsr:@std/async │ 1.0.1   │ 1.0.1  │ 1.0.8  │
├────────────────┼─────────┼────────┼────────┤
│ npm:chalk      │ 4.1.2   │ 4.1.2  │ 5.3.0  │
└────────────────┴─────────┴────────┴────────┘

The Update column lists the newest semver-compatible version, while the Latest column lists the latest version.

Notice that jsr:@std/async is listed, even though there is no semver-compatible version to update to. If you would prefer to only show packages that have new compatible versions you can pass the --compatible flag.

bash

$ deno outdated --compatible
┌────────────────┬─────────┬────────┬────────┐
│ Package        │ Current │ Update │ Latest │
├────────────────┼─────────┼────────┼────────┤
│ jsr:@std/fmt   │ 1.0.0   │ 1.0.3  │ 1.0.3  │
└────────────────┴─────────┴────────┴────────┘

jsr:@std/fmt is still listed, since it could be compatibly updated to 1.0.3, but jsr:@std/async is no longer shown.

Updating dependencies

The outdated subcommand can also update dependencies with the --update flag. By default, it will only update dependencies to semver-compatible versions (i.e. it won't update to a breaking version).

bash

$ deno outdated --update
Updated 1 dependency:
 - jsr:@std/fmt 1.0.0 -> 1.0.3

To update to the latest versions (regardless of whether it's semver compatible), pass the --latest flag.

bash

$ deno outdated --update --latest
Updated 3 dependencies:
 - jsr:@std/async 1.0.1 -> 1.0.8
 - jsr:@std/fmt   1.0.0 -> 1.0.3
 - npm:chalk      4.1.2 -> 5.3.0

Selecting packages

The outdated subcommand also supports selecting which packages to operate on. This works with or without the `--update flag.

bash

$ deno outdated --update --latest chalk
Updated 1 dependency:
 - npm:chalk 4.1.2 -> 5.3.0

Multiple selectors can be passed, and wildcards (*) or exclusions (!) are also supported.

For instance, to update all packages with the @std scope, except for @std/fmt:

bash

$ deno outdated --update --latest "@std/*" "!@std/fmt"
Updated 1 dependency:
 - jsr:@std/async 1.0.1 -> 1.0.8

Note that if you use wildcards, you will probably need to surround the argument in quotes to prevent the shell from trying to expand them.

Updating to specific versions

In addition to selecting packages to update, the --update flag also supports selecting the new version specifying the version after @.

bash

❯ deno outdated --update [email protected] @std/[email protected]
Updated 2 dependencies:
 - jsr:@std/async 1.0.1 -> 1.0.6
 - npm:chalk      4.1.2 -> 5.2.0

Workspaces

In a workspace setting, by default outdated will only operate on the current workspace member.

For instance, given a workspace:

json

{
  "workspace": ["./member-a", "./member-b"]
}

Running

bash

deno outdated

from the ./member-a directory will only check for outdated dependencies listed in ./member-a/deno.json or ./member-a/package.json.

To include all workspace members, pass the --recursive flag (the -r shorthand is also accepted)

bash

deno outdated --recursive
deno outdated --update --latest -r