diff --git a/doc/api/util.md b/doc/api/util.md index 77940425e1d226..c113561162d117 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -225,6 +225,11 @@ without any formatting. util.format('%% %s'); // '%% %s' ``` +Please note that `util.format()` is a synchronous method that is mainly +intended as a debugging tool. Some input values can have a significant +performance overhead that can block the event loop. Use this function +with care and never in a hot code path. + ## util.getSystemErrorName(err)