diff --git a/doc/api/util.md b/doc/api/util.md index 8f9e6ef020a07d..a2d3c71bb633a8 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -250,6 +250,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.inherits(constructor, superConstructor)