v14.2.0 release proposal

[targos]

2020-05-05, Version 14.2.0 (Current), @targos

Notable Changes

Track function calls with assert.CallTracker (experimental)

assert.CallTracker is a new experimental API that allows to track and later
verify the number of times a function was called. This works by creating a
CallTracker object and using its calls method to create wrapper functions
that will count each time they are called. Then the verify method can be used
to assert that the expected number of calls happened:

const assert = require('assert');

const tracker = new assert.CallTracker();

function func() {}
// callsfunc() must be called exactly twice before tracker.verify().
const callsfunc = tracker.calls(func, 2);
callsfunc();
callsfunc();

function otherFunc() {}
// The second parameter defaults to `1`.
const callsotherFunc = tracker.calls(otherFunc);
callsotherFunc();

// Calls tracker.verify() and verifies if all tracker.calls() functions have
// been called the right number of times.
process.on('exit', () => {
  tracker.verify();
});

Additionally, tracker.report() will return an array which contains information
about the errors, if there are any:

const assert = require('assert');

const tracker = new assert.CallTracker();

function func() {}
const callsfunc = tracker.calls(func);

console.log(tracker.report());
/*
[
  {
    message: 'Expected the func function to be executed 1 time(s) but was executed 0 time(s).',
    actual: 0,
    expected: 1,
    operator: 'func',
    stack: Error
        ...
  }
]
*/

Contributed by ConorDavenport - #31982.

Console groupIndentation option

The Console constructor (require('console').Console) now supports different group indentations.

This is useful in case you want different grouping width than 2 spaces.

const { Console } = require('console');
const customConsole = new Console({
  stdout: process.stdout,
  stderr: process.stderr,
  groupIndentation: 10
});

customConsole.log('foo');
// 'foo'
customConsole.group();
customConsole.log('foo');
//           'foo'

Contributed by rickyes - #32964.

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/31167/
V8: https://ci.nodejs.org/job/node-test-commit-v8-linux/3092/
CITGM: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/2372/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/31173/

[targos]

@nodejs/testing test.parallel/test-https-foafssl failed twice in a row. Is it a known flake?

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/31174/

[mcollina]

May I get a link to a Windows build of this? I would like to test if this solves #33166 by any chance.

[targos]

@mcollina I just triggered an RC build: https://ci-release.nodejs.org/job/iojs+release/6009/

It will be available at https://nodejs.org/download/rc/v14.2.0-rc.0/

[targos]

@mcollina : https://direct.nodejs.org/download/rc/v14.2.0-rc.0/

[BridgeAR]

@targos here's a description for the console change:

Console groupIndentation option

The Console constructor (require('console').Console) now supports different group indentations.

This is useful in case you want different grouping width than 2 spaces.

const { Console } = require('console');
const ownConsole = new Console({
  stdout: process.stdout,
  stderr: process.stderr,
  groupIndentation: 10
});

ownConsole.log('foo');
// 'foo'
ownConsole.group();
ownConsole.log('foo');
//           'foo'

[targos]

Release build: https://ci-release.nodejs.org/job/iojs+release/6011/

[addaleax]

I really like the commit grouping here btw :)