compare current version against latest and not wanted version in outdated command

__tests__/commands/outdated.js

@@ -22,6 +22,18 @@ const runOutdated = buildRun.bind(
           write() {},
         }),
       });
+
+      // mock all formatters so we can assert on all of them
+      const mockFormat = {};
+      Object.keys(this.format).forEach(key => {
+        mockFormat[key] = jest.fn(this.format[key]);
+      });
+      // $FlowFixMe
+      this.format = mockFormat;
+    }
+
+    info(msg: string) {
+      // Overwrite to not interfere with the table output
     }
   },
   fixturesLoc,
@@ -56,6 +68,7 @@ test.concurrent('works with no arguments', (): Promise<void> => {
     const json: Object = JSON.parse(out);
 
     expect(json.data.body.length).toBe(1);
+    expect(reporter.format.green).toHaveBeenCalledWith('left-pad');
   });
 });
 
@@ -65,6 +78,7 @@ test.concurrent('works with single argument', (): Promise<void> => {
 
     expect(json.data.body.length).toBe(1);
     expect(json.data.body[0][0]).toBe('max-safe-integer');
+    expect(reporter.format.green).toHaveBeenCalledWith('max-safe-integer');
   });
 });
 
@@ -77,6 +91,8 @@ test.concurrent('works with multiple arguments', (): Promise<void> => {
     expect(json.data.body.length).toBe(2);
     expect(json.data.body[0][0]).toBe('left-pad');
     expect(json.data.body[1][0]).toBe('max-safe-integer');
+    expect(reporter.format.yellow).toHaveBeenCalledWith('left-pad');
+    expect(reporter.format.green).toHaveBeenCalledWith('max-safe-integer');
   });
 });
 
@@ -95,7 +111,9 @@ test.concurrent('works with exotic resolvers', (): Promise<void> => {
 
     expect(json.data.body.length).toBe(2);
     expect(json.data.body[0]).toEqual(first);
+    expect(reporter.format.red).toHaveBeenCalledWith('max-safe-integer');
     expect(json.data.body[1]).toEqual(second);
+    expect(reporter.format.red).toHaveBeenCalledWith('yarn');
   });
 });
 
@@ -112,6 +130,7 @@ test.concurrent('shows when wanted > current and current > latest', (): Promise<
     expect(json.data.body.length).toBe(1);
     expect(json.data.body[0][0]).toBe('webpack');
     expect(semver.lt(json.data.body[0][1], json.data.body[0][2])).toBe(true);
+    expect(reporter.format.yellow).toHaveBeenCalledWith('webpack');
   });
 });
 
@@ -124,9 +143,12 @@ test.concurrent('displays correct dependency types', (): Promise<void> => {
     expect(json.data.body.length).toBe(3);
     expect(body[0][0]).toBe('is-online');
     expect(body[0][4]).toBe('optionalDependencies');
+    expect(reporter.format.red).toHaveBeenCalledWith('is-online');
     expect(body[1][0]).toBe('left-pad');
     expect(body[1][4]).toBe('dependencies');
+    expect(reporter.format.yellow).toHaveBeenCalledWith('left-pad');
     expect(body[2][0]).toBe('max-safe-integer');
     expect(body[2][4]).toBe('devDependencies');
+    expect(reporter.format.green).toHaveBeenCalledWith('max-safe-integer');
   });
 });

src/cli/commands/outdated.js

@@ -30,7 +30,7 @@ export async function run(config: Config, reporter: Reporter, flags: Object, arg
   }
 
   const getNameFromHint = hint => (hint ? `${hint}Dependencies` : 'dependencies');
-  const colorizeName = ({current, wanted, name}) => reporter.format[colorForVersions(current, wanted)](name);
+  const colorizeName = ({current, latest, name}) => reporter.format[colorForVersions(current, latest)](name);
 
   if (deps.length) {
     const body = deps.map((info): Array<string> => {
@@ -44,6 +44,11 @@ export async function run(config: Config, reporter: Reporter, flags: Object, arg
       ];
     });
 
+    const red = reporter.format.red('<red>');
+    const yellow = reporter.format.yellow('<yellow>');
+    const green = reporter.format.green('<green>');
+    reporter.info(reporter.lang('legendColorsForOutdated', red, yellow, green));
+
     reporter.table(['Package', 'Current', 'Wanted', 'Latest', 'Package Type', 'URL'], body);
     return 1;
   }

src/reporters/lang/en.js

@@ -114,6 +114,8 @@ const messages = {
   allDependenciesUpToDate: 'All of your dependencies are up to date.',
   legendColorsForUpgradeInteractive:
     'Color legend : \n $0    : Major Update backward-incompatible updates \n $1 : Minor Update backward-compatible features \n $2  : Patch Update backward-compatible bug fixes',
+  legendColorsForOutdated:
+    'Color legend : \n $0    : Major Update backward-incompatible updates \n $1 : Minor Update backward-compatible features \n $2  : Patch Update backward-compatible bug fixes',
   frozenLockfileError: 'Your lockfile needs to be updated, but yarn was run with `--frozen-lockfile`.',
   fileWriteError: 'Could not write file $0: $1',
   multiplePackagesCantUnpackInSameDestination: