doc: update isUtf8 description

anonrig · RafaelGSS · commit e113d169ee81 · 2023-01-05T13:11:43.000-03:00
PR-URL: #45973 Reviewed-By: Tobias Nießen <tniessen@tnie.de> Reviewed-By: Michaël Zasso <targos@protonmail.com>
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
@@ -5137,9 +5137,12 @@ added: REPLACEME
 -->
 
 * input {Buffer | ArrayBuffer | TypedArray} The input to validate.
-* Returns: {boolean} Returns `true` if and only if the input is valid UTF-8.
+* Returns: {boolean}
+
+This function returns `true` if `input` contains only valid UTF-8-encoded data,
+including the case in which `input` is empty.
 
-This function is used to check if input contains UTF-8 code points (characters).
+Throws if the `input` is a detached array buffer.
 
 ### `buffer.INSPECT_MAX_BYTES`
 
