Logger package in Changesets source code provides a documentation about silencing log message in tests. This got me wonder how Changesets do it and made me look into its source code.
Changesets repository search for silencing logs
I searched for temporarilySilenceLogs across the Changesets repo using Github search.
What made me choose to search for temporarilySilenceLogs is the fact that it is mentioned in the Logger
package Readme.
import { temporarilySilenceLogs } from "@changesets/test-utils";
import { log } from "@changesets/logger";
temporarilySilenceLogs();
// Now the logs in this test file are not actually logged to std out
log("I am not logged");
// Use console.log to log messages in tests if required
console.log("Yay, I am logged");
When you are trying to understand the source code, you can use documentation as your starting point and search for variables and functions to set the direction for your exploration when you are dealing with large projects like Changesets.
temporarilySilenceLogs
The below code is picked from Changesets source code.
This function accepts a function as argument and then silences the logs using a function named createLogSilencer.
Pay attention to the setup function here:
const dispose = silencer.setup();
try {
await testFn();
} finally {
dispose();
}
createLogSilencer
Below code is picked from Changesets
const createLogSilencer = () => {
const originalLoggerError = logger.error;
const originalLoggerInfo = logger.info;
const originalLoggerLog = logger.log;
const originalLoggerWarn = logger.warn;
const originalLoggerSuccess = logger.success;
const originalConsoleError = console.error;
const originalConsoleInfo = console.info;
const originalConsoleLog = console.log;
const originalConsoleWarn = console.warn;
const originalStdoutWrite = process.stdout.write;
const originalStderrWrite = process.stderr.write;
return {
setup() {
logger.error = jest.fn();
logger.info = jest.fn();
logger.log = jest.fn();
logger.warn = jest.fn();
logger.success = jest.fn();
console.error = jest.fn();
console.info = jest.fn();
console.log = jest.fn();
console.warn = jest.fn();
process.stdout.write = jest.fn();
process.stderr.write = jest.fn();
return () => {
logger.error = originalLoggerError;
logger.info = originalLoggerInfo;
logger.log = originalLoggerLog;
logger.warn = originalLoggerWarn;
logger.success = originalLoggerSuccess;
console.error = originalConsoleError;
console.info = originalConsoleInfo;
console.log = originalConsoleLog;
console.warn = originalConsoleWarn;
process.stdout.write = originalStdoutWrite;
process.stderr.write = originalStderrWrite;
};
},
};
};
What is happening here?
- The assignment
const originalLoggerError = logger.error;
const originalLoggerInfo = logger.info;
const originalLoggerLog = logger.log;
const originalLoggerWarn = logger.warn;
const originalLoggerSuccess = logger.success;
const originalConsoleError = console.error;
const originalConsoleInfo = console.info;
const originalConsoleLog = console.log;
const originalConsoleWarn = console.warn;
const originalStdoutWrite = process.stdout.write;
const originalStderrWrite = process.stderr.write;
2. Returns setup
If you noticed above, setup is called inside temporarilySilenceLogs, this is returned by createLogSilencer
return {
setup() {
logger.error = jest.fn();
logger.info = jest.fn();
logger.log = jest.fn();
logger.warn = jest.fn();
logger.success = jest.fn();
console.error = jest.fn();
console.info = jest.fn();
console.log = jest.fn();
console.warn = jest.fn();
process.stdout.write = jest.fn();
process.stderr.write = jest.fn();
return () => {
logger.error = originalLoggerError;
logger.info = originalLoggerInfo;
logger.log = originalLoggerLog;
logger.warn = originalLoggerWarn;
logger.success = originalLoggerSuccess;
console.error = originalConsoleError;
console.info = originalConsoleInfo;
console.log = originalConsoleLog;
console.warn = originalConsoleWarn;
process.stdout.write = originalStdoutWrite;
process.stderr.write = originalStderrWrite;
};
},
};
What is happening in the setup function?
2.1 Loggers and console API are initialised to jest.fn()
logger.error = jest.fn();
logger.info = jest.fn();
logger.log = jest.fn();
logger.warn = jest.fn();
logger.success = jest.fn();
console.error = jest.fn();
console.info = jest.fn();
console.log = jest.fn();
console.warn = jest.fn();
process.stdout.write = jest.fn();
process.stderr.write = jest.fn();
This pretty much silences the logs since jest.fn() gets called when you use any logger, hence this is considerd as setup, an important step to silence your logs.
2.2 setUp returns original loggers
If you have noticed, the sequence of function calls are
a. const silencer = createLogSilencer();
b. const dispose = silencer.setup();
c. In the finally block.
try {
await testFn();
} finally {
dispose();
}
dispose is returned by setup function that is returned by createLogSilencer. This step restores the logging mechanism after executing your test function.
About me:
Hey, my name is Ramu Narasinga. I study large open-source projects and create content about their codebase architecture and best practices, sharing it through articles, videos.
I am open to work on an interesting project. Send me an email at ramu.narasinga@gmail.com
My Github - https://github.com/ramu-narasinga
My website - https://ramunarasinga.com
My Youtube channel - https://www.youtube.com/@thinkthroo
Learning platform - https://thinkthroo.com
Codebase Architecture - https://app.thinkthroo.com/architecture
Best practices - https://app.thinkthroo.com/best-practices
Production-grade projects - https://app.thinkthroo.com/production-grade-projects
Top comments (0)