doc: update isUtf8 description

PR-URL: #45973 Reviewed-By: Tobias Nießen <[email protected]> Reviewed-By: Michaël Zasso <[email protected]>
nodejs · Jan 2, 2023 · 3162984 · 3162984
1 parent 5966635
commit 3162984
Showing 1 changed file with 5 additions and 2 deletions.
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`