doc: clearify that http does chunked encoding itself

Co-authored-by: Antoine du Hamel <[email protected]> PR-URL: #28379 Reviewed-By: Matteo Collina <[email protected]> Reviewed-By: Antoine du Hamel <[email protected]> Reviewed-By: Anna Henningsen <[email protected]>
nodejs · Sep 4, 2021 · 0c2b5a0 · 0c2b5a0
1 parent f13a302
commit 0c2b5a0
Showing 1 changed file with 5 additions and 5 deletions.
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -1002,11 +1002,11 @@ added: v0.1.29
 * `callback` {Function}
 * Returns: {boolean}
 
-Sends a chunk of the body. By calling this method
-many times, a request body can be sent to a
-server. In that case, it is suggested to use the
-`['Transfer-Encoding', 'chunked']` header line when
-creating the request.
+Sends a chunk of the body. This method can be called multiple times. If no
+`Content-Length` is set, data will automatically be encoded in HTTP Chunked
+transfer encoding, so that server knows when the data ends. The
+`Transfer-Encoding: chunked` header is added. Calling [`request.end()`][]
+is necessary to finish sending the request.
 
 The `encoding` argument is optional and only applies when `chunk` is a string.
 Defaults to `'utf8'`.