doc: align Buffer.concat documentation with behavior

gurgunday · ChALkeR · aduh95 · commit 283ab61ed2e4 · 2026-02-04T15:32:44.000+01:00
Co-authored-by: Сковорода Никита Андреевич <chalkerx@gmail.com> PR-URL: #60405 Reviewed-By: Сковорода Никита Андреевич <chalkerx@gmail.com> Reviewed-By: Ulises Gascón <ulisesgascongonzalez@gmail.com>
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
@@ -1054,7 +1054,7 @@ If the list has no items, or if the `totalLength` is 0, then a new zero-length
 If `totalLength` is not provided, it is calculated from the `Buffer` instances
 in `list` by adding their lengths.
 
-If `totalLength` is provided, it is coerced to an unsigned integer. If the
+If `totalLength` is provided, it must be an unsigned integer. If the
 combined length of the `Buffer`s in `list` exceeds `totalLength`, the result is
 truncated to `totalLength`. If the combined length of the `Buffer`s in `list` is
 less than `totalLength`, the remaining space is filled with zeros.
diff --git a/test/parallel/test-buffer-concat.js b/test/parallel/test-buffer-concat.js
@@ -72,6 +72,22 @@ assert.throws(() => {
            'or Uint8Array. Received type number (3)'
 });
 
+assert.throws(() => {
+  Buffer.concat([Buffer.from('hello')], 3.5);
+}, {
+  code: 'ERR_OUT_OF_RANGE',
+  message: 'The value of "length" is out of range. It must be an integer. ' +
+           'Received 3.5'
+});
+
+assert.throws(() => {
+  Buffer.concat([Buffer.from('hello')], -2);
+}, {
+  code: 'ERR_OUT_OF_RANGE',
+  message: 'The value of "length" is out of range. It must be >= 0 && <= 9007199254740991. ' +
+           'Received -2'
+});
+
 // eslint-disable-next-line node-core/crypto-check
 const random10 = common.hasCrypto ?
   require('crypto').randomBytes(10) :
